From 35813ae908ee7207206d55190b508809ce8ed80b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81lvaro=20Tejero=20Cantero?= <alvorithm@teje.ro>
Date: Thu, 16 Jul 2026 10:43:56 +0200
Subject: [PATCH] :sparkles: Make the default query self-explanatory; link the
 Cypher docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The default query is now multi-line with // comments that explain the filter_* column convention in place (Kuzu accepts comments and blank lines mid-statement; verified against an in-memory database through the console query path). The query fieldset is retitled 'LadybugDB Cypher' with the Cypher word linking to https://docs.ladybugdb.com/cypher/.

Signed-off-by: Álvaro Tejero Cantero <alvorithm@teje.ro>
---
 .../resources/app/templates/graph-console.tmpl   |  3 ++-
 backend/src/app/graph/debug.clj                  | 16 +++++++++++-----
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/backend/resources/app/templates/graph-console.tmpl b/backend/resources/app/templates/graph-console.tmpl
index 5732a000a6..b6e387eec3 100644
--- a/backend/resources/app/templates/graph-console.tmpl
+++ b/backend/resources/app/templates/graph-console.tmpl
@@ -101,7 +101,8 @@ Graph Console
     </fieldset>
 
     <fieldset>
-      <legend>Cypher query</legend>
+      <legend>LadybugDB <a href="https://docs.ladybugdb.com/cypher/"
+                            target="_blank">Cypher</a></legend>
       <form id="graph-query-form" method="post" action="/dbg/actions/graph-query">
         <div class="row">
           <textarea name="query" rows="8" style="width:100%; font-family: monospace;"
diff --git a/backend/src/app/graph/debug.clj b/backend/src/app/graph/debug.clj
index 471695cd35..e55d10cf09 100644
--- a/backend/src/app/graph/debug.clj
+++ b/backend/src/app/graph/debug.clj
@@ -24,11 +24,17 @@
 (set! *warn-on-reflection* true)
 
 (def default-query
-  "Default console query. The `filter_*` columns carry node ids for the
-  graph-view result filter; the results table hides them (see
-  `hide-filter-columns` and the template's `renderQueryOutput`)."
-  (str "MATCH (s)-[r]->(t) "
-       "RETURN s.name, label(s) AS src, label(r) AS rel, t.name, label(t) AS tgt, "
+  "Default console query, written to be self-explanatory in the textarea.
+  The `filter_*` columns carry node ids for the graph-view result filter;
+  the results table hides them (see `hide-filter-columns` and the
+  template's `renderQueryOutput`)."
+  (str "MATCH (s)-[r]->(t)\n"
+       "// WHERE some condition\n"
+       "RETURN label(s) AS src, s.name,\n"
+       "       label(r) AS rel,\n"
+       "       t.name, label(t) AS tgt,\n"
+       "\n"
+       "// filter_* columns omitted from table; these needed for graph view\n"
        "s.id AS filter_src_id, t.id AS filter_tgt_id;"))
 
 (defonce ^:private sessions