docs: v1.13.0 release — version bump, docs, website, blog post (#421)

* docs(changelog): promote [Unreleased] to [1.13.0] - 2026-03-20

* chore(release): bump version constants to v1.13.0

* chore(release): fix missed version in cmd/gosqlx/doc.go

* chore(bench): update performance baselines to v1.13.0 (2026-03-20)

* docs: update all documentation to v1.13.0 — add ClickHouse, fix LSP guide staleness

- GETTING_STARTED.md: replace v1.12.0 "What's New" block with v1.13.0 (ClickHouse
  dialect, LSP semantic tokens, LSP debouncing, parser API consolidation, security
  and website updates); bump Go requirement to 1.26+; update all version strings
- USAGE_GUIDE.md: bump version/date header to v1.13.0 / 2026-03-20
- ARCHITECTURE.md: bump version/date header to v1.13.0 / 2026-03-20
- SQL_COMPATIBILITY.md: bump version/date headers and footer; update Overall
  Compliance heading to v1.13.0; add new ClickHouse dialect section (PREWHERE,
  FINAL, GLOBAL IN, MergeTree family, 30+ keywords)
- LINTING_RULES.md: bump version/date header to v1.13.0 / 2026-03-20
- LSP_GUIDE.md: fix staleness (was v1.6.0 Dec 2025) → v1.13.0 / 2026-03-20; add
  Semantic Tokens section (6-type legend) and Diagnostic Debouncing section
- CLAUDE.md: Go 1.25+ → 1.26+; current version v1.12.0 → v1.13.0; add ClickHouse
  to multi-dialect support list
- README.md: Go badge 1.25+ → 1.26+; stats row 1.25M+/6 dialects → 1.38M+/7
  dialects; body text ops/sec updated to 1.38M+

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: add ClickHouse to README dialect feature list

* docs: fix review issues — stale LSP footer, missing ClickHouse in dialects table, perf stat, PRAGMA contradiction

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: remove stale PRAGMA limitation from SQLite section (fixed in v1.9.0)

* feat(website): v1.13.0 — ClickHouse dialect, 7 dialects, new blog post

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(website): expand blog post v1-13-0 with full spec content — title, description, code examples, tables, all sections

* fix(ci): bump action.yml go-version 1.24 → 1.26 to match go.mod

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Ajit Pratap Singh <ajitpratapsingh@Ajits-Mac-mini-2655.local>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

CHANGELOG.md

@@ -7,13 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.13.0] - 2026-03-20
+
 ### Added
-- ClickHouse SQL dialect (`DialectClickHouse = "clickhouse"`) with 30+ keywords: PREWHERE, FINAL, ENGINE, GLOBAL, ASOF, TTL, CODEC, FORMAT, SETTINGS, DISTRIBUTED, MergeTree family engines, ClickHouse-specific data types (FixedString, LowCardinality, Nullable, DateTime64, IPv4, IPv6)
-- `PrewhereClause` field on `SelectStatement` AST node for ClickHouse's pre-filter optimization clause
-- `Final` field on `TableReference` for ClickHouse's FINAL table modifier (forces MergeTree part merge before read)
+- ClickHouse SQL dialect support (`DialectClickHouse = "clickhouse"`) with 30+ keywords
+- `PrewhereClause` field on `SelectStatement` AST for ClickHouse PREWHERE optimization
+- `Final` field on `TableReference` for ClickHouse MergeTree FINAL modifier
 - PREWHERE clause parsing in ClickHouse dialect mode
 - FINAL modifier parsing in ClickHouse dialect mode
-- GLOBAL IN / GLOBAL NOT IN expression parsing in ClickHouse dialect mode
+- GLOBAL IN / GLOBAL NOT IN expression parsing (ClickHouse)
+- ClickHouse data types: FixedString, LowCardinality, Nullable, DateTime64, IPv4, IPv6
+- MergeTree engine family keywords (MERGETREE, REPLACINGMERGETREE, AGGREGATINGMERGETREE, etc.)
+- LSP semantic token provider (`textDocument/semanticTokens/full`) with 6-type legend: keyword, identifier, number, string, operator, comment
+- LSP diagnostic debouncing (300ms) — prevents excessive re-parsing on rapid typing
+- LSP document cleanup on `textDocument/didClose`
+- Glama MCP registry integration with stdio transport support
+- Auto-trigger Glama build on GitHub release via CI (`glama-sync.yml`)
+- Sentry error monitoring, tracing, and session replay on website
+
+### Changed
+- `ParseFromModelTokens` is now the canonical parse entry point (positions always populated)
+- Docker base image Go 1.25 → 1.26 to match go.mod requirement
+- Next.js 16.1.6 → 16.1.7 (CVE-2026-27979, CVE-2026-27980, CVE-2026-29057)
+- Website rebuilt on Next.js 16 App Router with comprehensive a11y, SEO, and performance audit
+- Lighthouse Desktop: 100 Performance / 100 Accessibility / 100 SEO (maintained)
+- CI: Vercel deployment working-directory bug fixed (doubled path `website/website/`)
+
+### Deprecated
+- `parser.Parse([]token.Token)` — use `ParseFromModelTokens` instead
+- `ParseFromModelTokensWithPositions` — consolidated into `ParseFromModelTokens`
+- `ConversionResult.PositionMapping` — always nil, will be removed in v2
+
+### Fixed
+- Production playground WASM 404 (CI working-directory path doubling)
+- WASM service worker cache versioning
+- Broken `.md` relative links in docs → `/docs/` URL paths
+- JSON-LD BreadcrumbList and Article markup on docs pages
+- Horizontal overflow at 320–390px viewport
+- Keyboard accessibility (tabIndex) on scrollable code blocks
 
 ## [1.12.1] - 2026-03-15 — Website Performance & Mobile Optimization
 
@@ -1626,7 +1657,10 @@ For questions about upgrading or changelog entries:
 - Open an issue: https://github.com/ajitpratap0/GoSQLX/issues
 - Join discussions: https://github.com/ajitpratap0/GoSQLX/discussions
 
-[Unreleased]: https://github.com/ajitpratap0/GoSQLX/compare/v1.8.0...HEAD
+[Unreleased]: https://github.com/ajitpratap0/GoSQLX/compare/v1.12.1...HEAD
+[1.13.0]: https://github.com/ajitpratap0/GoSQLX/compare/v1.12.1...v1.13.0
+[1.12.1]: https://github.com/ajitpratap0/GoSQLX/compare/v1.12.0...v1.12.1
+[1.12.0]: https://github.com/ajitpratap0/GoSQLX/compare/v1.10.2...v1.12.0
 [1.8.0]: https://github.com/ajitpratap0/GoSQLX/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/ajitpratap0/GoSQLX/compare/v1.6.0...v1.7.0
 [1.6.0]: https://github.com/ajitpratap0/GoSQLX/compare/v1.5.1...v1.6.0

CLAUDE.md

@@ -6,13 +6,13 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 GoSQLX is a **production-ready**, **race-free**, high-performance SQL parsing SDK for Go that provides lexing, parsing, and AST generation with zero-copy optimizations. The library is designed for enterprise use with comprehensive object pooling for memory efficiency.
 
-**Requirements**: Go 1.25+ (upgraded from 1.23 to fix stdlib vulnerabilities; `mark3labs/mcp-go` requires 1.23)
+**Requirements**: Go 1.26+ (upgraded from 1.23 to fix stdlib vulnerabilities; `mark3labs/mcp-go` requires 1.23)
 
-**Production Status**: ✅ Validated for production deployment (v1.6.0+, current: v1.12.0)
+**Production Status**: ✅ Validated for production deployment (v1.6.0+, current: v1.13.0)
 - Thread-safe with zero race conditions (20,000+ concurrent operations tested)
 - 1.38M+ ops/sec sustained, 1.5M peak with memory-efficient object pooling
 - ~80-85% SQL-99 compliance (window functions, CTEs, set operations, MERGE, etc.)
-- Multi-dialect support: PostgreSQL, MySQL, SQL Server, Oracle, SQLite
+- Multi-dialect support: PostgreSQL, MySQL, SQL Server, Oracle, SQLite, ClickHouse
 
 ## Architecture
 

README.md

@@ -6,7 +6,7 @@
 
 ### Parse SQL at the speed of Go
 
-[![Go Version](https://img.shields.io/badge/Go-1.25+-00ADD8?style=for-the-badge&logo=go)](https://go.dev)
+[![Go Version](https://img.shields.io/badge/Go-1.26+-00ADD8?style=for-the-badge&logo=go)](https://go.dev)
 [![Release](https://img.shields.io/github/v/release/ajitpratap0/GoSQLX?style=for-the-badge&color=orange)](https://github.com/ajitpratap0/GoSQLX/releases)
 [![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge)](http://makeapullrequest.com)
@@ -28,7 +28,7 @@
 
 <br/>
 
-| **1.25M+ ops/sec** | **<1μs latency** | **85% SQL-99** | **6 dialects** | **0 race conditions** |
+| **1.38M+ ops/sec** | **<1μs latency** | **85% SQL-99** | **7 dialects** | **0 race conditions** |
 |:---:|:---:|:---:|:---:|:---:|
 
 </div>
@@ -37,7 +37,7 @@
 
 ## What is GoSQLX?
 
-GoSQLX is a **production-ready SQL parsing SDK** for Go. It tokenizes, parses, and generates ASTs from SQL with zero-copy optimizations and intelligent object pooling - handling **1.25M+ operations per second** with sub-microsecond latency.
+GoSQLX is a **production-ready SQL parsing SDK** for Go. It tokenizes, parses, and generates ASTs from SQL with zero-copy optimizations and intelligent object pooling - handling **1.38M+ operations per second** with sub-microsecond latency.
 
 ```go
 ast, _ := gosqlx.Parse("SELECT u.name, COUNT(*) FROM users u JOIN orders o ON u.id = o.user_id GROUP BY u.name")
@@ -48,7 +48,7 @@ ast, _ := gosqlx.Parse("SELECT u.name, COUNT(*) FROM users u JOIN orders o ON u.
 
 - **Not an ORM** - a parser. You get the AST, you decide what to do with it.
 - **Not slow** - zero-copy tokenization, sync.Pool recycling, no allocations on hot paths.
-- **Not limited** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake. CTEs, window functions, MERGE, set operations.
+- **Not limited** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake, ClickHouse. CTEs, window functions, MERGE, set operations.
 - **Not just a library** - CLI, VS Code extension, GitHub Action, MCP server, WASM playground, Python bindings.
 
 <br/>

action.yml

@@ -115,7 +115,7 @@ runs:
     - name: Setup Go
       uses: actions/setup-go@0c52d547c9bc32b1aa3301fd7a9cb496313a4491  # v5.0.0
       with:
-        go-version: '1.24'
+        go-version: '1.26'
 
     # Disable cache when testing in repository to always build from latest source
     # - name: Cache GoSQLX binary

cmd/gosqlx/cmd/doc.go

@@ -341,7 +341,7 @@
 //
 // Version information:
 //
-//	Version = "1.12.1" - Current CLI version
+//	Version = "1.13.0" - Current CLI version
 //
 // # Dependencies
 //

cmd/gosqlx/cmd/root.go

@@ -28,12 +28,16 @@ import (
 // This version tracks feature releases and compatibility.
 // Format: MAJOR.MINOR.PATCH (Semantic Versioning 2.0.0)
 //
+// Version 1.13.0 includes:
+// - ClickHouse SQL dialect support (PREWHERE, FINAL, GLOBAL IN)
+// - LSP semantic tokens + diagnostic debouncing
+// - Parser API consolidation (ParseFromModelTokens canonical)
 // Version 1.12.1 includes:
 //   - MCP Server: All GoSQLX SQL capabilities as Model Context Protocol tools over streamable HTTP
 //   - 7 MCP tools: validate_sql, format_sql, parse_sql, extract_metadata, security_scan, lint_sql, analyze_sql
 //   - Optional bearer token auth via GOSQLX_MCP_AUTH_TOKEN
 //   - Go minimum bumped to 1.23.0 (required by mark3labs/mcp-go)
-var Version = "1.12.1"
+var Version = "1.13.0"
 
 var (
 	// verbose enables detailed output for debugging and troubleshooting.
@@ -121,7 +125,7 @@ Key features:
 • CI/CD integration with proper exit codes
 
 Performance: 1.5M+ operations/second sustained, 1.97M peak. 100-1000x faster than competitors.`,
-	Version: "1.12.1",
+	Version: "1.13.0",
 }
 
 // Execute adds all child commands to the root command and sets flags appropriately.

cmd/gosqlx/doc.go

@@ -24,7 +24,7 @@
 //
 // # Version
 //
-// Current version: 1.12.1
+// Current version: 1.13.0
 //
 // # Architecture
 //

doc.go

@@ -16,7 +16,7 @@
 // zero-copy tokenization and comprehensive object pooling. It offers enterprise-grade SQL lexing,
 // parsing, and AST generation with support for multiple SQL dialects and advanced SQL features.
 //
-// GoSQLX v1.12.1 includes both a powerful Go SDK and a high-performance CLI tool for SQL processing,
+// GoSQLX v1.13.0 includes both a powerful Go SDK and a high-performance CLI tool for SQL processing,
 // validated for production deployment with race-free concurrent operation and extensive real-world testing.
 //
 // Production Status: VALIDATED FOR PRODUCTION DEPLOYMENT (v1.6.0+)
@@ -278,6 +278,7 @@
 //
 // # Version History
 //
+// v1.13.0: ClickHouse dialect, LSP semantic tokens, parser API consolidation
 // v1.12.1: Website performance - mobile 94, desktop 100, self-hosted fonts, CLS 0
 // v1.12.0: Custom domain gosqlx.dev, remote MCP server at mcp.gosqlx.dev
 // v1.11.1: Website audit fixes, SEO, lazy WASM, design polish

docs/ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # GoSQLX Architecture Documentation
 
-**Version**: v1.12.0
-**Last Updated**: 2026-03-13
+**Version**: v1.13.0
+**Last Updated**: 2026-03-20
 
 ## Table of Contents
 - [System Overview](#system-overview)

docs/GETTING_STARTED.md

@@ -2,19 +2,19 @@
 
 Welcome! This guide will get you parsing SQL in under 5 minutes. No prior experience with GoSQLX required.
 
-**What's New in v1.12.0:**
-- **MCP Server**: All GoSQLX SQL capabilities as Model Context Protocol tools over streamable HTTP
-- 7 MCP tools: `validate_sql`, `format_sql`, `parse_sql`, `extract_metadata`, `security_scan`, `lint_sql`, `analyze_sql`
-- Optional bearer token auth via `GOSQLX_MCP_AUTH_TOKEN`
-- Go minimum bumped to 1.23.0 (required by `mark3labs/mcp-go`)
-- 19 post-UAT fixes: parser, CLI output, security scanner (see CHANGELOG for full list)
-- Enhanced SQL-99 compliance with NULLS FIRST/LAST ordering
+**What's New in v1.13.0:**
+- **ClickHouse Dialect**: Parse ClickHouse SQL including PREWHERE, FINAL, GLOBAL IN, and 30+ ClickHouse keywords
+- **LSP Semantic Tokens**: `textDocument/semanticTokens/full` with 6-type legend for richer IDE highlighting
+- **LSP Debouncing**: 300ms diagnostic debounce prevents excessive re-parsing on rapid typing
+- **Parser API Consolidation**: `ParseFromModelTokens` is now the canonical entry point (positions always populated)
+- **Security**: Next.js 16.1.7 (3 CVE fixes), Docker Go 1.26 base image
+- **Website**: Comprehensive a11y + SEO audit, Sentry monitoring, Glama MCP registry
 
 ---
 
 ## Step 1: Install GoSQLX (30 seconds)
 
-**Requirements**: Go 1.23+
+**Requirements**: Go 1.26+
 
 ### Option A: Install CLI Tool (Recommended)
 ```bash
@@ -29,7 +29,7 @@ go get github.com/ajitpratap0/GoSQLX
 **Verify installation:**
 ```bash
 # Check Go version
-go version  # Should show Go 1.21+
+go version  # Should show Go 1.26+
 
 # If you installed CLI:
 gosqlx --version
@@ -60,7 +60,7 @@ echo "select * from users where age>18" | gosqlx format
 echo "SELECT COUNT(*) FROM orders GROUP BY status" | gosqlx analyze
 ```
 
-**Available CLI Commands (v1.12.0):**
+**Available CLI Commands (v1.13.0):**
 - `validate` - Ultra-fast SQL validation with security scanning
 - `format` - High-performance SQL formatting with style options
 - `analyze` - Advanced SQL analysis with complexity metrics
@@ -70,7 +70,7 @@ echo "SELECT COUNT(*) FROM orders GROUP BY status" | gosqlx analyze
 - `config` - Manage configuration files (.gosqlx.yml)
 - `completion` - Shell autocompletion for bash/zsh/fish
 
-**New in v1.12.0:**
+**New in v1.13.0:**
 ```bash
 # Security scanning for SQL injection
 gosqlx validate --security query.sql
@@ -137,7 +137,7 @@ go run main.go
 
 ---
 
-## Step 4: v1.12.0 Feature Examples (2 minutes)
+## Step 4: v1.13.0 Feature Examples (2 minutes)
 
 ### PostgreSQL Extensions
 
@@ -423,7 +423,7 @@ gosqlx lsp --log /tmp/lsp.log
 - **[API Reference](/docs/api-reference)** - Complete API documentation
 - **[Examples](https://github.com/ajitpratap0/GoSQLX/tree/main/examples)** - Real-world code examples
 
-### v1.12.0 Feature Guides:
+### v1.13.0 Feature Guides:
 - **PostgreSQL Extensions:**
   - LATERAL JOIN for correlated subqueries
   - JSON/JSONB operators (->/->>/#>/@>/?/etc.)
@@ -453,7 +453,7 @@ gosqlx lsp --log /tmp/lsp.log
 ### Advanced Topics:
 - **Low-Level API** - For performance-critical applications (>100K queries/sec)
 - **Object Pooling** - Manual resource management for fine-grained control
-- **Multi-Dialect Support** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite
+- **Multi-Dialect Support** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite, ClickHouse
 - **Unicode Support** - Full international character support
 - **SQL Compatibility** - See [SQL Compatibility](/docs/sql-compatibility) for dialect matrix
 
@@ -490,7 +490,7 @@ gosqlx validate "your SQL here"
 
 ---
 
-## v1.12.0 Feature Highlights
+## v1.13.0 Feature Highlights
 
 ### Production-Ready Performance
 - **1.38M+ operations/second** sustained throughput
@@ -501,7 +501,7 @@ gosqlx validate "your SQL here"
 ### SQL Compliance
 - **~80-85% SQL-99 compliance** including window functions, CTEs, set operations
 - **95%+ success rate** on real-world SQL queries
-- **Multi-dialect support** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite
+- **Multi-dialect support** - PostgreSQL, MySQL, SQL Server, Oracle, SQLite, ClickHouse
 - **Full Unicode support** for international SQL processing
 
 ### Enterprise Features
@@ -518,7 +518,7 @@ gosqlx validate "your SQL here"
 - ✓ Installing GoSQLX (library and CLI)
 - ✓ Validating and formatting SQL with CLI
 - ✓ Parsing SQL in Go applications with simple API
-- ✓ Using v1.12.0 features (PostgreSQL extensions, security, linting, LSP)
+- ✓ Using v1.13.0 features (PostgreSQL extensions, security, linting, LSP)
 - ✓ Common use cases and patterns
 - ✓ Where to find more help
 
@@ -530,4 +530,4 @@ gosqlx validate "your SQL here"
 
 ---
 
-*Built by the GoSQLX community - Production-ready since v1.12.0*
+*Built by the GoSQLX community - Production-ready since v1.12.0, ClickHouse dialect since v1.13.0*