@aroman22/codegraph-vba 1.3.4 → 1.4.0

package/README.md

@@ -386,13 +386,31 @@ The two are **sibling tools**: Dysflow owns the Access binary round-trip (sync,
 | **`Implements IFoo`** | `.cls` declares `Implements IFoo` | — | Emits an `implements` edge from the class to `IFoo` |
 | **`Dim x As Foo.Bar`** | `.bas`/`.cls` qualified type reference | — | `references` edge to `Foo` with `synthesizedBy: 'vba-name-resolution'`; silent when unresolvable |
 | **`WithEvents m_X As Form_Foo`** | `.cls` listener declaration | — | `references` edge to `Form_Foo` with `synthesizedBy: 'vba-withevents'` — closes the event-driven form flow |
+| **`Event Foo(...)` / `RaiseEvent Foo(...)`** | `.cls` custom event declaration + raise site | — | `event` node plus `raises-event` edges from the raising procedure; `WithEvents` also emits `subscribes-event` edges with the listener variable name |
+| **`Type T ... End Type`** | `.bas`/`.cls` user-defined type declaration | — | `type` node plus `type_member` child nodes linked by `type-member` edges and member type metadata |
+| **`Declare PtrSafe Function X Lib "dll"`** | `.bas`/`.cls` Win32/API declaration | — | `declare` node with DLL, alias, kind, and PtrSafe metadata; VBA call sites still emit `calls` edges to it |
+| **`Enum` / `Const` domain dictionaries** | `.bas`/`.cls` enum blocks and module constants | — | `enum`, `enum_member`, and `constant` nodes linked to their module/class; constant string values are preserved in metadata for local resolution |
+| **Saved Access QueryDefs** | `queries/<Name>.sql` | — | `query` node per Dysflow-exported `.sql` file with `references` edges to tables named by `FROM` / `JOIN` / `INTO` / `UPDATE` |
 | **`New Clase(...)`** | `.bas`/`.cls` instantiation | — | `references` edge with `synthesizedBy: 'vba-new-binding'` |
 | **SQL in VBA strings** | `.bas`/`.cls` SQL inside `DoCmd.RunSQL` / `CurrentDb.OpenRecordset` / `CurrentDb.Execute` / `db.Execute` | — | Table names extracted from `FROM`/`INTO`/`UPDATE <table>` → `references` edges with `synthesizedBy: 'vba-sql-table'` |
 
 **Hard invariants** enforced by the extractor and verified by tests:
 
 - **`.cls` is the canonical source for form code.** `.form.txt` emits **zero** `function` / `sub` / `class` nodes — only the form-level `module` node and `property` nodes per control. Dysflow overwrites `.form.txt`'s embedded code on the next import, so emitting code from there would be both wrong and ephemeral.
-- **A `.bas` with only `Public Const` declarations** (no Subs, Functions, Properties, Implements, or Dim) emits the `file` node only — no `module` / `class` per REQ-CODE-10.
+- **Option-only files stay silent.** A `.bas` containing only `Option ...` directives emits zero symbol nodes; a `.bas` with only `Enum`, `Const`, `Event`, `Type`, or `Declare` declarations DOES emit its module node because those declarations are real graph symbols.
+
+**VBA / Access node kinds added by the fork:**
+
+| Node kind | Meaning |
+|---|---|
+| `enum` / `enum_member` | VBA `Enum` block and its members |
+| `constant` | VBA `Const` declaration; string values are kept in metadata when available |
+| `query` | Dysflow-exported saved Access query (`queries/<Name>.sql`) |
+| `event` | VBA custom `Event` declaration |
+| `type` / `type_member` | VBA user-defined `Type ... End Type` and each declared member |
+| `declare` | Win32/API `Declare` / `Declare PtrSafe` statement |
+| `form-layout` | `.form.txt` / `.report.txt` form/report container |
+| `form-instance-control` | Access control instance from form/report UI text |
 
 **Scope:** Dysflow-managed projects only (Dysflow's `.form.txt` / `.report.txt` SaveAsText format). Legacy `.frm` / `.dsr` Access binary formats are not in scope.
 

package/dist/bin/node-version-check.d.ts

@@ -18,13 +18,16 @@
  */
 export declare function buildNode25BlockBanner(nodeVersion: string): string;
 /**
- * Lowest supported Node.js major version. Matches the `engines` floor in
- * package.json. Below this, CodeGraph relies on language features / native APIs
- * that aren't present, and the combination is untested. `engines` alone only
- * *warns* on install (unless the user set `engine-strict`), so the CLI bootstrap
- * also hard-blocks here to actually enforce the floor.
+ * Lowest supported Node.js version. Matches the `engines` floor in package.json.
+ * Node.js 22.5.0 is the first version with the built-in `node:sqlite` API used
+ * by CodeGraph. `engines` alone only *warns* on install (unless the user set
+ * `engine-strict`), so the CLI bootstrap also hard-blocks here to actually
+ * enforce the floor.
  */
-export declare const MIN_NODE_MAJOR = 20;
+export declare const MIN_NODE_MAJOR = 22;
+export declare const MIN_NODE_MINOR = 5;
+export declare const MIN_NODE_VERSION = "22.5";
+export declare function isBelowMinimumNodeVersion(nodeVersion: string): boolean;
 /**
  * Build the bordered banner shown when CodeGraph detects a Node.js major below
  * {@link MIN_NODE_MAJOR}. Pinned via unit test so the recovery commands and the

package/dist/db/migrations.d.ts

@@ -7,7 +7,7 @@ import { SqliteDatabase } from './sqlite-adapter';
 /**
  * Current schema version
  */
-export declare const CURRENT_SCHEMA_VERSION = 5;
+export declare const CURRENT_SCHEMA_VERSION = 6;
 /**
  * Migration definition
  */

package/dist/db/queries.d.ts

@@ -244,23 +244,11 @@ export declare class QueryBuilder {
      * Find VBA call-stub candidate nodes for `resolveVbaCallStubs` (vba-graph-
      * connectivity-fixes, #12).
      *
-     * Design deviation note: the design's `getVbaCallStubs()` was specified as
-     * `SELECT * FROM nodes WHERE ... metadata LIKE '%"stub":true%'`, mirroring
-     * the JSON-in-JS convention used elsewhere (F2). That assumes a
-     * `nodes.metadata` column — but `nodes` has NO `metadata` column (only
-     * `edges` does; see schema.sql). `Node.metadata` is genuinely never
-     * persisted anywhere in this codebase today (the pre-existing
-     * `DoCmd.OpenForm` stub's `metadata:{stub:true}` on its `form-layout`
-     * node has the same characteristic — decorative at extraction time only).
-     * Adding a nodes-wide schema column is out of scope for this targeted fix.
-     *
-     * Equivalent-semantics fix: a VBA call-stub node is, BY DEFINITION,
-     * exactly a node that is the TARGET of a `calls` edge whose OWN metadata
-     * (which DOES persist) carries `stub: true`. So this queries via a JOIN
-     * against `edges.metadata` instead of a `nodes.metadata` column — same
-     * LIKE-prefilter-then-correctness-check shape as the JSON-in-JS
-     * convention, just anchored on the table that actually stores metadata
-     * for this row type.
+     * A VBA call-stub node is, BY DEFINITION, a node targeted by a `calls`
+     * edge whose OWN metadata carries `stub: true`. Keep this anchored on
+     * `edges.metadata` even though `nodes.metadata` now exists: the stub flag
+     * is a relationship fact about an unresolved call, not an intrinsic fact
+     * about the target symbol.
      */
     getVbaCallStubs(): Node[];
     /**

package/dist/extraction/vba-extractor.d.ts

@@ -57,8 +57,6 @@ export declare class VbaExtractor {
     private createModuleOrClassNode;
     /** Sub/Function/Property regex — captures visibility prefix, kind, and name. */
     private static readonly PROC_RE;
-    /** `[visibility] Declare [PtrSafe] Sub|Function <Name> ...` DLL/API declaration. */
-    private static readonly DLL_DECLARE_RE;
     /**
      * Walk the (uncommented, line-joined) source and emit one `function` node
      * per `Sub` / `Function` / `Property` declaration. Also records the proc
@@ -66,6 +64,24 @@ export declare class VbaExtractor {
      * cross-module calls.
      */
     private sweepProcedures;
+    /** `[visibility] Event <Name>(...)` custom event declaration. */
+    private static readonly EVENT_DECL_RE;
+    /** `[visibility] Type <Name>` user-defined type block start. */
+    private static readonly TYPE_START_RE;
+    /** `End Type` user-defined type block end. */
+    private static readonly TYPE_END_RE;
+    /** `<MemberName> As <Type>` inside a user-defined type block. */
+    private static readonly TYPE_MEMBER_RE;
+    /** `[visibility] Declare [PtrSafe] Sub|Function <Name> Lib "dll" [Alias "x"] ...` */
+    private static readonly DLL_DECLARE_RE;
+    /**
+     * Roadmap #26 declaration sweep:
+     * - Event declarations become `event` nodes and `RaiseEvent` can point to them.
+     * - Type...End Type blocks become `type` + `type_member` nodes.
+     * - Win32 API Declare statements become `declare` nodes, while still being
+     *   cached by name so normal call-site scanning can emit `calls` edges.
+     */
+    private sweepEventsTypesAndDeclares;
     /** Implements regex. */
     private static readonly IMPLEMENTS_RE;
     /** Edges whose source needs to be set to the module/class id once it exists. */
@@ -253,6 +269,8 @@ export declare class VbaExtractor {
      */
     private resolveReceiverType;
     private sweepCallsAndSql;
+    private static readonly RAISE_EVENT_RE;
+    private scanRaiseEvents;
     private scanCallSites;
     /** Cache so we don't re-emit the same proc function node per call site. */
     private procNodeIdCache;
@@ -410,5 +428,7 @@ export declare class VbaExtractor {
     private localVarTypeMap;
     /** Local constant name (lowercase) → simple literal value for OpenForm resolution. */
     private localConstants;
+    /** Local event name (lowercase) → event node for `RaiseEvent` edge emission. */
+    private localEvents;
 }
 //# sourceMappingURL=vba-extractor.d.ts.map

package/dist/types.d.ts

@@ -10,12 +10,12 @@
  * of truth backs both the TS type and any runtime validation
  * (e.g. the search query parser).
  */
-export declare const NODE_KINDS: readonly ["file", "module", "class", "struct", "interface", "trait", "protocol", "function", "method", "property", "field", "variable", "constant", "enum", "enum_member", "type_alias", "namespace", "parameter", "import", "export", "route", "component", "query", "form-layout", "form-instance-control"];
+export declare const NODE_KINDS: readonly ["file", "module", "class", "struct", "interface", "trait", "protocol", "function", "method", "property", "field", "variable", "constant", "enum", "enum_member", "event", "type", "type_member", "declare", "type_alias", "namespace", "parameter", "import", "export", "route", "component", "query", "form-layout", "form-instance-control"];
 export type NodeKind = (typeof NODE_KINDS)[number];
 /**
  * Types of edges (relationships) between nodes
  */
-export type EdgeKind = 'contains' | 'calls' | 'imports' | 'exports' | 'extends' | 'implements' | 'references' | 'type_of' | 'returns' | 'instantiates' | 'overrides' | 'decorates' | 'event-handler' | 'opens-form';
+export type EdgeKind = 'contains' | 'calls' | 'imports' | 'exports' | 'extends' | 'implements' | 'references' | 'type_of' | 'returns' | 'instantiates' | 'overrides' | 'decorates' | 'event-handler' | 'opens-form' | 'raises-event' | 'subscribes-event' | 'type-member';
 /**
  * Supported programming languages. See NODE_KINDS for why this is a
  * runtime-iterable const array.

package/dist/utils/backtrace-helpers.d.ts

@@ -0,0 +1,35 @@
+import { SqliteDatabase } from '../db';
+/**
+ * VBA Handler Backtrace Helper Functions
+ */
+export interface VariableInfo {
+    name: string;
+    type: string;
+}
+/**
+ * Parses parameters from a VBA subroutine/function signature,
+ * extracting parameters of custom types (filtering out primitive types).
+ */
+export declare function parseSignatureParams(signature: string): VariableInfo[];
+/**
+ * Reconstructs a multiline SQL query string concatenated using VBA line continuation
+ * and string concatenation operators. Accumulates up to a limit of 200 characters.
+ */
+export declare function reconstructSQL(lines: string[]): string;
+export interface TraversalNode {
+    id: string;
+    name: string;
+    kind: string;
+    children: TraversalNode[];
+}
+export interface TraversalResult {
+    tree: TraversalNode | null;
+    cycle_detected: boolean;
+    warnings: string[];
+}
+/**
+ * Traverses VBA call/relationship graphs starting from a specific node ID,
+ * tracking cycles and capping search depth.
+ */
+export declare function traverseGraph(db: SqliteDatabase, startNodeId: string, maxDepth?: number): TraversalResult;
+//# sourceMappingURL=backtrace-helpers.d.ts.map

package/dist/utils/sql-impact-helpers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Interface representing the extracted bindings of a VBA form or report layout.
+ */
+export interface FormBindings {
+    recordSource?: string;
+    rowSources: Array<{
+        control: string;
+        target: string;
+    }>;
+}
+/**
+ * Interface representing the SQL lineage analysis result.
+ */
+export interface SqlLineage {
+    tables: string[];
+    lineage: Array<{
+        source: string;
+        resolved: string;
+    }>;
+}
+/**
+ * Traces references to the target query name inside a VBA module's content.
+ * Returns 1-based line numbers where references are found.
+ */
+export declare function traceVbaCallers(content: string, queryName: string): number[];
+/**
+ * Parses a VBA form definition (.form.txt/.report.txt) and extracts RecordSource and RowSource bindings.
+ */
+export declare function extractFormBindings(content: string): FormBindings;
+/**
+ * Resolves table and column aliases from a SQL string to build a column-level lineage.
+ */
+export declare function resolveSqlLineage(sql: string): SqlLineage;
+/**
+ * Runs a combined database and file-level downstream impact analysis.
+ */
+export declare function runImpactAnalysis(db: any, workspaceDir: string, queryName: string): any;
+//# sourceMappingURL=sql-impact-helpers.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aroman22/codegraph-vba",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "description": "Local-first code intelligence for AI agents (MCP). Self-contained — bundles its own runtime.",
   "bin": {
     "codegraph-vba": "npm-shim.js"
@@ -15,12 +15,12 @@
     "./package.json": "./package.json"
   },
   "optionalDependencies": {
-    "@aroman22/codegraph-vba-darwin-arm64": "1.3.4",
-    "@aroman22/codegraph-vba-darwin-x64": "1.3.4",
-    "@aroman22/codegraph-vba-linux-arm64": "1.3.4",
-    "@aroman22/codegraph-vba-linux-x64": "1.3.4",
-    "@aroman22/codegraph-vba-win32-arm64": "1.3.4",
-    "@aroman22/codegraph-vba-win32-x64": "1.3.4"
+    "@aroman22/codegraph-vba-darwin-arm64": "1.4.0",
+    "@aroman22/codegraph-vba-darwin-x64": "1.4.0",
+    "@aroman22/codegraph-vba-linux-arm64": "1.4.0",
+    "@aroman22/codegraph-vba-linux-x64": "1.4.0",
+    "@aroman22/codegraph-vba-win32-arm64": "1.4.0",
+    "@aroman22/codegraph-vba-win32-x64": "1.4.0"
   },
   "files": [
     "npm-shim.js",