gina 0.3.1-alpha.1 → 0.3.2-alpha.1

package/.github/workflows/test.yml

@@ -14,13 +14,13 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [18, 20, 22]
+        node-version: [22, 24]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
 

package/CHANGELOG.md

@@ -6,6 +6,13 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
 
+## 0.3.1 - 2026-04-06
+### Added
+* SQL index reporting Phase A (#QI1): connectors read indexes.sql at startup and populate query instrumentation index badges in the Inspector
+### Changed
+* HTML rendering now uses direct HTTP/2 stream.respond() + stream.end(), bypassing the HTTP/1.1 compatibility layer (matching JSON rendering behaviour)
+* Removed ssl-checker, colors, and uuid dependencies — engine.io is now the sole runtime dependency
+
 ## 0.3.0 - 2026-04-06
 ### Added
 * HTTP/2 client resilience: retry with backoff (up to 2 retries with 500ms delay), pre-flight PING validation on cached sessions, and session freshness tracking via _lastPongAt. Protects against OrbStack silent TCP drops and stale HTTP/2 sessions.

package/README.md

@@ -1,6 +1,6 @@
 # Gina
 
-[![npm version](https://badge.fury.io/js/gina.svg)](https://badge.fury.io/js/gina) [![GitHub version](https://badge.fury.io/gh/gina-io%2Fgina.svg)](https://badge.fury.io/gh/gina-io%2Fgina) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D%2018-brightgreen)](https://nodejs.org) [![Tests](https://github.com/gina-io/gina/actions/workflows/test.yml/badge.svg)](https://github.com/gina-io/gina/actions/workflows/test.yml)
+[![npm version](https://badge.fury.io/js/gina.svg)](https://badge.fury.io/js/gina) [![GitHub version](https://badge.fury.io/gh/gina-io%2Fgina.svg)](https://badge.fury.io/gh/gina-io%2Fgina) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D%2022-brightgreen)](https://nodejs.org) [![Tests](https://github.com/gina-io/gina/actions/workflows/test.yml/badge.svg)](https://github.com/gina-io/gina/actions/workflows/test.yml)
 
 > **Documentation:** [gina.io/docs](https://gina.io/docs/) · **Issues:** [GitHub](https://github.com/gina-io/gina/issues) · **Changelog:** [CHANGELOG.md](./CHANGELOG.md)
 
@@ -37,18 +37,12 @@ gina bundle:start api @myproject
 open https://localhost:3100
 ```
 
-## What's in 0.3.0-alpha.1
-
-- **AI connector** — any LLM via `connectors.json`; unified `.infer()` normaliser; raw `.client` for streaming
-- **MySQL & PostgreSQL connectors** — entity wiring, SQL files, native Promise + `.onComplete()` shim
-- **Async controller actions** — `async function` actions with automatic rejection handling
-- **`renderStream()`** — stream `AsyncIterable` as SSE or chunked HTTP without buffering
-- **103 Early Hints** — automatic for CSS/JS; manual via `self.setEarlyHints(links)`
-- **Route radix trie** — O(m) candidate lookup at startup; linear scan replaced on cache miss
-- **HTTP/2 session metrics** — `activeSessions`, `totalStreams`, `goawayCount`, `rstCount` in `/_gina/info`
-- **Configurable HTTP/2 settings** — `maxConcurrentStreams` and `initialWindowSize` via `settings.json`
-- **WatcherService hot reload** — file-change-triggered eviction; per-request overhead eliminated
-- **Per-bundle framework version** — pin `"gina_version"` in `manifest.json` per bundle
+## What's in 0.3.1
+
+- **Dependency reduction** — `ssl-checker`, `colors`, and `uuid` removed; engine.io is now the sole runtime dependency
+- **HTTP/2 direct stream for HTML** — `render-swig.js` uses `stream.respond()` + `stream.end()` directly, bypassing the HTTP/1.1 compat layer
+- **SQL index reporting** — MySQL, PostgreSQL, and SQLite connectors read `indexes.sql` at startup; Inspector Query tab shows index badges per query
+- **Release workflow fixes** — auto-delete publish branch; stable docs merge to main
 
 See the full [Changelog](./CHANGELOG.md) and [Roadmap](./ROADMAP.md).
 

package/ROADMAP.md

@@ -12,7 +12,8 @@ This roadmap covers planned features, architectural improvements, new connectors
 | --- | --- | --- |
 | **Apr 2026** | `0.1.8` ✅ | Scaffold correctness · K8s support · Dependency injection · Automatic version migration |
 | **Q2 2026** | `0.2.0` ✅ | Stability · WatcherService · Redis & SQLite connectors · K8s session storage · Startup cache · Pointer compression · Couchbase v2 deprecation · Couchbase security & critical bug fixes · HTTP/2 security hardening |
-| **Q3 2026** | `0.3.0` | Async/await · Dev hot-reload · MySQL & PostgreSQL connectors · AI Phase 2 · Tutorials · Mobile backend guide · Route radix tree · Connector peerDependencies · 103 Early Hints · HTTP/2 observability · Security & CVE page · Couchbase connector hardening · Inspector Phase 1 + Phase 2 · CLI Tier 1 (project lifecycle, port:set, framework:get) |
+| **Q3 2026** | `0.3.0` ✅ | Async/await · Dev hot-reload · MySQL & PostgreSQL connectors · AI Phase 2 · Tutorials · Mobile backend guide · Route radix tree · Connector peerDependencies · 103 Early Hints · HTTP/2 observability · Security & CVE page · Couchbase connector hardening · Inspector Phase 1 + Phase 2 · CLI Tier 1 (project lifecycle, port:set, framework:get) |
+| **Q3 2026** | `0.3.1` | Release workflow fixes · SQL query index reporting · HTTP/2 performance · Dependency reduction (`ssl-checker`, `colors`, `uuid` → Node.js built-ins) |
 | **Q4 2026** | `0.4.0` | TypeScript declarations · AI agents (OpenAPI, MCP) · ScyllaDB connector · PWA scaffold · Prometheus metrics · Advanced tutorial · Website redesign · Docs offline ZIP · Bun investigation · Couchbase v2 removal · HTTP/2 hardening · Trailer support · CLI Tier 2 (bundle/project status, rename, copy, protocol:remove, minions) |
 | **Q1 2027** | `0.5.0` | ESM support · Template engine migration · Structured logging · Alt-Svc · HTTP/2 priorities · WebSocket over HTTP/2 · Inspector Production · CLI Tier 3 (project:move, framework:update, backup/restore, man pages) |
 | **Q3 2027** | `1.0.0` | First stable release — Windows alpha compatibility is a hard gate |

package/framework/v0.3.2-alpha.1/VERSION

@@ -0,0 +1 @@
+0.3.2-alpha.1

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/asset/plugin/dist/vendor/gina/js/gina.js

@@ -9758,7 +9758,7 @@ function ValidatorPlugin(rules, data, formId) {
         require('../../../../../helpers/data');
     }
 
-    var uuid            = (isGFFCtx) ? { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } } : require('uuid');
+    var uuid            = { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } };
     var merge           = (isGFFCtx) ? require('lib/merge') : require('../../../../../lib/merge');
     var inherits        = (isGFFCtx) ? require('lib/inherits') : require('../../../../../lib/inherits');
     var FormValidator   = (isGFFCtx) ? require('lib/form-validator') : require('./form-validator');
@@ -18895,7 +18895,7 @@ function StoragePlugin(options) {
 
     var merge       = merge || require('lib/merge');;
     var Collection  = Collection || require('lib/collection');
-    var uuid        = uuid || { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } };
+    var uuid        = { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } };
     var dateFormat  = dateFormat || require('helpers/dateFormat');
 
 
@@ -19304,7 +19304,7 @@ if ( ( typeof(module) !== 'undefined' ) && module.exports ) {
     // Publish as node.js module
     var merge       = require('lib/merge'); //require('../../../../../lib/merge');
     var Collection  = require('lib/collection'); //require('../../../../../lib/collection');
-    var uuid        = require('uuid');
+    var uuid        = { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } };
 
     module.exports = StoragePlugin
 
@@ -19598,7 +19598,7 @@ if ( typeof(module) !== 'undefined' && module.exports ) {
 function Collection(content, options) {
 
     var isGFFCtx        = ( ( typeof(module) !== 'undefined' ) && module.exports ) ? false : true;
-    var uuid            = (isGFFCtx) ? { v4: function() { return crypto.randomUUID(); } } : require('uuid');
+    var uuid            = { v4: function() { return crypto.randomUUID(); } };
     var merge           = (isGFFCtx) ? require('lib/merge') : require('../../../lib/merge');
 
     // defined search option rules

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/couchbase/lib/connector.v2.js

@@ -13,8 +13,7 @@ var merge           = lib.merge;
 var modelUtil       = new lib.Model();
 
 //globalized
-// CB-LOW-1 fix: uuid was assigned without `var`, leaking into global.uuid.
-var uuid            = require('uuid');
+// CB-LOW-1 fix: uuid import removed in 0.3.1 — was imported but never called.
 N1qlQuery           = couchbase.N1qlQuery || null;
 N1qlStringQuery     = couchbase.N1qlStringQuery || null;
 ViewQuery           = couchbase.ViewQuery || null;

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/couchbase/lib/connector.v3.js

@@ -3,8 +3,7 @@ var fs              = require('fs');
 var util            = require('util');
 var EventEmitter    = require('events').EventEmitter;
 // const exec       = require('child_process').exec;  // CB-SEC-1/2: removed — restQuery now uses http.request()
-// CB-LOW-1 fix: uuid was assigned without `var`, leaking into global.uuid.
-var uuid            = require('uuid');
+// CB-LOW-1 fix: uuid import removed in 0.3.1 — was imported but never called.
 var couchbase       = require(getPath('project') +'/node_modules/couchbase');// jshint ignore:line
 var gina            = require('../../../../core/gna');
 var lib             = gina.lib;

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/couchbase/lib/connector.v4.js

@@ -3,8 +3,7 @@ var fs              = require('fs');
 var util            = require('util');
 var EventEmitter    = require('events').EventEmitter;
 // const exec       = require('child_process').exec;  // CB-SEC-1/2: removed — restQuery now uses http.request()
-// CB-LOW-1 fix: uuid was assigned without `var`, leaking into global.uuid.
-var uuid            = require('uuid');
+// CB-LOW-1 fix: uuid import removed in 0.3.1 — was imported but never called.
 var couchbase       = require(getPath('project') +'/node_modules/couchbase');// jshint ignore:line
 var gina            = require('../../../../core/gna');
 var lib             = gina.lib;

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/mysql/index.js

@@ -61,6 +61,11 @@ function Mysql(conn, infos) {
     var envIsDev    = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
     var isCacheless = (process.env.NODE_ENV_IS_DEV == 'false') ? false : true;
 
+    // #QI1 — in-memory index map built from indexes.sql at startup.
+    // Keys are lowercase table names; values are [{ name, primary }].
+    // null when no indexes.sql exists (grey N/A badge in Inspector).
+    var _knownIndexes = null;
+
     // -------------------------------------------------------------------------
     // init — load entities + SQL methods
     // -------------------------------------------------------------------------
@@ -121,6 +126,18 @@ function Mysql(conn, infos) {
                 if ( /^\./.test(sqlEntries[s]) ) continue;
                 loadSQL(entities, conn, _(sqlDir + '/' + sqlEntries[s]));
             }
+
+            // #QI1 — load indexes.sql if present
+            var indexesFile = _(sqlDir + '/indexes.sql', true);
+            if (fs.existsSync(indexesFile)) {
+                try {
+                    var indexesSrc = fs.readFileSync(indexesFile).toString();
+                    _knownIndexes = sqlParser.parseCreateIndexes(indexesSrc);
+                } catch (e) {
+                    console.warn('[mysql] Failed to parse indexes.sql: ' + e.message);
+                    _knownIndexes = {};
+                }
+            }
         }
 
         return entities;
@@ -262,6 +279,12 @@ function Mysql(conn, infos) {
                     ? process.gina._queryALS.getStore() : null;
                 _devLog = _alsStore ? _alsStore._devQueryLog : null;
                 if (_devLog) {
+                    // #QI1 — resolve indexes from _knownIndexes map
+                    var _indexes = null;
+                    if (_knownIndexes !== null) {
+                        var _tbl = sqlParser.extractTargetTable(queryString);
+                        _indexes = (_tbl && _knownIndexes[_tbl]) ? _knownIndexes[_tbl] : [];
+                    }
                     _queryEntry = {
                         type        : 'MySQL',
                         trigger     : entityName.toLowerCase() + '#' + name,
@@ -270,7 +293,7 @@ function Mysql(conn, infos) {
                         durationMs  : 0,
                         resultCount : 0,
                         resultSize  : 0,
-                        indexes     : null,
+                        indexes     : _indexes,
                         error       : null,
                         source      : source || '',
                         origin      : infos.bundle,

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/postgresql/index.js

@@ -61,6 +61,11 @@ function Postgresql(conn, infos) {
     var envIsDev    = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
     var isCacheless = (process.env.NODE_ENV_IS_DEV == 'false') ? false : true;
 
+    // #QI1 — in-memory index map built from indexes.sql at startup.
+    // Keys are lowercase table names; values are [{ name, primary }].
+    // null when no indexes.sql exists (grey N/A badge in Inspector).
+    var _knownIndexes = null;
+
     // -------------------------------------------------------------------------
     // init — load entities + SQL methods
     // -------------------------------------------------------------------------
@@ -121,6 +126,18 @@ function Postgresql(conn, infos) {
                 if ( /^\./.test(sqlEntries[s]) ) continue;
                 loadSQL(entities, conn, _(sqlDir + '/' + sqlEntries[s]));
             }
+
+            // #QI1 — load indexes.sql if present
+            var indexesFile = _(sqlDir + '/indexes.sql', true);
+            if (fs.existsSync(indexesFile)) {
+                try {
+                    var indexesSrc = fs.readFileSync(indexesFile).toString();
+                    _knownIndexes = sqlParser.parseCreateIndexes(indexesSrc);
+                } catch (e) {
+                    console.warn('[postgresql] Failed to parse indexes.sql: ' + e.message);
+                    _knownIndexes = {};
+                }
+            }
         }
 
         return entities;
@@ -263,6 +280,12 @@ function Postgresql(conn, infos) {
                     ? process.gina._queryALS.getStore() : null;
                 _devLog = _alsStore ? _alsStore._devQueryLog : null;
                 if (_devLog) {
+                    // #QI1 — resolve indexes from _knownIndexes map
+                    var _indexes = null;
+                    if (_knownIndexes !== null) {
+                        var _tbl = sqlParser.extractTargetTable(queryString);
+                        _indexes = (_tbl && _knownIndexes[_tbl]) ? _knownIndexes[_tbl] : [];
+                    }
                     _queryEntry = {
                         type        : 'PG',
                         trigger     : entityName.toLowerCase() + '#' + name,
@@ -271,7 +294,7 @@ function Postgresql(conn, infos) {
                         durationMs  : 0,
                         resultCount : 0,
                         resultSize  : 0,
-                        indexes     : null,
+                        indexes     : _indexes,
                         error       : null,
                         source      : source || '',
                         origin      : infos.bundle,

package/framework/v0.3.2-alpha.1/core/connectors/sql-parser.js

@@ -0,0 +1,291 @@
+'use strict';
+/**
+ * sql-parser.js — state-machine SQL comment utilities (#SQL1)
+ *
+ * Shared by the Couchbase N1QL connector and the SQLite connector.
+ *
+ * Both parsers previously used single-pass regexes that broke on:
+ *   - Nested block comments:  /* outer /* inner *‌/ still-outer *‌/
+ *   - -- or // inside string literals: WHERE name = 'it''s -- not a comment'
+ *
+ * The state machine below tracks four states:
+ *   DEFAULT      — normal query text
+ *   BLOCK        — inside /* ... *‌/ (depth counter handles nesting)
+ *   LINE         — inside -- ... or // ... until \n
+ *   STRING       — inside '...' or "..." (doubled-quote escape '' / "")
+ *
+ * SQL uses doubled-quote escapes ('' not \') — backslash escapes are not
+ * recognised here to match standard SQL behaviour.
+ */
+
+
+/**
+ * stripComments — remove all SQL/N1QL comments from src.
+ *
+ * Block comments /* ... *‌/ are replaced with a single space to preserve
+ * token separation. Line comments produce no output. String content is
+ * passed through verbatim so -- or /* inside a string literal is never
+ * treated as a comment opener.
+ *
+ * @param  {string} src
+ * @return {string}
+ */
+function stripComments(src) {
+    var out   = '';
+    var i     = 0;
+    var len   = src.length;
+    var depth = 0;
+
+    while (i < len) {
+        var c    = src[i];
+        var peek = src[i + 1];
+
+        if (depth > 0) {
+            // Inside a block comment
+            if (c === '/' && peek === '*')      { depth++; i += 2; }
+            else if (c === '*' && peek === '/') { depth--; i += 2; if (depth === 0) out += ' '; }
+            else                                { i++; }
+            continue;
+        }
+
+        // Enter block comment
+        if (c === '/' && peek === '*') { depth++; i += 2; continue; }
+
+        // Line comment (SQL -- or C-style //) — skip to end of line
+        if ((c === '-' && peek === '-') || (c === '/' && peek === '/')) {
+            while (i < len && src[i] !== '\n') i++;
+            continue;
+        }
+
+        // String literal — pass through verbatim; handle doubled-quote escapes
+        if (c === "'" || c === '"') {
+            var q = c;
+            out += c;
+            i++;
+            while (i < len) {
+                var ch = src[i++];
+                out += ch;
+                if (ch === q) {
+                    if (src[i] === q) { out += src[i++]; } // '' or "" escape
+                    else break;                              // end of string
+                }
+            }
+            continue;
+        }
+
+        out += c;
+        i++;
+    }
+
+    return out;
+}
+
+
+/**
+ * extractFirstBlockComment — return the first /* ... *‌/ comment verbatim
+ * (including the /* and *‌/ delimiters), or null if none is found.
+ *
+ * Nesting is handled: /* outer /* inner *‌/ *‌/ is treated as one comment
+ * and the full extent is returned. String literals are skipped — a /* inside
+ * a string does not open a comment.
+ *
+ * Used by the Couchbase N1QL parser to extract $param references from the
+ * leading annotation comment before stripping all comments from the query.
+ *
+ * @param  {string} src
+ * @return {string|null}
+ */
+function extractFirstBlockComment(src) {
+    var i     = 0;
+    var len   = src.length;
+    var depth = 0;
+    var start = -1;
+
+    while (i < len) {
+        var c    = src[i];
+        var peek = src[i + 1];
+
+        if (depth > 0) {
+            if (c === '/' && peek === '*') {
+                depth++; i += 2;
+            } else if (c === '*' && peek === '/') {
+                depth--; i += 2;
+                if (depth === 0) return src.slice(start, i);
+            } else {
+                i++;
+            }
+            continue;
+        }
+
+        // Enter block comment
+        if (c === '/' && peek === '*') {
+            start = i;
+            depth++;
+            i += 2;
+            continue;
+        }
+
+        // String literal — skip, do not scan for comment openers inside strings
+        if (c === "'" || c === '"') {
+            var q = c;
+            i++;
+            while (i < len) {
+                var ch = src[i++];
+                if (ch === q) {
+                    if (src[i] === q) i++; // '' or "" escape
+                    else break;
+                }
+            }
+            continue;
+        }
+
+        i++;
+    }
+
+    return null; // no block comment found
+}
+
+
+/**
+ * parseCreateIndexes — parse CREATE INDEX statements from a SQL source string
+ * and build a table-keyed index map.
+ *
+ * Handles:
+ *   CREATE INDEX <name> ON <table> (...)
+ *   CREATE UNIQUE INDEX <name> ON <table> (...)
+ *   CREATE INDEX IF NOT EXISTS <name> ON <table> (...)
+ *   CREATE UNIQUE INDEX IF NOT EXISTS <name> ON <table> (...)
+ *
+ * Table names are normalised to lowercase. Quoted identifiers (`"tbl"`,
+ * `` `tbl` ``) are unquoted. Schema-qualified names (`schema.table`) keep
+ * only the table part.
+ *
+ * @param  {string} src  Raw SQL source (may contain comments)
+ * @return {Object.<string, Array<{name: string, primary: boolean}>>}
+ *         Map of lowercase table name → array of index descriptors.
+ *         Returns an empty object when no CREATE INDEX statements are found.
+ */
+function parseCreateIndexes(src) {
+    var map = {};
+    if (!src) return map;
+
+    // Strip comments first so -- or /* inside strings doesn't confuse us
+    var clean = stripComments(src);
+
+    // Match CREATE [UNIQUE] INDEX [IF NOT EXISTS] <name> ON <table>
+    // Captures: (1) index name, (2) table name
+    var re = /CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?(\S+)\s+ON\s+(\S+)/gi;
+    var m;
+
+    while ((m = re.exec(clean)) !== null) {
+        var idxName   = unquoteIdentifier(m[1]);
+        var tableName = unquoteIdentifier(m[2]);
+
+        // Strip schema prefix (schema.table → table)
+        var dotPos = tableName.lastIndexOf('.');
+        if (dotPos > -1) tableName = tableName.substring(dotPos + 1);
+
+        // Strip trailing parenthesis if captured (e.g. "users(" from "ON users(email)")
+        tableName = tableName.replace(/\(.*$/, '');
+
+        tableName = tableName.toLowerCase();
+
+        if (!map[tableName]) map[tableName] = [];
+
+        // Deduplicate by index name
+        var exists = false;
+        for (var i = 0; i < map[tableName].length; i++) {
+            if (map[tableName][i].name === idxName) { exists = true; break; }
+        }
+        if (!exists) {
+            map[tableName].push({ name: idxName, primary: false });
+        }
+    }
+
+    return map;
+}
+
+
+/**
+ * extractTargetTable — extract the primary target table from a SQL statement.
+ *
+ * Handles SELECT ... FROM <table>, INSERT INTO <table>, UPDATE <table>,
+ * DELETE FROM <table>. Returns the lowercase, unquoted table name, or null
+ * if no table can be determined.
+ *
+ * For JOINs, only the first FROM target is returned (Phase A limitation —
+ * full multi-table extraction is deferred to Phase B).
+ *
+ * @param  {string} queryString  Cleaned SQL (comments already stripped)
+ * @return {string|null}         Lowercase table name, or null
+ */
+function extractTargetTable(queryString) {
+    if (!queryString) return null;
+
+    var m;
+
+    // INSERT INTO <table>
+    m = queryString.match(/\bINSERT\s+INTO\s+(\S+)/i);
+    if (m) return normaliseTableName(m[1]);
+
+    // UPDATE <table>
+    m = queryString.match(/\bUPDATE\s+(\S+)/i);
+    if (m) return normaliseTableName(m[1]);
+
+    // DELETE FROM <table>
+    m = queryString.match(/\bDELETE\s+FROM\s+(\S+)/i);
+    if (m) return normaliseTableName(m[1]);
+
+    // SELECT ... FROM <table>
+    m = queryString.match(/\bFROM\s+(\S+)/i);
+    if (m) return normaliseTableName(m[1]);
+
+    return null;
+}
+
+
+/**
+ * Unquote a SQL identifier — strips surrounding `"`, `` ` ``, or `[` `]`.
+ * @inner
+ * @param  {string} id
+ * @return {string}
+ */
+function unquoteIdentifier(id) {
+    if (!id) return id;
+    if ((id[0] === '"' && id[id.length - 1] === '"') ||
+        (id[0] === '`' && id[id.length - 1] === '`')) {
+        return id.substring(1, id.length - 1);
+    }
+    if (id[0] === '[' && id[id.length - 1] === ']') {
+        return id.substring(1, id.length - 1);
+    }
+    return id;
+}
+
+
+/**
+ * Normalise a captured table token: unquote, strip schema prefix,
+ * strip trailing punctuation, lowercase.
+ * @inner
+ * @param  {string} raw
+ * @return {string|null}
+ */
+function normaliseTableName(raw) {
+    if (!raw) return null;
+    raw = unquoteIdentifier(raw);
+    // Strip schema prefix
+    var dot = raw.lastIndexOf('.');
+    if (dot > -1) raw = raw.substring(dot + 1);
+    // Strip trailing parens, commas, semicolons
+    raw = raw.replace(/[,(;]+$/, '');
+    raw = unquoteIdentifier(raw); // unquote again after schema strip (schema."table")
+    return raw.toLowerCase() || null;
+}
+
+
+module.exports = {
+    stripComments           : stripComments,
+    extractFirstBlockComment: extractFirstBlockComment,
+    parseCreateIndexes      : parseCreateIndexes,
+    extractTargetTable      : extractTargetTable
+};

package/framework/{v0.3.1-alpha.1 → v0.3.2-alpha.1}/core/connectors/sqlite/index.js

@@ -64,6 +64,11 @@ function Sqlite(conn, infos) {
     var envIsDev    = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
     var isCacheless = (process.env.NODE_ENV_IS_DEV == 'false') ? false : true;
 
+    // #QI1 — in-memory index map built from indexes.sql at startup.
+    // Keys are lowercase table names; values are [{ name, primary }].
+    // null when no indexes.sql exists (grey N/A badge in Inspector).
+    var _knownIndexes = null;
+
     // -------------------------------------------------------------------------
     // init — load entities + SQL methods
     // -------------------------------------------------------------------------
@@ -124,6 +129,18 @@ function Sqlite(conn, infos) {
                 if ( /^\./.test(sqlEntries[s]) ) continue;
                 loadSQL(entities, conn, _(sqlDir + '/' + sqlEntries[s]));
             }
+
+            // #QI1 — load indexes.sql if present
+            var indexesFile = _(sqlDir + '/indexes.sql', true);
+            if (fs.existsSync(indexesFile)) {
+                try {
+                    var indexesSrc = fs.readFileSync(indexesFile).toString();
+                    _knownIndexes = sqlParser.parseCreateIndexes(indexesSrc);
+                } catch (e) {
+                    console.warn('[sqlite] Failed to parse indexes.sql: ' + e.message);
+                    _knownIndexes = {};
+                }
+            }
         }
 
         return entities;
@@ -297,6 +314,12 @@ function Sqlite(conn, infos) {
                     ? process.gina._queryALS.getStore() : null;
                 _devLog = _alsStore ? _alsStore._devQueryLog : null;
                 if (_devLog) {
+                    // #QI1 — resolve indexes from _knownIndexes map
+                    var _indexes = null;
+                    if (_knownIndexes !== null) {
+                        var _tbl = sqlParser.extractTargetTable(queryString);
+                        _indexes = (_tbl && _knownIndexes[_tbl]) ? _knownIndexes[_tbl] : [];
+                    }
                     _queryEntry = {
                         type        : 'SQL',
                         trigger     : entityName.toLowerCase() + '#' + name,
@@ -305,7 +328,7 @@ function Sqlite(conn, infos) {
                         durationMs  : 0,
                         resultCount : 0,
                         resultSize  : 0,
-                        indexes     : null,
+                        indexes     : _indexes,
                         error       : null,
                         source      : source || '',
                         origin      : infos.bundle,