Release v0.4.0

Author: melonamin

CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-03-02
+
+### Added
+
+#### SQL Linter Engine (flowscope-core)
+- **Full SQL linting engine** with 60+ rules targeting SQLFluff parity
+  - **Aliasing rules** (AL001–AL009): alias expression style, column alias quoting, unused aliases, duplicate column names, alias length limits, force-enable aliasing
+  - **Ambiguity rules** (AM001–AM009): DISTINCT with GROUP BY, UNION type handling, ORDER BY column ordinals, ambiguous column counts, bare JOINs, set-column mismatches, implicit cross joins, limit without ORDER BY
+  - **Capitalisation rules** (CP001–CP005): keyword, identifier, function name, literal, and type-annotation casing with consistent/upper/lower modes and `ignore_words_regex` support
+  - **Convention rules** (CV001–CV012): operator style, COALESCE usage, trailing commas, COUNT row-style, IS NULL comparison, statement terminators, unnecessary brackets, LEFT JOIN preference, block quotes, quoted literals, CAST shorthand, implicit join detection
+  - **Jinja rules** (JJ001): template tag detection with trim-marker parity
+  - **Layout rules** (LT001–LT015): trailing whitespace, indentation, operator placement, comma position, long lines, function spacing, bracket placement, CTE newlines, SELECT modifiers, set operators, end-of-file newlines, start-of-file blanks, keyword line position, blank line limits
+  - **Reference rules** (RF001–RF006): keyword references, qualified wildcards, single-table qualifications, keyword aliases, identifier quoting policies
+  - **Structure rules** (ST001–ST012): ELSE/THEN on new lines, simple CASE, unused CTEs, nested CASE, subquery-to-CTE, column ordering, USING joins, DISTINCT parentheses, join condition order, constant predicates, unused joins, consecutive semicolons
+  - **T-SQL rules** (TQ001–TQ003): SP_ prefix, SET NOCOUNT, batch separators
+- **Rule configuration system** supporting SQLFluff `.sqlfluff` config format with per-rule options (e.g., `capitalisation_policy`, `line_position`, `max_line_length`, `allow_scalar`)
+- **Dialect-aware detection** adapting rule behavior for PostgreSQL, BigQuery, Snowflake, Redshift, SparkSQL, MSSQL, and others
+- **Autofix metadata** on issues with `Safe`/`Unsafe` applicability markers and patch edits
+
+#### CLI (flowscope-cli)
+- `--lint` flag for SQL linting with JSON, compact, and human-readable output formats
+- `--fix` flag for automatic SQL fixing with safe-only default and `--legacy-ast-fixes` for additional rewrites
+- `--fix-only` mode for applying fixes without re-linting
+- `--exclude-rules` for disabling specific lint rules
+- `--rule-configs-json` for passing rule configuration as JSON
+- `--show-fixes` to display applied fix details
+- `--jobs` for parallel multi-file lint/fix processing
+- `--no-respect-gitignore` for including gitignored files
+- Fix engine with iterative convergence loop, overlap recovery, and incremental rule evaluation budgets
+- Performance-tuned large-SQL handling with capped fix passes and targeted LT02 cleanup
+
+#### CI
+- GitHub Actions CI workflow for lint, test, and parity validation
+
+### Improved
+
+#### Core Engine (flowscope-core)
+- Migrated all lint rules from regex to AST/tokenizer-driven detection for accuracy and performance
+- Shared document token stream across rules to avoid redundant tokenization
+- Token-span-based issue reporting for precise editor navigation
+
+#### Web App (app/)
+- Integrated linter into the web app: lint is now enabled by default in the analysis worker
+- Updated WASM bindings to include lint API surface (`LintIssue`, `LintRequest`, `LintConfig` types)
+- Lint-aware issues panel with updated filtering
+- Updated mascot to purple-headed duck and added favicon, removed beta badge
+
 ## [0.3.1] - 2026-01-23
 
 ### Fixed

Cargo.toml

@@ -8,15 +8,15 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "0.3.1"
+version = "0.4.0"
 authors = ["PondPilot Team"]
 edition = "2021"
 license = "Apache-2.0"
 repository = "https://github.com/pondpilot/flowscope"
 
 [workspace.dependencies]
-flowscope-core = { version = "0.3.1", path = "crates/flowscope-core", default-features = false }
-flowscope-export = { version = "0.3.1", path = "crates/flowscope-export", default-features = false }
+flowscope-core = { version = "0.4.0", path = "crates/flowscope-core", default-features = false }
+flowscope-export = { version = "0.4.0", path = "crates/flowscope-export", default-features = false }
 sqlparser = "0.59"
 serde = { version = "1.0", features = ["derive", "rc"] }
 serde_json = "1.0"

app/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>FlowScope - SQL Lineage Analyzer</title>
     <script>
       (function() {

app/public/favicon.svg

@@ -24,10 +24,10 @@ export function FlowScopeLogo({ className }: FlowScopeLogoProps) {
         fill="currentColor"
         fillOpacity="0.3"
       />
-      {/* Head - green */}
+      {/* Head - purple */}
       <path
         d="M31.5 27C24.0442 27 18 20.9558 18 13.5C18 6.04416 24.0442 3.25905e-07 31.5 0C38.9558 -3.25905e-07 45 6.04416 45 13.5C45 20.9558 38.9558 27 31.5 27Z"
-        fill="#4CAE4F"
+        fill="#A78BFA"
       />
       {/* Eyes - dark blue */}
       <path

app/src/assets/duck-dark.svg

@@ -32,6 +32,8 @@ interface IssuesFilterBarProps {
   };
   /** Number of schema-related issues (UNKNOWN_COLUMN, UNKNOWN_TABLE, etc.) */
   schemaIssueCount?: number;
+  /** Number of lint issues (codes starting with LINT_) */
+  lintIssueCount?: number;
   /** Callback to open the schema editor */
   onOpenSchemaEditor?: () => void;
   className?: string;
@@ -58,6 +60,7 @@ export function IssuesFilterBar({
   availableSourceFiles,
   counts,
   schemaIssueCount,
+  lintIssueCount,
   onOpenSchemaEditor,
   className,
 }: IssuesFilterBarProps) {
@@ -114,18 +117,24 @@ export function IssuesFilterBar({
     [filterState.sourceFiles, updateFilter]
   );
 
+  const toggleLintIssues = useCallback(() => {
+    updateFilter({ showLintIssues: !filterState.showLintIssues });
+  }, [filterState.showLintIssues, updateFilter]);
+
   const clearAll = useCallback(() => {
     updateFilter({
       severity: 'all',
       codes: [],
       sourceFiles: [],
+      showLintIssues: true,
     });
   }, [updateFilter]);
 
   const hasActiveFilters =
     filterState.severity !== 'all' ||
     filterState.codes.length > 0 ||
-    filterState.sourceFiles.length > 0;
+    filterState.sourceFiles.length > 0 ||
+    !filterState.showLintIssues;
 
   return (
     <div className={cn('flex flex-col gap-2 px-4 py-2 border-b bg-muted/5', className)}>
@@ -247,8 +256,45 @@ export function IssuesFilterBar({
           </DropdownMenu>
         )}
 
-        {/* Right-aligned section: schema badge + clear all */}
+        {/* Clear all button */}
+        {hasActiveFilters && (
+          <button
+            onClick={clearAll}
+            className="h-6 px-2 text-xs text-slate-500 hover:text-slate-900 dark:hover:text-slate-100 transition-colors"
+          >
+            Clear all
+          </button>
+        )}
+
+        {/* Right-aligned section: lint toggle + schema badge */}
         <div className="flex items-center gap-2 ml-auto">
+          {/* Lint issues toggle */}
+          {lintIssueCount !== undefined && lintIssueCount > 0 && (
+            <button
+              role="switch"
+              aria-checked={filterState.showLintIssues}
+              onClick={toggleLintIssues}
+              className="flex items-center gap-2 h-8 text-xs font-medium text-slate-600 dark:text-slate-400"
+            >
+              <span>Lint</span>
+              <span
+                className={cn(
+                  'relative inline-flex h-4 w-7 shrink-0 items-center rounded-full transition-colors',
+                  filterState.showLintIssues
+                    ? 'bg-slate-600 dark:bg-slate-400'
+                    : 'bg-slate-300 dark:bg-slate-600'
+                )}
+              >
+                <span
+                  className={cn(
+                    'inline-block h-3 w-3 rounded-full bg-white shadow-sm transition-transform',
+                    filterState.showLintIssues ? 'translate-x-3.5' : 'translate-x-0.5'
+                  )}
+                />
+              </span>
+            </button>
+          )}
+
           {/* Schema issues badge */}
           {schemaIssueCount !== undefined && schemaIssueCount > 0 && onOpenSchemaEditor && (
             <button
@@ -264,16 +310,6 @@ export function IssuesFilterBar({
               <span className="text-xs font-medium">schema</span>
             </button>
           )}
-
-          {/* Clear all button */}
-          {hasActiveFilters && (
-            <button
-              onClick={clearAll}
-              className="h-6 px-2 text-xs text-slate-500 hover:text-slate-900 dark:hover:text-slate-100 transition-colors"
-            >
-              Clear all
-            </button>
-          )}
         </div>
       </div>
 

app/src/assets/duck.svg

@@ -21,6 +21,10 @@ function isSchemaIssue(issue: Issue): boolean {
   return SCHEMA_ISSUE_CODES.includes(issue.code);
 }
 
+function isLintIssue(issue: Issue): boolean {
+  return issue.code.startsWith('LINT_');
+}
+
 export function SchemaAwareIssuesPanel({
   projectId,
   onOpenSchemaEditor,
@@ -76,6 +80,11 @@ export function SchemaAwareIssuesPanel({
   // Apply filters to issues
   const filteredIssues = useMemo(() => {
     return sortedIssues.filter((issue) => {
+      // Lint issues toggle
+      if (!filterState.showLintIssues && isLintIssue(issue)) {
+        return false;
+      }
+
       // Severity filter
       if (filterState.severity !== 'all' && issue.severity !== filterState.severity) {
         return false;
@@ -98,21 +107,28 @@ export function SchemaAwareIssuesPanel({
     });
   }, [sortedIssues, filterState, getIssueSourceName]);
 
-  // Calculate counts for the filter bar (total, not filtered)
+  // Base issues after applying the lint toggle (used for counts and empty states)
+  const baseIssues = useMemo(() => {
+    if (filterState.showLintIssues) return sortedIssues;
+    return sortedIssues.filter((i) => !isLintIssue(i));
+  }, [sortedIssues, filterState.showLintIssues]);
+
+  // Calculate counts for the filter bar (respects lint toggle, ignores other filters)
   const counts = useMemo(() => {
-    const errors = sortedIssues.filter((i) => i.severity === 'error').length;
-    const warnings = sortedIssues.filter((i) => i.severity === 'warning').length;
-    const infos = sortedIssues.filter((i) => i.severity === 'info').length;
+    const errors = baseIssues.filter((i) => i.severity === 'error').length;
+    const warnings = baseIssues.filter((i) => i.severity === 'warning').length;
+    const infos = baseIssues.filter((i) => i.severity === 'info').length;
     return {
-      all: sortedIssues.length,
+      all: baseIssues.length,
       errors,
       warnings,
       infos,
     };
-  }, [sortedIssues]);
+  }, [baseIssues]);
 
-  // Count schema issues from total (not filtered) to keep banner stable
+  // Count schema and lint issues from total (not filtered) to keep banner stable
   const schemaIssueCount = sortedIssues.filter(isSchemaIssue).length;
+  const lintIssueCount = sortedIssues.filter(isLintIssue).length;
 
   // Pre-compute locations for all filtered issues to avoid repeated calculations during render
   const issueLocationsMap = useMemo(
@@ -141,7 +157,8 @@ export function SchemaAwareIssuesPanel({
   const hasActiveFilters =
     filterState.severity !== 'all' ||
     filterState.codes.length > 0 ||
-    filterState.sourceFiles.length > 0;
+    filterState.sourceFiles.length > 0 ||
+    !filterState.showLintIssues;
 
   return (
     <div className="flex flex-col h-full bg-background">
@@ -153,6 +170,7 @@ export function SchemaAwareIssuesPanel({
           availableSourceFiles={availableSourceFiles}
           counts={counts}
           schemaIssueCount={schemaIssueCount}
+          lintIssueCount={lintIssueCount}
           onOpenSchemaEditor={onOpenSchemaEditor}
         />
       )}
@@ -172,7 +190,7 @@ export function SchemaAwareIssuesPanel({
             {/* Filtered count indicator */}
             {hasActiveFilters && (
               <p className="text-xs text-muted-foreground mb-3">
-                Showing {filteredIssues.length} of {sortedIssues.length} issues
+                Showing {filteredIssues.length} of {baseIssues.length} issues
               </p>
             )}
             {filteredIssues.map((issue, idx) => {

app/src/components/FlowScopeLogo.tsx

@@ -318,10 +318,7 @@ export function Workspace({ backendReady, error, onRetry, isRetrying }: Workspac
           {/* Logo */}
           <div className="flex items-center gap-3">
             <FlowScopeLogo className="w-8 h-8 text-foreground/30 dark:text-white/30" />
-            <div className="flex items-baseline gap-1">
-              <span className="text-lg font-semibold text-foreground">FlowScope</span>
-              <span className="text-xs font-mono text-muted-foreground">Beta</span>
-            </div>
+            <span className="text-lg font-semibold text-foreground">FlowScope</span>
           </div>
 
           {/* Project Selector */}