From b6529d5c0c0ac5cd7c5d766a1624be1052240958 Mon Sep 17 00:00:00 2001
From: Polo <nelsonprox92@gmail.com>
Date: Wed, 25 Feb 2026 11:13:58 +0200
Subject: [PATCH 1/2] Added status and dataset versioning

---
 docs/PHASE7_IMPLEMENTATION.md                | 241 -----------
 src/content/status.mdx                       |  98 +++++
 src/content/tutorials/dataset-versioning.mdx | 425 +++++++++++++++++++
 3 files changed, 523 insertions(+), 241 deletions(-)
 delete mode 100644 docs/PHASE7_IMPLEMENTATION.md
 create mode 100644 src/content/status.mdx
 create mode 100644 src/content/tutorials/dataset-versioning.mdx

diff --git a/docs/PHASE7_IMPLEMENTATION.md b/docs/PHASE7_IMPLEMENTATION.md
deleted file mode 100644
index 7a4b095..0000000
--- a/docs/PHASE7_IMPLEMENTATION.md
+++ /dev/null
@@ -1,241 +0,0 @@
-# Phase 7 Implementation Summary
-
-## Overview
-
-Phase 7 (SEO & Performance) has been successfully implemented, bringing the documentation site to ~95% completion. This phase focused on optimizing the site for search engines, improving performance, and ensuring accessibility compliance.
-
-## What Was Implemented
-
-### 7.1 SEO Optimization ✅
-
-#### Meta Tags & Metadata
-- **Created**: `src/lib/metadata.ts` - Centralized metadata generation utility
-- **Enhanced**: Dynamic metadata for all documentation pages
-- **Added**: OpenGraph and Twitter Card metadata
-- **Implemented**: Canonical URLs and proper meta descriptions
-- **Keywords**: Comprehensive keyword strategy for better discoverability
-
-#### Sitemap Generation
-- **Created**: `src/app/sitemap.ts` - Dynamic sitemap generation
-- **Features**:
-  - Automatically includes all documentation pages
-  - Supports version-specific URLs
-  - Proper priority and change frequency settings
-  - Extracts URLs from navigation config
-
-#### Robots.txt
-- **Created**: `src/app/robots.ts` - Search engine directives
-- **Configuration**:
-  - Allows all pages except `/api/` and `/admin/`
-  - Points to sitemap location
-  - Optimized for search engine crawling
-
-#### Structured Data (JSON-LD)
-- **Created**: `src/components/StructuredData.tsx`
-- **Implemented**:
-  - WebSite schema for the entire site
-  - TechArticle schema for documentation pages
-  - Organization schema for branding
-  - SearchAction for search functionality
-
-#### Web App Manifest
-- **Created**: `src/app/manifest.ts`
-- **Features**: PWA-ready configuration with icons and theme colors
-
-### 7.2 Performance Optimization ✅
-
-#### Next.js Configuration
-- **Enhanced**: `next.config.ts` with performance optimizations
-- **Added**:
-  - React Strict Mode for better development experience
-  - Console removal in production (except errors/warnings)
-  - Image optimization with AVIF and WebP support
-  - Package import optimization for lucide-react and radix-ui
-  - Security headers (X-Frame-Options, CSP, etc.)
-  - Aggressive caching for static assets and fonts
-
-#### Static Generation
-- **Enhanced**: `src/app/docs/[...slug]/page.tsx`
-- **Implemented**: `generateStaticParams` for all major documentation routes
-- **Result**: All docs pages are pre-rendered at build time
-
-#### Font Optimization
-- **Updated**: Font loading strategy with `display: swap`
-- **Added**: Font preloading for better performance
-- **Result**: Reduced layout shift and faster text rendering
-
-#### Build Scripts
-- **Added**: Performance testing scripts in `package.json`
-  - `npm run analyze` - Bundle size analysis
-  - `npm run lighthouse` - Lighthouse CI audits
-  - `npm run perf` - Combined build and performance test
-
-#### Lighthouse Configuration
-- **Created**: `.lighthouserc.json`
-- **Targets**:
-  - Performance: 90+
-  - Accessibility: 95+
-  - Best Practices: 90+
-  - SEO: 95+
-
-### 7.3 Accessibility ✅
-
-#### Skip to Content
-- **Created**: `src/components/SkipToContent.tsx`
-- **Features**: Keyboard-accessible skip link (visible on focus)
-- **Integrated**: Added to root layout
-
-#### Semantic HTML & ARIA
-- **Enhanced**: `src/components/layout/DocsLayout.tsx`
-  - Added proper `<main>` with `id="main-content"`
-  - Added `<aside>` elements with descriptive labels
-  - Added `role` and `aria-label` attributes
-
-- **Enhanced**: `src/components/layout/SiteHeader.tsx`
-  - Added `role="banner"` to header
-  - Added `aria-label` to navigation
-  - Added `role="dialog"` to search modal
-  - Improved button labels
-
-- **Enhanced**: `src/components/ThemeToggle.tsx`
-  - Added `aria-pressed` state
-  - Added descriptive `aria-label`
-  - Added screen reader text
-  - Added `aria-hidden` to decorative icons
-  - Fixed hydration issues
-
-#### Keyboard Navigation
-- All interactive elements are keyboard accessible
-- Proper focus management in modals
-- Skip links for efficient navigation
-- Escape key closes modals
-
-#### Documentation
-- **Created**: `docs/ACCESSIBILITY.md` - Complete accessibility guide
-- **Created**: `docs/PERFORMANCE.md` - Performance optimization guide
-
-## Files Created
-
-1. `src/lib/metadata.ts` - Metadata generation utilities
-2. `src/lib/utils.ts` - Utility functions including contrast checking
-3. `src/app/sitemap.ts` - Dynamic sitemap generation
-4. `src/app/robots.ts` - Robots.txt configuration
-5. `src/app/manifest.ts` - Web app manifest
-6. `src/components/StructuredData.tsx` - JSON-LD structured data
-7. `src/components/SkipToContent.tsx` - Skip to content link
-8. `.lighthouserc.json` - Lighthouse CI configuration
-9. `docs/ACCESSIBILITY.md` - Accessibility documentation
-10. `docs/PERFORMANCE.md` - Performance documentation
-11. `docs/PHASE7_IMPLEMENTATION.md` - This file
-
-## Files Modified
-
-1. `src/app/layout.tsx` - Added metadata, structured data, skip link
-2. `src/app/docs/[...slug]/page.tsx` - Added metadata generation and static params
-3. `src/components/layout/DocsLayout.tsx` - Added semantic HTML and ARIA
-4. `src/components/layout/SiteHeader.tsx` - Added ARIA labels and roles
-5. `src/components/ThemeToggle.tsx` - Enhanced accessibility
-6. `next.config.ts` - Added performance optimizations
-7. `package.json` - Added performance testing scripts
-8. `docs/TASKS.md` - Updated progress tracking
-
-## Testing Recommendations
-
-### SEO Testing
-```bash
-# Check sitemap
-curl http://localhost:3000/sitemap.xml
-
-# Check robots.txt
-curl http://localhost:3000/robots.txt
-
-# Validate structured data
-# Use Google's Rich Results Test
-```
-
-### Performance Testing
-```bash
-# Run Lighthouse audit
-npm run lighthouse
-
-# Analyze bundle size
-npm run analyze
-
-# Build and check output
-npm run build
-```
-
-### Accessibility Testing
-```bash
-# Run automated checks
-npm run lint
-
-# Manual testing checklist:
-# - Tab through all interactive elements
-# - Test with screen reader (NVDA, JAWS, VoiceOver)
-# - Verify skip link appears on Tab
-# - Test keyboard shortcuts (Cmd/Ctrl+K)
-# - Check color contrast in both themes
-```
-
-## Performance Targets
-
-Based on Lighthouse CI configuration:
-
-- **Performance**: 90+ (optimized static generation, caching, fonts)
-- **Accessibility**: 95+ (ARIA labels, keyboard nav, semantic HTML)
-- **Best Practices**: 90+ (security headers, HTTPS, no console errors)
-- **SEO**: 95+ (meta tags, sitemap, structured data, mobile-friendly)
-
-## Next Steps
-
-With Phase 7 complete, the recommended next steps are:
-
-1. **Phase 8: Testing**
-   - Set up E2E tests with Playwright
-   - Verify all links work
-   - Test responsive layouts
-   - Validate code examples
-
-2. **Phase 9: Deployment**
-   - Connect to Vercel
-   - Configure environment variables
-   - Set up custom domain
-   - Enable analytics
-
-3. **Phase 10: Maintenance**
-   - Create content update workflow
-   - Set up monitoring
-   - Track performance metrics
-   - Plan for community contributions
-
-## Impact
-
-Phase 7 implementation provides:
-
-- **Better Search Rankings**: Comprehensive SEO optimization
-- **Faster Load Times**: Static generation and caching
-- **Improved UX**: Accessibility features for all users
-- **Production Ready**: Performance monitoring and optimization
-- **Future Proof**: PWA-ready with manifest
-
-## Known Issues / TODO
-
-### Icons
-The PWA manifest references icon files that need to be created:
-- `public/icon-192.png` (192x192px)
-- `public/icon-512.png` (512x512px)
-
-See `docs/ICONS_TODO.md` for detailed specifications and design guidelines. Icons are currently commented out in the manifest to prevent 404 errors.
-
-### Optional Enhancements
-- Add favicon.ico for browser tab icon
-- Add apple-touch-icon.png for iOS home screen
-- Consider adding more icon sizes for different devices
-
-## Resources
-
-- [Next.js Metadata Documentation](https://nextjs.org/docs/app/building-your-application/optimizing/metadata)
-- [WCAG 2.1 Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
-- [Lighthouse Documentation](https://developers.google.com/web/tools/lighthouse)
-- [Schema.org Documentation](https://schema.org/)
diff --git a/src/content/status.mdx b/src/content/status.mdx
new file mode 100644
index 0000000..ceecac9
--- /dev/null
+++ b/src/content/status.mdx
@@ -0,0 +1,98 @@
+---
+title: "Service Status"
+description: "Real-time status of Xether AI services and API endpoints"
+---
+
+import { ServiceStatus } from "@/components/ui/ServiceStatus";
+
+# Service Status
+
+This page shows the current status of all Xether AI services, including API endpoints, pipeline execution, data storage, and authentication systems.
+
+<ServiceStatus />
+
+## What the Status Means
+
+<Table>
+  <TableHeader>
+    <TableRow>
+      <TableHead>Status</TableHead>
+      <TableHead>Description</TableHead>
+    </TableRow>
+  </TableHeader>
+  <TableBody>
+    <TableRow>
+      <TableCell className="font-medium">✅ Operational</TableCell>
+      <TableCell>The service is functioning normally and all features are available.</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">⚠️ Degraded Performance</TableCell>
+      <TableCell>The service is operational but experiencing some issues or reduced performance.</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">❌ Service Outage</TableCell>
+      <TableCell>The service is currently unavailable or experiencing major issues.</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">🔧 Under Maintenance</TableCell>
+      <TableCell>The service is temporarily unavailable for scheduled maintenance.</TableCell>
+    </TableRow>
+  </TableBody>
+</Table>
+
+## Incident Response
+
+When incidents occur:
+
+1. **Detection** - Automated monitoring detects issues within seconds
+2. **Assessment** - Engineering team investigates impact and root cause
+3. **Communication** - Status page updated with incident details
+4. **Resolution** - Team works to restore service as quickly as possible
+5. **Post-mortem** - Analysis conducted to prevent future incidents
+
+## Historical Data
+
+For historical uptime data and detailed incident reports, visit our [status archive](https://status.xether.ai/history).
+
+## API Status Endpoints
+
+If you need to programmatically check service status, use our status API:
+
+```bash
+curl https://api.xether.ai/v1/status
+```
+
+Response format:
+```json
+{
+  "status": "operational",
+  "services": [
+    {
+      "name": "API",
+      "status": "operational",
+      "description": "All API endpoints are responding normally",
+      "lastUpdated": "2024-02-25T10:00:00Z"
+    }
+  ],
+  "incident": null
+}
+```
+
+## Get Notified
+
+Subscribe to status updates:
+
+- **Email**: Subscribe at [status.xether.ai](https://status.xether.ai)
+- **RSS Feed**: [status.xether.ai/rss](https://status.xether.ai/rss)
+- **Webhooks**: Configure webhook notifications in your dashboard
+
+## SLA Commitment
+
+We commit to:
+
+- **99.9% Uptime** for core API services
+- **Sub-minute response** to critical incidents
+- **Transparent communication** during service issues
+- **Post-incident analysis** within 48 hours
+
+For service-related questions or to report issues, contact our support team at [support@xether.ai](mailto:support@xether.ai).
diff --git a/src/content/tutorials/dataset-versioning.mdx b/src/content/tutorials/dataset-versioning.mdx
new file mode 100644
index 0000000..68c065b
--- /dev/null
+++ b/src/content/tutorials/dataset-versioning.mdx
@@ -0,0 +1,425 @@
+---
+title: "Dataset Versioning Tutorial"
+description: "Learn how to use Xether AI's dataset versioning system for reproducible data workflows"
+---
+
+import { Callout } from "@/components/ui/Callout";
+import { CodeBlock } from "@/components/ui/CodeBlock";
+
+# Dataset Versioning Tutorial
+
+Dataset versioning is one of Xether AI's core features, enabling you to create immutable snapshots of your data at any point in time. This tutorial will teach you how to leverage versioning for reproducible workflows, data lineage, and collaboration.
+
+## Prerequisites
+
+- Basic understanding of Xether AI pipelines
+- Familiarity with YAML configuration
+- Access to Xether AI platform
+
+## What You'll Learn
+
+- How dataset versions are created automatically
+- Manual version creation and tagging
+- Comparing different dataset versions
+- Rolling back to previous versions
+- Best practices for version management
+
+## Understanding Dataset Versions
+
+Every time a pipeline runs successfully, Xether AI automatically creates a new version of the output dataset. Each version is:
+
+- **Immutable** - Once created, it never changes
+- **Addressable** - Reference by ID or semantic tags
+- **Comparable** - Diff any two versions to see changes
+- **Traceable** - Complete lineage from source to final version
+
+<Callout type="info">
+Dataset versions are stored efficiently using content-addressed storage. Identical data blocks are deduplicated, making versioning lightweight and cost-effective.
+</Callout>
+
+## Automatic Version Creation
+
+When you run a pipeline, Xether AI automatically versions the output:
+
+```yaml
+# pipeline.yaml
+name: "customer-data-processing"
+source:
+  type: "s3"
+  bucket: "my-data-bucket"
+  path: "raw/customers/"
+stages:
+  - type: "clean"
+    config:
+      remove_nulls: true
+      normalize_emails: true
+  - type: "validate"
+    config:
+      rules_file: "validation-rules.yaml"
+```
+
+```bash
+# Run the pipeline - this creates a new version automatically
+xether pipeline run customer-data-processing
+```
+
+After execution, you'll see output like:
+
+```
+✅ Pipeline completed successfully
+📦 Dataset version created: v2024.02.25.001
+🔗 Version ID: ds_1234567890abcdef
+📊 Records processed: 1,247,892
+```
+
+## Manual Version Creation
+
+Sometimes you want to create a version without running a full pipeline:
+
+### Creating a Version from Existing Data
+
+```bash
+# Create a version from current dataset state
+xether dataset version create \
+  --dataset "customer-data" \
+  --tag "quarterly-report" \
+  --description "Q4 2023 customer data for annual report"
+```
+
+### Tagging Existing Versions
+
+```bash
+# Add a semantic tag to an existing version
+xether dataset version tag \
+  --dataset "customer-data" \
+  --version "ds_1234567890abcdef" \
+  --tag "v1.2.0" \
+  --description "Stable version for production"
+```
+
+## Working with Versions
+
+### Listing Versions
+
+```bash
+# List all versions of a dataset
+xether dataset list --name "customer-data"
+
+# Show detailed version information
+xether dataset info --version "ds_1234567890abcdef"
+```
+
+Output:
+```
+Dataset: customer-data
+Versions:
+├── v1.0.0 (ds_1234567890abcdef) - 2024-01-15 10:30:00
+├── v1.1.0 (ds_1234567890abc123) - 2024-01-22 14:45:00
+├── v1.2.0 (ds_1234567890abc456) - 2024-02-05 09:15:00
+└── v1.3.0 (ds_1234567890abc789) - 2024-02-25 16:20:00 [LATEST]
+
+Version v1.3.0 (ds_1234567890abc789):
+├── Created: 2024-02-25 16:20:00 UTC
+├── Size: 2.4 GB
+├── Records: 1,247,892
+├── Pipeline: customer-data-processing (run #42)
+├── Tags: latest, production, quarterly-report
+└── Parent: ds_1234567890abc456
+```
+
+### Comparing Versions
+
+Xether AI provides powerful diff capabilities to compare versions:
+
+```bash
+# Compare two versions
+xether dataset diff \
+  --dataset "customer-data" \
+  --from "v1.2.0" \
+  --to "v1.3.0"
+
+# Get detailed schema changes
+xether dataset diff \
+  --dataset "customer-data" \
+  --from "v1.2.0" \
+  --to "v1.3.0" \
+  --schema-only
+```
+
+Diff output:
+```
+📊 Dataset Comparison: customer-data
+From: v1.2.0 (ds_1234567890abc456)
+To:   v1.3.0 (ds_1234567890abc789)
+
+📈 Summary:
+├── Records added: 15,234
+├── Records removed: 8,901
+├── Records modified: 23,456
+└── Net change: +6,333 records
+
+🏗️ Schema Changes:
+├── New field: email_verified (boolean)
+├── Modified field: phone_number (string → formatted_string)
+└── Removed field: legacy_id (integer)
+
+📋 Data Quality:
+├── Completeness: 98.5% → 99.2%
+├── Validity: 97.8% → 98.9%
+└── Consistency: 96.2% → 97.5%
+```
+
+### Rolling Back Versions
+
+If you need to revert to a previous version:
+
+```bash
+# Roll back to a specific version
+xether dataset rollback \
+  --dataset "customer-data" \
+  --version "v1.2.0" \
+  --reason "Data quality issue detected in v1.3.0"
+
+# Create a new branch from an old version
+xether dataset branch \
+  --dataset "customer-data" \
+  --from "v1.2.0" \
+  --name "hotfix/data-quality"
+```
+
+## Versioning in Pipelines
+
+### Referencing Specific Versions
+
+In your pipeline configurations, you can reference specific dataset versions:
+
+```yaml
+# production-pipeline.yaml
+name: "ml-model-training"
+source:
+  type: "dataset"
+  name: "customer-data"
+  version: "v1.2.0"  # Use specific stable version
+stages:
+  - type: "transform"
+    config:
+      model_type: "customer_churn"
+  - type: "augment"
+    config:
+      add_features: ["customer_lifetime", "purchase_patterns"]
+```
+
+### Using Dynamic Version References
+
+```yaml
+# staging-pipeline.yaml
+name: "staging-validation"
+source:
+  type: "dataset"
+  name: "customer-data"
+  version: "latest"  # Always use the latest version
+stages:
+  - type: "validate"
+    config:
+      strict_mode: true
+```
+
+```yaml
+# experimental-pipeline.yaml
+name: "experimental-feature"
+source:
+  type: "dataset"
+  name: "customer-data"
+  version: "production"  # Use version tagged as "production"
+stages:
+  - type: "transform"
+    config:
+      experimental_feature: true
+```
+
+## Best Practices
+
+### Semantic Versioning
+
+Use semantic versioning for your dataset versions:
+
+<Table>
+  <TableHeader>
+    <TableRow>
+      <TableHead>Version Pattern</TableHead>
+      <TableHead>When to Use</TableHead>
+      <TableHead>Example</TableHead>
+    </TableRow>
+  </TableHeader>
+  <TableBody>
+    <TableRow>
+      <TableCell className="font-medium">v1.0.0</TableCell>
+      <TableCell>Initial stable release</TableCell>
+      <TableCell>First production-ready dataset</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">v1.1.0</TableCell>
+      <TableCell>Feature additions</TableCell>
+      <TableCell>Added new customer fields</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">v1.1.1</TableCell>
+      <TableCell>Bug fixes</TableCell>
+      <TableCell>Fixed data quality issues</TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">v2.0.0</TableCell>
+      <TableCell>Breaking changes</TableCell>
+      <TableCell>Restructured customer schema</TableCell>
+    </TableRow>
+  </TableBody>
+</Table>
+
+### Tagging Strategy
+
+Establish a consistent tagging strategy:
+
+```bash
+# Environment tags
+xether dataset version tag --tag "production"
+xether dataset version tag --tag "staging"
+xether dataset version tag --tag "development"
+
+# Purpose tags
+xether dataset version tag --tag "quarterly-report"
+xether dataset version tag --tag "ml-training"
+xether dataset version tag --tag "compliance-audit"
+
+# Quality tags
+xether dataset version tag --tag "validated"
+xether dataset version tag --tag "certified"
+```
+
+### Version Retention
+
+Configure automatic cleanup of old versions:
+
+```yaml
+# dataset-config.yaml
+retention:
+  policy: "smart"
+  rules:
+    - type: "keep_latest"
+      count: 10
+    - type: "keep_tagged"
+      tags: ["production", "quarterly-report"]
+    - type: "keep_after"
+      days: 90
+    - type: "keep_before"
+      date: "2024-01-01"
+```
+
+## Advanced Features
+
+### Version Branching
+
+Create experimental branches without affecting main lineage:
+
+```bash
+# Create a new branch
+xether dataset branch \
+  --dataset "customer-data" \
+  --from "v1.2.0" \
+  --name "experiment/new-features"
+
+# Work with the branch
+xether pipeline run experimental-pipeline \
+  --dataset "customer-data" \
+  --branch "experiment/new-features"
+
+# Merge branch back to main
+xether dataset merge \
+  --dataset "customer-data" \
+  --from "experiment/new-features" \
+  --to "main" \
+  --message "Add new customer segmentation features"
+```
+
+### Version Annotations
+
+Add rich metadata to versions:
+
+```bash
+xether dataset version annotate \
+  --version "ds_1234567890abcdef" \
+  --key "data_quality_score" \
+  --value "98.5"
+
+xether dataset version annotate \
+  --version "ds_1234567890abcdef" \
+  --key "compliance_status" \
+  --value "gdpr_compliant"
+
+xether dataset version annotate \
+  --version "ds_1234567890abcdef" \
+  --key "business_context" \
+  --value "q4_2023_reporting"
+```
+
+## Monitoring and Alerts
+
+Set up version monitoring:
+
+```yaml
+# monitoring.yaml
+alerts:
+  - name: "data_volume_anomaly"
+    condition: "version_size_change > 50%"
+    action: "notify_team"
+  
+  - name: "quality_degradation"
+    condition: "quality_score < 95%"
+    action: "rollback_to_last_good"
+    
+  - name: "schema_drift"
+    condition: "schema_changes > 5"
+    action: "require_manual_review"
+```
+
+## Troubleshooting
+
+### Common Issues
+
+<Callout type="warning">
+**Issue**: Version not found
+**Solution**: Check version spelling and use `xether dataset list` to see available versions
+</Callout>
+
+<Callout type="warning">
+**Issue**: Rollback failed
+**Solution**: Ensure no active pipelines are using the dataset, then retry rollback
+</Callout>
+
+<Callout type="warning">
+**Issue**: Diff shows no changes
+**Solution**: Versions might be identical. Check version metadata for differences
+</Callout>
+
+### Performance Tips
+
+1. **Use selective diffing** with `--field-filter` for large datasets
+2. **Cache version metadata** to reduce API calls
+3. **Use version ranges** in pipeline configs for flexibility
+4. **Set up retention policies** to manage storage costs
+
+## Next Steps
+
+Now that you understand dataset versioning:
+
+- Try the [Pipeline Monitoring Guide](/docs/tutorials/pipeline-monitoring)
+- Learn about [Advanced Pipeline Patterns](/docs/tutorials/advanced-pipelines)
+- Explore [Data Quality Best Practices](/docs/tutorials/data-quality)
+
+## Resources
+
+- [API Reference: Datasets](/docs/api-reference/datasets)
+- [CLI Reference: Dataset Commands](/docs/cli/dataset)
+- [Best Practices: Data Governance](/docs/best-practices/data-governance)
+- [Community Forum](https://community.xether.ai)
+
+For questions about dataset versioning, visit our [support center](https://support.xether.ai) or contact us at [support@xether.ai](mailto:support@xether.ai).

From b194ab2779da5a29ec828215eaa44c74e34baeea Mon Sep 17 00:00:00 2001
From: Polo <nelsonprox92@gmail.com>
Date: Wed, 25 Feb 2026 11:14:22 +0200
Subject: [PATCH 2/2] Added SDK versioning

---
 src/components/ui/SDKVersions.tsx   | 296 ++++++++++++++++++++++++++++
 src/components/ui/ServiceStatus.tsx | 236 ++++++++++++++++++++++
 src/content/sdk-versions.mdx        | 153 ++++++++++++++
 3 files changed, 685 insertions(+)
 create mode 100644 src/components/ui/SDKVersions.tsx
 create mode 100644 src/components/ui/ServiceStatus.tsx
 create mode 100644 src/content/sdk-versions.mdx

diff --git a/src/components/ui/SDKVersions.tsx b/src/components/ui/SDKVersions.tsx
new file mode 100644
index 0000000..d8875c0
--- /dev/null
+++ b/src/components/ui/SDKVersions.tsx
@@ -0,0 +1,296 @@
+"use client";
+
+import React, { useState, useEffect } from "react";
+import { cn } from "@/lib/utils";
+
+interface SDKVersion {
+  name: string;
+  language: string;
+  version: string;
+  releaseDate: string;
+  downloadUrl: string;
+  documentationUrl: string;
+  changelogUrl: string;
+  isLatest: boolean;
+  isDeprecated?: boolean;
+  deprecationDate?: string;
+}
+
+interface SDKVersionsResponse {
+  sdks: SDKVersion[];
+  latest: {
+    python: string;
+    javascript: string;
+    go: string;
+    java: string;
+  };
+}
+
+export function SDKVersions() {
+  const [sdkData, setSdkData] = useState<SDKVersionsResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [selectedLanguage, setSelectedLanguage] = useState<string>("all");
+
+  useEffect(() => {
+    const fetchSDKVersions = async () => {
+      try {
+        // In a real implementation, this would fetch from your API
+        // For now, we'll use mock data that demonstrates the functionality
+        const mockData: SDKVersionsResponse = {
+          sdks: [
+            {
+              name: "Python SDK",
+              language: "python",
+              version: "2.4.1",
+              releaseDate: "2024-02-20",
+              downloadUrl: "https://pypi.org/project/xether-ai/",
+              documentationUrl: "/docs/sdk/python",
+              changelogUrl: "https://github.com/xether-ai/python-sdk/releases",
+              isLatest: true
+            },
+            {
+              name: "Python SDK",
+              language: "python",
+              version: "2.4.0",
+              releaseDate: "2024-02-10",
+              downloadUrl: "https://pypi.org/project/xether-ai/2.4.0",
+              documentationUrl: "/docs/sdk/python/v2.4.0",
+              changelogUrl: "https://github.com/xether-ai/python-sdk/releases/tag/v2.4.0",
+              isLatest: false
+            },
+            {
+              name: "JavaScript/TypeScript SDK",
+              language: "javascript",
+              version: "1.8.3",
+              releaseDate: "2024-02-18",
+              downloadUrl: "https://www.npmjs.com/package/@xether/sdk",
+              documentationUrl: "/docs/sdk/javascript",
+              changelogUrl: "https://github.com/xether-ai/js-sdk/releases",
+              isLatest: true
+            },
+            {
+              name: "JavaScript/TypeScript SDK",
+              language: "javascript",
+              version: "1.8.2",
+              releaseDate: "2024-02-05",
+              downloadUrl: "https://www.npmjs.com/package/@xether/sdk/v1.8.2",
+              documentationUrl: "/docs/sdk/javascript/v1.8.2",
+              changelogUrl: "https://github.com/xether-ai/js-sdk/releases/tag/v1.8.2",
+              isLatest: false
+            },
+            {
+              name: "Go SDK",
+              language: "go",
+              version: "1.2.0",
+              releaseDate: "2024-02-15",
+              downloadUrl: "https://github.com/xether-ai/go-sdk/releases",
+              documentationUrl: "/docs/sdk/go",
+              changelogUrl: "https://github.com/xether-ai/go-sdk/releases",
+              isLatest: true
+            },
+            {
+              name: "Java SDK",
+              language: "java",
+              version: "1.0.5",
+              releaseDate: "2024-02-12",
+              downloadUrl: "https://mvnrepository.com/artifact/ai.xether/sdk",
+              documentationUrl: "/docs/sdk/java",
+              changelogUrl: "https://github.com/xether-ai/java-sdk/releases",
+              isLatest: true
+            }
+          ],
+          latest: {
+            python: "2.4.1",
+            javascript: "1.8.3",
+            go: "1.2.0",
+            java: "1.0.5"
+          }
+        };
+
+        // Simulate API delay
+        setTimeout(() => {
+          setSdkData(mockData);
+          setLoading(false);
+        }, 800);
+      } catch {
+        setError("Failed to fetch SDK versions");
+        setLoading(false);
+      }
+    };
+
+    fetchSDKVersions();
+  }, []);
+
+  const filteredSDKs = sdkData?.sdks.filter(sdk => 
+    selectedLanguage === "all" || sdk.language === selectedLanguage
+  ) || [];
+
+  const getInstallCommand = (sdk: SDKVersion) => {
+    switch (sdk.language) {
+      case "python":
+        return `pip install xether-ai==${sdk.version}`;
+      case "javascript":
+        return `npm install @xether/sdk@${sdk.version}`;
+      case "go":
+        return `go get github.com/xether-ai/go-sdk@v${sdk.version}`;
+      case "java":
+        return `<dependency>\n  <groupId>ai.xether</groupId>\n  <artifactId>sdk</artifactId>\n  <version>${sdk.version}</version>\n</dependency>`;
+      default:
+        return "";
+    }
+  };
+
+  const getLanguageIcon = (language: string) => {
+    switch (language) {
+      case "python":
+        return "🐍";
+      case "javascript":
+        return "🟨";
+      case "go":
+        return "🐹";
+      case "java":
+        return "☕";
+      default:
+        return "📦";
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="p-4 border rounded-lg bg-muted/20">
+        <div className="flex items-center space-x-2">
+          <div className="animate-spin rounded-full h-4 w-4 border-b-2 border-primary"></div>
+          <span className="text-sm text-muted-foreground">Loading SDK versions...</span>
+        </div>
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="p-4 border rounded-lg bg-red-50 border-red-200">
+        <div className="flex items-center space-x-2">
+          <span className="text-red-600">❌</span>
+          <span className="text-sm text-red-800">{error}</span>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="text-center">
+        <h2 className="text-2xl font-bold mb-2">SDK Versions</h2>
+        <p className="text-muted-foreground">
+          Latest versions of Xether AI SDKs for all supported languages
+        </p>
+      </div>
+
+      {/* Language Filter */}
+      <div className="flex justify-center">
+        <div className="inline-flex rounded-lg border p-1 bg-muted">
+          {["all", "python", "javascript", "go", "java"].map((lang) => (
+            <button
+              key={lang}
+              onClick={() => setSelectedLanguage(lang)}
+              className={cn(
+                "px-4 py-2 rounded-md text-sm font-medium transition-colors",
+                selectedLanguage === lang
+                  ? "bg-background text-foreground shadow-sm"
+                  : "text-muted-foreground hover:text-foreground"
+              )}
+            >
+              {lang === "all" ? "All SDKs" : lang.charAt(0).toUpperCase() + lang.slice(1)}
+            </button>
+          ))}
+        </div>
+      </div>
+
+      {/* Latest Versions Summary */}
+      {selectedLanguage === "all" && sdkData && (
+        <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4">
+          {Object.entries(sdkData.latest).map(([lang, version]) => (
+            <div key={lang} className="p-4 border rounded-lg bg-background">
+              <div className="flex items-center space-x-2 mb-2">
+                <span className="text-2xl">{getLanguageIcon(lang)}</span>
+                <h3 className="font-semibold capitalize">{lang}</h3>
+              </div>
+              <p className="text-2xl font-bold text-primary mb-1">{version}</p>
+              <p className="text-sm text-muted-foreground">Latest</p>
+            </div>
+          ))}
+        </div>
+      )}
+
+      {/* Detailed SDK List */}
+      <div className="space-y-4">
+        {filteredSDKs.map((sdk) => (
+          <div key={`${sdk.language}-${sdk.version}`} className="border rounded-lg p-6 bg-background">
+            <div className="flex items-start justify-between mb-4">
+              <div className="flex items-center space-x-3">
+                <span className="text-2xl">{getLanguageIcon(sdk.language)}</span>
+                <div>
+                  <h3 className="text-lg font-semibold">{sdk.name}</h3>
+                  <div className="flex items-center space-x-2">
+                    <span className="text-xl font-bold text-primary">{sdk.version}</span>
+                    {sdk.isLatest && (
+                      <span className="px-2 py-1 text-xs font-medium bg-green-100 text-green-800 rounded-full">
+                        Latest
+                      </span>
+                    )}
+                  </div>
+                </div>
+              </div>
+              <div className="text-sm text-muted-foreground">
+                Released: {new Date(sdk.releaseDate).toLocaleDateString()}
+              </div>
+            </div>
+
+            {/* Installation Command */}
+            <div className="mb-4">
+              <h4 className="font-medium mb-2">Installation</h4>
+              <div className="bg-muted p-3 rounded-md">
+                <code className="text-sm">{getInstallCommand(sdk)}</code>
+              </div>
+            </div>
+
+            {/* Links */}
+            <div className="flex flex-wrap gap-3">
+              <a
+                href={sdk.documentationUrl}
+                className="inline-flex items-center px-3 py-1 text-sm font-medium text-primary border border-primary rounded-md hover:bg-primary hover:text-primary-foreground transition-colors"
+              >
+                📚 Documentation
+              </a>
+              <a
+                href={sdk.downloadUrl}
+                className="inline-flex items-center px-3 py-1 text-sm font-medium border border-border rounded-md hover:bg-muted transition-colors"
+              >
+                📥 Download
+              </a>
+              <a
+                href={sdk.changelogUrl}
+                className="inline-flex items-center px-3 py-1 text-sm font-medium border border-border rounded-md hover:bg-muted transition-colors"
+              >
+                📋 Changelog
+              </a>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Footer */}
+      <div className="text-center text-sm text-muted-foreground">
+        <p>
+          Looking for older versions? Check our{" "}
+          <a href="https://github.com/xether-ai" className="text-primary hover:underline">
+            GitHub repositories
+          </a>{" "}
+          for complete version history.
+        </p>
+      </div>
+    </div>
+  );
+}
diff --git a/src/components/ui/ServiceStatus.tsx b/src/components/ui/ServiceStatus.tsx
new file mode 100644
index 0000000..7280a26
--- /dev/null
+++ b/src/components/ui/ServiceStatus.tsx
@@ -0,0 +1,236 @@
+"use client";
+
+import React, { useState, useEffect } from "react";
+import { cn } from "@/lib/utils";
+
+interface ServiceStatus {
+  name: string;
+  status: "operational" | "degraded" | "down" | "maintenance";
+  description?: string;
+  lastUpdated?: string;
+}
+
+interface ServiceStatusResponse {
+  status: "operational" | "degraded" | "down";
+  services: ServiceStatus[];
+  incident?: {
+    title: string;
+    description: string;
+    started: string;
+  };
+}
+
+export function ServiceStatus() {
+  const [statusData, setStatusData] = useState<ServiceStatusResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    const fetchServiceStatus = async () => {
+      try {
+        // In a real implementation, this would fetch from your status API
+        // For now, we'll use mock data that demonstrates the functionality
+        const mockData: ServiceStatusResponse = {
+          status: "operational",
+          services: [
+            {
+              name: "API",
+              status: "operational",
+              description: "All API endpoints are responding normally",
+              lastUpdated: new Date().toISOString()
+            },
+            {
+              name: "Pipeline Execution",
+              status: "operational",
+              description: "Pipeline processing is running normally",
+              lastUpdated: new Date().toISOString()
+            },
+            {
+              name: "Data Storage",
+              status: "operational",
+              description: "All storage systems are operational",
+              lastUpdated: new Date().toISOString()
+            },
+            {
+              name: "Authentication",
+              status: "operational",
+              description: "Authentication services are working normally",
+              lastUpdated: new Date().toISOString()
+            }
+          ]
+        };
+
+        // Simulate API delay
+        setTimeout(() => {
+          setStatusData(mockData);
+          setLoading(false);
+        }, 1000);
+      } catch (err) {
+        setError("Failed to fetch service status");
+        setLoading(false);
+      }
+    };
+
+    fetchServiceStatus();
+    
+    // Refresh status every 5 minutes
+    const interval = setInterval(fetchServiceStatus, 5 * 60 * 1000);
+    return () => clearInterval(interval);
+  }, []);
+
+  const getStatusColor = (status: ServiceStatus["status"]) => {
+    switch (status) {
+      case "operational":
+        return "text-green-600 bg-green-50 border-green-200";
+      case "degraded":
+        return "text-yellow-600 bg-yellow-50 border-yellow-200";
+      case "down":
+        return "text-red-600 bg-red-50 border-red-200";
+      case "maintenance":
+        return "text-blue-600 bg-blue-50 border-blue-200";
+      default:
+        return "text-gray-600 bg-gray-50 border-gray-200";
+    }
+  };
+
+  const getStatusIcon = (status: ServiceStatus["status"]) => {
+    switch (status) {
+      case "operational":
+        return "✅";
+      case "degraded":
+        return "⚠️";
+      case "down":
+        return "❌";
+      case "maintenance":
+        return "🔧";
+      default:
+        return "❓";
+    }
+  };
+
+  const getOverallStatus = () => {
+    if (!statusData) return { text: "Loading", color: "text-gray-600" };
+    
+    switch (statusData.status) {
+      case "operational":
+        return { text: "All Systems Operational", color: "text-green-600" };
+      case "degraded":
+        return { text: "Some Issues Detected", color: "text-yellow-600" };
+      case "down":
+        return { text: "Service Outage", color: "text-red-600" };
+      default:
+        return { text: "Status Unknown", color: "text-gray-600" };
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="p-4 border rounded-lg bg-muted/20">
+        <div className="flex items-center space-x-2">
+          <div className="animate-spin rounded-full h-4 w-4 border-b-2 border-primary"></div>
+          <span className="text-sm text-muted-foreground">Loading service status...</span>
+        </div>
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="p-4 border rounded-lg bg-red-50 border-red-200">
+        <div className="flex items-center space-x-2">
+          <span className="text-red-600">❌</span>
+          <span className="text-sm text-red-800">{error}</span>
+        </div>
+      </div>
+    );
+  }
+
+  const overallStatus = getOverallStatus();
+
+  return (
+    <div className="space-y-4">
+      {/* Overall Status */}
+      <div className="p-4 border rounded-lg bg-background">
+        <div className="flex items-center justify-between">
+          <div>
+            <h3 className="text-lg font-semibold">Service Status</h3>
+            <p className={`text-sm ${overallStatus.color}`}>
+              {overallStatus.text}
+            </p>
+          </div>
+          <div className="text-xs text-muted-foreground">
+            Last updated: {new Date().toLocaleString()}
+          </div>
+        </div>
+      </div>
+
+      {/* Individual Services */}
+      <div className="grid gap-3">
+        {statusData?.services.map((service) => (
+          <div
+            key={service.name}
+            className={cn(
+              "p-3 border rounded-lg",
+              getStatusColor(service.status)
+            )}
+          >
+            <div className="flex items-start justify-between">
+              <div className="flex-1">
+                <div className="flex items-center space-x-2">
+                  <span className="text-lg">{getStatusIcon(service.status)}</span>
+                  <h4 className="font-medium">{service.name}</h4>
+                </div>
+                {service.description && (
+                  <p className="text-sm mt-1 opacity-80">
+                    {service.description}
+                  </p>
+                )}
+              </div>
+              <div className="text-xs opacity-60">
+                {service.lastUpdated && 
+                  new Date(service.lastUpdated).toLocaleTimeString()
+                }
+              </div>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Incident Banner */}
+      {statusData?.incident && (
+        <div className="p-4 border rounded-lg bg-yellow-50 border-yellow-200">
+          <div className="flex items-start space-x-3">
+            <span className="text-lg">⚠️</span>
+            <div className="flex-1">
+              <h4 className="font-medium text-yellow-800">
+                {statusData.incident.title}
+              </h4>
+              <p className="text-sm text-yellow-700 mt-1">
+                {statusData.incident.description}
+              </p>
+              <p className="text-xs text-yellow-600 mt-2">
+                Started: {new Date(statusData.incident.started).toLocaleString()}
+              </p>
+            </div>
+          </div>
+        </div>
+      )}
+
+      {/* Footer */}
+      <div className="text-center text-xs text-muted-foreground">
+        <p>
+          Status updates automatically every 5 minutes. 
+          View detailed status at{" "}
+          <a 
+            href="https://status.xether.ai" 
+            className="text-primary hover:underline"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            status.xether.ai
+          </a>
+        </p>
+      </div>
+    </div>
+  );
+}
diff --git a/src/content/sdk-versions.mdx b/src/content/sdk-versions.mdx
new file mode 100644
index 0000000..05e01b3
--- /dev/null
+++ b/src/content/sdk-versions.mdx
@@ -0,0 +1,153 @@
+---
+title: "SDK Versions"
+description: "Latest versions and download links for Xether AI SDKs"
+---
+
+import { SDKVersions } from "@/components/ui/SDKVersions";
+
+# SDK Versions
+
+<SDKVersions />
+
+## Supported Languages
+
+Xether AI provides official SDKs for the most popular programming languages, making it easy to integrate our platform into your existing workflows.
+
+<Table>
+  <TableHeader>
+    <TableRow>
+      <TableHead>Language</TableHead>
+      <TableHead>Package Manager</TableHead>
+      <TableHead>Package Name</TableHead>
+      <TableHead>Status</TableHead>
+    </TableRow>
+  </TableHeader>
+  <TableBody>
+    <TableRow>
+      <TableCell className="font-medium">Python</TableCell>
+      <TableCell className="font-mono">pip</TableCell>
+      <TableCell className="font-mono">xether-ai</TableCell>
+      <TableCell><span className="px-2 py-1 text-xs font-medium bg-green-100 text-green-800 rounded-full">Stable</span></TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">JavaScript/TypeScript</TableCell>
+      <TableCell className="font-mono">npm</TableCell>
+      <TableCell className="font-mono">@xether/sdk</TableCell>
+      <TableCell><span className="px-2 py-1 text-xs font-medium bg-green-100 text-green-800 rounded-full">Stable</span></TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">Go</TableCell>
+      <TableCell className="font-mono">go get</TableCell>
+      <TableCell className="font-mono">github.com/xether-ai/go-sdk</TableCell>
+      <TableCell><span className="px-2 py-1 text-xs font-medium bg-green-100 text-green-800 rounded-full">Stable</span></TableCell>
+    </TableRow>
+    <TableRow>
+      <TableCell className="font-medium">Java</TableCell>
+      <TableCell className="font-mono">Maven</TableCell>
+      <TableCell className="font-mono">ai.xether:sdk</TableCell>
+      <TableCell><span className="px-2 py-1 text-xs font-medium bg-green-100 text-green-800 rounded-full">Stable</span></TableCell>
+    </TableRow>
+  </TableBody>
+</Table>
+
+## Quick Start
+
+### Python
+```bash
+pip install xether-ai
+```
+
+```python
+from xether_ai import XetherClient
+
+client = XetherClient(api_key="your-api-key")
+```
+
+### JavaScript/TypeScript
+```bash
+npm install @xether/sdk
+```
+
+```javascript
+import { XetherClient } from '@xether/sdk';
+
+const client = new XetherClient({ apiKey: 'your-api-key' });
+```
+
+### Go
+```bash
+go get github.com/xether-ai/go-sdk
+```
+
+```go
+import "github.com/xether-ai/go-sdk"
+
+client := xether.NewClient("your-api-key")
+```
+
+### Java
+```xml
+<dependency>
+  <groupId>ai.xether</groupId>
+  <artifactId>sdk</artifactId>
+  <version>1.0.5</version>
+</dependency>
+```
+
+```java
+import ai.xether.XetherClient;
+
+XetherClient client = new XetherClient("your-api-key");
+```
+
+## Version Policy
+
+We follow [Semantic Versioning](https://semver.org/) for all SDKs:
+
+- **Major versions** (X.0.0) - Breaking changes, requires migration
+- **Minor versions** (0.X.0) - New features, backward compatible
+- **Patch versions** (0.0.X) - Bug fixes, fully backward compatible
+
+## Support & Updates
+
+### Update Notifications
+- **GitHub Releases**: Watch our repositories for release notifications
+- **Package Managers**: Use `@latest` tag or check for updates regularly
+- **Changelog**: Detailed release notes in each version
+
+### Support Channels
+- **Documentation**: [docs.xether.ai](https://docs.xether.ai)
+- **GitHub Issues**: Report bugs and request features
+- **Community**: Join our [Discord server](https://discord.gg/xether-ai)
+- **Email**: sdk-support@xether.ai
+
+### Beta Programs
+Want to try new features before they're released? Join our beta program:
+
+1. **Apply** at [beta.xether.ai](https://beta.xether.ai)
+2. **Get access** to pre-release versions
+3. **Provide feedback** to shape the future of our SDKs
+
+## Security
+
+### Vulnerability Reporting
+If you discover a security vulnerability in any SDK:
+
+1. **Do not** open a public issue
+2. **Email** security@xether.ai with details
+3. **We'll respond** within 48 hours
+4. **Patch** will be released according to severity
+
+### Dependencies
+All SDKs undergo regular security audits and dependency scanning. We update dependencies promptly when vulnerabilities are discovered.
+
+## Contributing
+
+We welcome contributions to our SDKs! See our [contributing guidelines](https://github.com/xether-ai/.github/blob/main/CONTRIBUTING.md) for:
+
+- Code style and standards
+- Testing requirements
+- Pull request process
+- Release procedures
+
+For questions about SDK versions or installation, contact our support team at [sdk-support@xether.ai](mailto:sdk-support@xether.ai).