GuardSQL v0.2.0¶

Released: 2026-08-23

GuardSQL v0.2.0 is the rename release. The project moved from GrokifyQL to GuardSQL to make the purpose clearer: a SQL-facing safety and policy layer for customer-authored analytics queries.

Highlights¶

Project name changed from GrokifyQL to GuardSQL.
Go module path changed to github.com/grokify/guardsql.
TypeScript package changed to @grokify/guardsql.
Formatter command path changed to cmd/guardsqlfmt.
Documentation, changelog metadata, MkDocs links, examples, generated TypeScript distribution files, and the optional SystemForge adapter module were updated to use the GuardSQL name.

Breaking Changes¶

This release intentionally breaks import paths and package names.

Area	Old	New
Go module	`github.com/grokify/grokifyql`	`github.com/grokify/guardsql`
Go package	`grokifyql`	`guardsql`
Formatter command	`cmd/grokifyqlfmt`	`cmd/guardsqlfmt`
TypeScript package	`@grokify/grokifyql`	`@grokify/guardsql`
SystemForge adapter	`github.com/grokify/grokifyql/authzsystemforge`	`github.com/grokify/guardsql/authzsystemforge`

Upgrade Guide¶

Update Go imports:

import "github.com/grokify/guardsql"

Update Go usage:

q, err := guardsql.Parse(input)
if err != nil {
    return err
}

Update formatter invocations:

go run ./cmd/guardsqlfmt query.gql

Update TypeScript imports:

import { parse, format } from '@grokify/guardsql'

If you use the browser-side parse error type, update GrokifyQLParseError to GuardSQLParseError.

Notes¶

The query language behavior remains the same as v0.1.0. This release is about naming, module identity, package identity, and documentation alignment.