Merge branch 'master' into patch-1

Author: jstirnaman

.ci/link-checker/default.lycherc.toml

@@ -0,0 +1,74 @@
+# Lychee link checker configuration
+# Generated by link-checker
+[lychee]
+# Performance settings
+
+# Maximum number of retries for failed checks
+
+max_retries = 3
+
+# Timeout for each link check (in seconds)
+timeout = 30
+
+# Maximum number of concurrent checks
+max_concurrency = 128
+
+skip_code_blocks = false
+
+# HTTP settings
+# Identify the tool to external services
+user_agent = "Mozilla/5.0 (compatible; link-checker)"
+
+# Accept these HTTP status codes as valid
+accept = [200, 201, 202, 203, 204, 206, 301, 302, 303, 304,
+307, 308]
+
+# Skip these URL schemes
+scheme = ["file", "mailto", "tel"]
+
+# Exclude patterns (regex supported)
+exclude = [
+  # Localhost URLs
+  "^https?://localhost",
+  "^https?://127\\.0\\.0\\.1",
+
+  # Common CI/CD environments  
+  "^https?://.*\\.local",
+
+  # Example domains used in documentation
+  "^https?://example\\.(com|org|net)",
+
+  # Placeholder URLs from code block filtering
+  "https://example.com/REMOVED_FROM_CODE_BLOCK",
+  "example.com/INLINE_CODE_URL",
+
+  # URLs that require authentication
+  "^https?://.*\\.slack\\.com",
+  "^https?://.*\\.atlassian\\.net",
+
+  # GitHub URLs (often fail due to rate limiting and bot 
+  # detection)
+  "^https?://github\\.com",
+
+  # StackExchange network URLs (often block automated requests)
+  "^https?://.*\\.stackexchange\\.com",
+  "^https?://stackoverflow\\.com",
+  "^https?://.*\\.stackoverflow\\.com",
+
+  # Docker Hub URLs (rate limiting and bot detection)
+  "^https?://hub\\.docker\\.com",
+
+  # Common documentation placeholders
+  "YOUR_.*",
+  "REPLACE_.*",
+  "<.*>",
+]
+
+# Request headers
+[headers]
+# Add custom headers here if needed
+# "Authorization" = "Bearer $GITHUB_TOKEN"
+
+# Cache settings
+cache = true
+max_cache_age = "1d"

.ci/link-checker/production.lycherc.toml

@@ -0,0 +1,116 @@
+# Production Link Checker Configuration for InfluxData docs-v2
+# Optimized for performance, reliability, and reduced false positives
+[lychee]
+# Performance settings
+
+# Maximum number of retries for failed checks
+
+max_retries = 3
+
+# Timeout for each link check (in seconds)
+timeout = 30
+
+# Maximum number of concurrent checks
+max_concurrency = 128
+
+skip_code_blocks = false
+
+# HTTP settings
+# Identify the tool to external services
+"User-Agent" = "Mozilla/5.0 (compatible; influxdata-link-checker/1.0; +https://github.com/influxdata/docs-v2)"
+accept = [200, 201, 202, 203, 204, 206, 301, 302, 303, 304, 307, 308]
+
+# Skip these URL schemes
+scheme = ["mailto", "tel"]
+
+# Performance optimizations
+cache = true
+max_cache_age = "1h"
+
+# Retry configuration for reliability
+include_verbatim = false
+
+# Exclusion patterns for docs-v2 (regex supported)
+exclude = [
+  # Localhost URLs
+  "^https?://localhost",
+  "^https?://127\\.0\\.0\\.1",
+
+  # Common CI/CD environments  
+  "^https?://.*\\.local",
+
+  # Example domains used in documentation
+  "^https?://example\\.(com|org|net)",
+
+  # Placeholder URLs from code block filtering
+  "https://example.com/REMOVED_FROM_CODE_BLOCK",
+  "example.com/INLINE_CODE_URL",
+
+  # URLs that require authentication
+  "^https?://.*\\.slack\\.com",
+  "^https?://.*\\.atlassian\\.net",
+
+  # GitHub URLs (often fail due to rate limiting and bot 
+  # detection)
+  "^https?://github\\.com",
+
+  # Social media URLs (often block bots)
+  "^https?://reddit\\.com",
+  "^https?://.*\\.reddit\\.com",
+
+  # StackExchange network URLs (often block automated requests)
+  "^https?://.*\\.stackexchange\\.com",
+  "^https?://stackoverflow\\.com",
+  "^https?://.*\\.stackoverflow\\.com",
+
+  # Docker Hub URLs (rate limiting and bot detection)
+  "^https?://hub\\.docker\\.com",
+
+  # InfluxData support URLs (certificate/SSL issues in CI)
+  "^https?://support\\.influxdata\\.com",
+
+  # Common documentation placeholders
+  "YOUR_.*",
+  "REPLACE_.*",
+  "<.*>",
+]
+
+# Request headers
+[headers]
+# Add custom headers here if needed
+# "Authorization" = "Bearer $GITHUB_TOKEN"
+"Accept" = "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+"Accept-Language" = "en-US,en;q=0.5"
+"Accept-Encoding" = "gzip, deflate"
+"DNT" = "1"
+"Connection" = "keep-alive"
+"Upgrade-Insecure-Requests" = "1"
+
+[ci]
+# CI-specific settings
+
+[ci.github_actions]
+output_format = "json"
+create_annotations = true
+fail_fast = false
+max_annotations = 50  # Limit to avoid overwhelming PR comments
+
+[ci.performance]
+# Performance tuning for CI environment
+parallel_requests = 32
+connection_timeout = 10
+read_timeout = 30
+
+# Resource limits
+max_memory_mb = 512
+max_execution_time_minutes = 10
+
+[reporting]
+# Report configuration
+include_fragments = false
+verbose = false
+no_progress = true  # Disable progress bar in CI
+
+# Summary settings
+show_success_count = true
+show_skipped_count = true 

.ci/vale/styles/config/vocabularies/InfluxDataDocs/accept.txt

@@ -31,7 +31,7 @@ LogicalPlan
 [Mm]onitor
 MBs?
 PBs?
-Parquet
+Parquet|\b\w*-*parquet-\w*\b|\b--\w*parquet\w*\b|`[^`]*parquet[^`]*`
 Redoc
 SQLAlchemy
 SQLAlchemy

.circleci/config.yml

@@ -1,4 +1,4 @@
-version: 2
+version: 2.1
 jobs:
   build:
     docker:
@@ -31,17 +31,17 @@ jobs:
           command: cd api-docs && bash generate-api-docs.sh      
       - run:
           name: Inject Flux stdlib frontmatter
-          command: node ./flux-build-scripts/inject-flux-stdlib-frontmatter.js
+          command: node ./flux-build-scripts/inject-flux-stdlib-frontmatter.cjs
       - run:
           name: Update Flux/InfluxDB versions
-          command: node ./flux-build-scripts/update-flux-versions.js
+          command: node ./flux-build-scripts/update-flux-versions.cjs
       - save_cache:
           key: install-{{ .Environment.CACHE_VERSION }}-{{ checksum ".circleci/config.yml" }}
           paths:
             - /home/circleci/bin
       - run:
           name: Hugo Build
-          command: npx hugo --logLevel info --minify --destination workspace/public
+          command: yarn hugo --environment production --logLevel info --gc --destination workspace/public
       - persist_to_workspace:
           root: workspace
           paths:
@@ -68,7 +68,6 @@ jobs:
           when: on_success
 
 workflows:
-  version: 2
   build:
     jobs:
       - build

.claude/commands/analyze-api-source.md

@@ -0,0 +1,25 @@
+analyze-api-source:
+  <product_name> <endpoint_name> <parameter_name>
+
+  Analyze source code in the specified repo to determine:
+  1. HTTP method and endpoint path
+  2. Parameters for the given endpoint
+  3. Whether the specified parameter is supported for the given API endpoint
+  4. Parameter format, valid values, and default behavior
+  5. Any limitations or quirks of the parameter 
+
+For product InfluxDB 3 Core and Enterprise,
+  Search repo influxdata/influxdb
+  Search through:
+  - HTTP endpoint handlers in
+  influxdb3_server/src/http/
+  - Parameter structs and deserialization
+  - Request routing and processing logic
+  - Type definitions in influxdb3_types/src/
+
+  In the output, provide: 
+  - Comparison across v1, v2, and v3 API compatibility
+
+In the output, provide:
+  Concrete examples of endpoint and parameter usage
+  Cite specific source code locations.