sql-code-graph 1.36.0__py3-none-any.whl → 1.36.2__py3-none-any.whl

{sql_code_graph-1.36.0.dist-info → sql_code_graph-1.36.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sql-code-graph
-Version: 1.36.0
+Version: 1.36.2
 Summary: SQL code graph analyzer and lineage tracer
 Project-URL: Homepage, https://github.com/Warhorze/sql-code-graph
 Project-URL: Repository, https://github.com/Warhorze/sql-code-graph
@@ -85,7 +85,8 @@ for that project.
 
 1. **Initialize**: `sqlcg db init`
 2. **Index**: `sqlcg index ./sql --dialect snowflake`
-3. **Keep fresh**: `sqlcg git install-hooks` (optional)
+3. **Keep fresh**: `sqlcg git install-hooks` (auto-reindex on branch switch), or
+   `sqlcg watch ./sql` to re-index automatically as you edit files (both optional)
 
 ## Full setup (recommended)
 
@@ -303,7 +304,8 @@ sqlcg analyze empty-impact <table>...  # downstream blast radius when named tabl
 sqlcg analyze pr-impact --base <ref>   # detect producers a PR dropped + their blast radius (code-regression detection)
 sqlcg analyze upstream/downstream      # trace lineage from the CLI
 sqlcg find table/column/pattern        # search the graph
-sqlcg watch <path>                     # watch for file changes
+sqlcg watch <path>                     # watch a directory and re-index on SQL file changes
+sqlcg viz                              # generate a self-contained graph-explorer HTML
 sqlcg db info                          # graph stats + freshness (indexed SHA vs HEAD)
 sqlcg git install-hooks                # install post-checkout + post-merge resync hooks
 sqlcg gain                             # show usage metrics
@@ -316,7 +318,7 @@ sqlcg mcp restart                      # stop the server (client must respawn it
 sqlcg version                          # show installed version
 ```
 
-### Staying on the latest build (v1.5.0)
+### Staying on the latest build
 
 The installed package, the CLI, and the running MCP server all report the **same**
 version (`sqlcg.__version__`). After upgrading, an editor may still be talking to an
@@ -325,7 +327,7 @@ server's `version` and a `stale_by_version` flag that is `true` when the live se
 differs from the installed build. Re-running `sqlcg install` stops the stale server so
 your editor respawns it on the new build, so you never debug against an outdated server.
 
-### Reads while the server is running (v1.2.0)
+### Reads while the server is running
 
 DuckDB takes an exclusive lock on the database file, so while the MCP server is
 live it holds that lock (other processes cannot open the file, even read-only).
@@ -336,6 +338,34 @@ running they open the database directly, exactly as before. If the server is
 mid-reindex the read waits for it to finish rather than failing with
 "Database is locked".
 
+### Visualising the graph (`viz`)
+
+`sqlcg viz` generates a **self-contained graph-explorer HTML** from the live
+graph — every node, edge, the force-graph library, and the facet data are inlined
+into a single file, so it opens by double-click in a browser with no server or
+external resources.
+
+```bash
+sqlcg viz                              # writes table_graph.html in the current dir
+sqlcg viz --out lineage.html           # choose the output path
+```
+
+In the browser the filter composes schema ∩ kind ∩ tag (multi-select per facet)
+plus a job dropdown; an edge renders only when both endpoints are visible. Table,
+view, and temp nodes are on by default; CTE and derived nodes are off (toggleable).
+
+Two optional CSV facets let you colour and slice the graph by your own
+conventions — both are `pattern,label[,color]` with a required header, patterns
+are case-insensitive `fnmatch` globs (`*`, `?`) matched against the qualified
+table name:
+
+```bash
+sqlcg viz --tags tags.csv              # legend swatches: colour + filter the graph
+sqlcg viz --jobs jobs.csv              # populate the job dropdown (filter only)
+```
+
+Omit `--tags` to hide the tag legend; omit `--jobs` to leave the dropdown empty.
+
 ## Supported dialects
 
 sqlcg is built on [sqlglot](https://github.com/tobymao/sqlglot), so other dialects

{sql_code_graph-1.36.0.dist-info → sql_code_graph-1.36.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sqlcg/__init__.py,sha256=XPECmPOL0Clmm8vi1OTnN9oS6T6x-udm0Qb_r_tQoEA,116
+sqlcg/__init__.py,sha256=lDqeTiiKtYlwFCXOBJv--TA4e7oisecgTT3NeETH6eY,116
 sqlcg/__main__.py,sha256=1YoFLcqEgTwYq1J3TbUwpkdG0zeeLIf2fJvwWI-CLFU,109
 sqlcg/cli/__init__.py,sha256=W8fD0LpMq2xm_5WKGNMvJh2WBL1ho5E8hUeAqXQYT1g,28
 sqlcg/cli/coverage.py,sha256=Xm9ITzZDHv2mJ70Q5jCacVuhDStVrE3gq12_-Ypvtd8,43823
@@ -44,7 +44,7 @@ sqlcg/lineage/schema_resolver.py,sha256=iXt6LYF6UVWsGUpcfbmjmGn9wCgXl721lTGf_8Aa
 sqlcg/metrics/__init__.py,sha256=hLJ6wm4St8qqYwKh3o9QG7lcEt1BEYM31ccqO9tGpIg,133
 sqlcg/metrics/store.py,sha256=KuDtxvyAgug9_KtiSCpvgKM2VZM7VSaI3D11uMLjJJk,10604
 sqlcg/parsers/__init__.py,sha256=AamA8wBbDZV9_zEtZCI4Hyen5UAVKHmBwjTghTt2PZE,785
-sqlcg/parsers/ansi_parser.py,sha256=RX6eVj7gt1qmsHNJLAF_a4jyW3RCI5W2oF4rd53cKNg,39336
+sqlcg/parsers/ansi_parser.py,sha256=7pudMxij87m419OcCzmaus124x2vHJ62bIGhBTBlZDw,40348
 sqlcg/parsers/base.py,sha256=d5s5_LSv96jrww9vx52GujjrLHwpxy_UOhmIlWcKglw,106489
 sqlcg/parsers/bigquery_parser.py,sha256=g0B6aIpMyxLMVQ3ohAAjzR4nEmMh-WGkFcYLMiKdLxs,3177
 sqlcg/parsers/dynamic_name.py,sha256=q0QAa9iAcmRW4e_0G2b2j-xTbI3VR1-Wwa-nJRLtrQw,6836
@@ -73,7 +73,7 @@ sqlcg/viz/render.py,sha256=BINkGbJbbb_iqhrkN795RaQsdg8nqCiJtsEFF1yo22Y,2737
 sqlcg/viz/tags.py,sha256=6zRnGlHjuGmEeB6yN1uhzm8rqL7ZGoyL1Ki7jI5oM6A,5368
 sqlcg/viz/assets/force-graph.min.js,sha256=jNdYdDdrYiUdUlElxRkolPBt30rstQk2q15Q32VVdzc,177272
 sqlcg/viz/assets/template.html,sha256=9_j-mvo1ZxwgiJPDdVrNmca37dTrTjjYVd3977u-DxE,12294
-sql_code_graph-1.36.0.dist-info/METADATA,sha256=qmHQutd2-IfpHk1ETAPDISdRiprgHJSe8DvFQokUOa8,17791
-sql_code_graph-1.36.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-sql_code_graph-1.36.0.dist-info/entry_points.txt,sha256=Wfe49sVzV9p4eVFGo5RxcV-frr3HOP0yzzst8JBxQLQ,46
-sql_code_graph-1.36.0.dist-info/RECORD,,
+sql_code_graph-1.36.2.dist-info/METADATA,sha256=if10KHC8utK49r0BY4N9DmsK98-Uz1mUlauVqTiFEaE,19208
+sql_code_graph-1.36.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+sql_code_graph-1.36.2.dist-info/entry_points.txt,sha256=Wfe49sVzV9p4eVFGo5RxcV-frr3HOP0yzzst8JBxQLQ,46
+sql_code_graph-1.36.2.dist-info/RECORD,,

sqlcg/__init__.py

@@ -1,5 +1,5 @@
 """SQL Code Graph - SQL lineage and dependency analysis tool."""
 
-__version__ = "1.36.0"
+__version__ = "1.36.2"
 
 __all__ = ["__version__"]

sqlcg/parsers/ansi_parser.py

@@ -564,12 +564,26 @@ class AnsiParser(SqlParser):
         # DML (a separate node the gate never touches), so gating PROCEDURE is
         # edge-neutral. This single gate feeds all three
         # `referenced_tables.extend(query_node.sources)` sites
-        # (ansi_parser.py:246, snowflake_parser.py:784 / :944).
+        # (ansi_parser.py:246, snowflake_parser.py:894 / :1054).
         is_non_table_create = isinstance(stmt, exp.Create) and stmt.kind not in ("TABLE", "VIEW")
 
+        # Phantom source-node gate part 2 (#161 part 2,
+        # plan/sprints/fix_drop_alter_phantom_source_node.md): DROP / ALTER /
+        # TRUNCATE reference their TARGET object, not a data-flow source. No SELECT
+        # body is structurally possible, so build_scope() returns None for them and
+        # _fallback_table_scan below would otherwise scoop the target name into
+        # `sources`, minting a phantom degree-0 island SqlTable node + a phantom
+        # SELECTS_FROM edge (measured: 169 sole-DROP/ALTER/TRUNCATE-origin nodes,
+        # 1,308 phantom SELECTS_FROM edges on the DWH corpus). Keyed off the AST
+        # type (independent of _classify/QueryKind), and PER-STATEMENT: a table
+        # legitimately created/read by a *different* statement keeps its node + real
+        # edges; only the source the DROP/ALTER/TRUNCATE statement would have
+        # contributed is suppressed.
+        is_non_flow_ddl = isinstance(stmt, (exp.Drop, exp.Alter, exp.TruncateTable))
+
         # Try to extract table references using scope analysis
         try:
-            if is_non_table_create:
+            if is_non_table_create or is_non_flow_ddl:
                 sources = []
             else:
                 # Use pre-built scope if provided, otherwise build it here (fallback)