dbgraph 0.1.0

package/dist/context/formatter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Schema Formatter
+ *
+ * Converts database schema objects into human-readable markdown.
+ * Used by the ContextBuilder and CLI to present schema information
+ * to LLMs and developers.
+ */
+import { TableSchema, DbSourceRecord, GraphStats, SearchResult } from '../types';
+export declare class SchemaFormatter {
+    /**
+     * Format a full table/view schema as markdown.
+     *
+     * Output structure:
+     * ```markdown
+     * ## Table: schema_name.table_name
+     * Database: alias (engine)
+     *
+     * > Table comment
+     *
+     * | Column | Type | Nullable | Default | PK | FK | Comment |
+     * |--------|------|----------|---------|----|----|---------|
+     * ...
+     *
+     * **Indexes:**
+     * - idx_name on (col1, col2) UNIQUE
+     *
+     * **Foreign Keys:**
+     * - fk_name → ref_table(ref_col) ON DELETE CASCADE
+     * ```
+     */
+    formatTableSchema(schema: TableSchema): string;
+    /**
+     * Format a high-level database overview as markdown.
+     *
+     * Output:
+     * ```markdown
+     * ## Database Overview
+     *
+     * | Database | Engine | Host | Tables | Last Indexed |
+     * |----------|--------|------|--------|-------------|
+     * | prod     | postgresql | db.example.com:5432 | 42 | 2024-01-15 |
+     *
+     * **Graph Statistics:**
+     * - Total objects: 1,234
+     * - Tables: 42
+     * - Views: 12
+     * - Columns: 856
+     * - Indexes: 98
+     * - Foreign Keys: 67
+     * ```
+     */
+    formatDatabaseOverview(dbs: DbSourceRecord[], stats: GraphStats): string;
+    /**
+     * Format search results as markdown.
+     *
+     * Output:
+     * ```markdown
+     * ## Search Results for "orders"
+     *
+     * | Score | Name | Kind | Source |
+     * |-------|------|------|--------|
+     * | 1.00 | orders | table | @prod/public |
+     * | 0.85 | order_items | table | @prod/public |
+     * | 0.72 | total_order_amount | function | @prod/public |
+     * ```
+     *
+     * @param results - Ranked search results from QueryBuilder.searchNodes
+     */
+    formatSearchResults(results: SearchResult[]): string;
+    /**
+     * Format a single column table row.
+     */
+    private _formatColumnRow;
+    /**
+     * Format a single index entry.
+     *
+     * Examples:
+     *   - idx_orders_user_id on (user_id)
+     *   - pk_orders PRIMARY KEY using btree (id)
+     */
+    private _formatIndexLine;
+    /**
+     * Format a single foreign key entry.
+     *
+     * Examples:
+     *   - fk_orders_user → users(id) ON DELETE CASCADE
+     */
+    private _formatForeignKeyLine;
+    /**
+     * Escape pipe characters so they don't break markdown table columns.
+     */
+    private _escapePipe;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/context/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/context/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,WAAW,EAIX,cAAc,EACd,UAAU,EACV,YAAY,EACb,MAAM,UAAU,CAAC;AAMlB,qBAAa,eAAe;IAK1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAsE9C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM;IAyExE;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM;IAiDpD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/context/formatter.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * Schema Formatter
+ *
+ * Converts database schema objects into human-readable markdown.
+ * Used by the ContextBuilder and CLI to present schema information
+ * to LLMs and developers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaFormatter = void 0;
+// =============================================================================
+// SchemaFormatter
+// =============================================================================
+class SchemaFormatter {
+    // ---------------------------------------------------------------------------
+    // formatTableSchema
+    // ---------------------------------------------------------------------------
+    /**
+     * Format a full table/view schema as markdown.
+     *
+     * Output structure:
+     * ```markdown
+     * ## Table: schema_name.table_name
+     * Database: alias (engine)
+     *
+     * > Table comment
+     *
+     * | Column | Type | Nullable | Default | PK | FK | Comment |
+     * |--------|------|----------|---------|----|----|---------|
+     * ...
+     *
+     * **Indexes:**
+     * - idx_name on (col1, col2) UNIQUE
+     *
+     * **Foreign Keys:**
+     * - fk_name → ref_table(ref_col) ON DELETE CASCADE
+     * ```
+     */
+    formatTableSchema(schema) {
+        const lines = [];
+        const label = schema.kind === 'view' ? 'View' : 'Table';
+        // --- Header ---
+        lines.push(`## ${label}: ${schema.qualifiedName}`);
+        lines.push('');
+        // --- Source line ---
+        // schema.source is a URI like db://@alias/schema or db://host:port/db/schema
+        const sourceDisplay = schema.source.replace(/^db:\/\//, '');
+        lines.push(`Database: ${sourceDisplay}`);
+        lines.push('');
+        // --- Comment ---
+        if (schema.comment) {
+            lines.push(`> ${schema.comment}`);
+            lines.push('');
+        }
+        // --- Column table ---
+        lines.push('| Column | Type | Nullable | Default | PK | FK | Comment |');
+        lines.push('|--------|------|----------|---------|----|----|---------|');
+        for (const col of schema.columns) {
+            lines.push(this._formatColumnRow(col, schema.foreignKeys));
+        }
+        lines.push('');
+        // --- Primary key ---
+        if (schema.primaryKey.length > 0) {
+            lines.push(`**Primary Key:** ${schema.primaryKey.join(', ')}`);
+            lines.push('');
+        }
+        // --- Indexes ---
+        if (schema.indexes.length > 0) {
+            lines.push('**Indexes:**');
+            for (const idx of schema.indexes) {
+                lines.push(this._formatIndexLine(idx));
+            }
+            lines.push('');
+        }
+        // --- Foreign Keys ---
+        if (schema.foreignKeys.length > 0) {
+            lines.push('**Foreign Keys:**');
+            for (const fk of schema.foreignKeys) {
+                lines.push(this._formatForeignKeyLine(fk));
+            }
+            lines.push('');
+        }
+        // --- View definition ---
+        if (schema.definition) {
+            lines.push('**Definition:**');
+            lines.push('');
+            lines.push('```sql');
+            lines.push(schema.definition);
+            lines.push('```');
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // formatDatabaseOverview
+    // ---------------------------------------------------------------------------
+    /**
+     * Format a high-level database overview as markdown.
+     *
+     * Output:
+     * ```markdown
+     * ## Database Overview
+     *
+     * | Database | Engine | Host | Tables | Last Indexed |
+     * |----------|--------|------|--------|-------------|
+     * | prod     | postgresql | db.example.com:5432 | 42 | 2024-01-15 |
+     *
+     * **Graph Statistics:**
+     * - Total objects: 1,234
+     * - Tables: 42
+     * - Views: 12
+     * - Columns: 856
+     * - Indexes: 98
+     * - Foreign Keys: 67
+     * ```
+     */
+    formatDatabaseOverview(dbs, stats) {
+        const lines = [];
+        lines.push('## Database Overview');
+        lines.push('');
+        if (dbs.length === 0) {
+            lines.push('*No databases indexed.*');
+            lines.push('');
+            return lines.join('\n');
+        }
+        // --- Database table ---
+        lines.push('| Alias | Engine | Host | Objects | Last Indexed |');
+        lines.push('|-------|--------|------|---------|-------------|');
+        for (const db of dbs) {
+            const host = db.host ? (db.port ? `${db.host}:${db.port}` : db.host) : '—';
+            const indexed = db.indexedAt
+                ? new Date(db.indexedAt).toISOString().slice(0, 10)
+                : '—';
+            lines.push(`| ${db.alias} | ${db.engine} | ${host} | ${db.nodeCount.toLocaleString()} | ${indexed} |`);
+        }
+        lines.push('');
+        // --- Graph statistics ---
+        lines.push('**Graph Statistics:**');
+        lines.push('');
+        const kindLabels = {
+            table: 'Tables',
+            view: 'Views',
+            column: 'Columns',
+            index: 'Indexes',
+            foreign_key: 'Foreign Keys',
+            constraint: 'Constraints',
+            trigger: 'Triggers',
+            stored_procedure: 'Stored Procedures',
+            function: 'Functions',
+            sequence: 'Sequences',
+            schema: 'Schemas',
+            database: 'Databases',
+        };
+        lines.push(`- Total objects: ${stats.nodeCount.toLocaleString()}`);
+        lines.push(`- Total relationships: ${stats.edgeCount.toLocaleString()}`);
+        for (const [kind, count] of Object.entries(stats.nodesByKind)) {
+            if (count > 0) {
+                const label = kindLabels[kind] ?? `${kind}s`;
+                lines.push(`- ${label}: ${count.toLocaleString()}`);
+            }
+        }
+        lines.push('');
+        if (stats.dbSizeBytes > 0) {
+            const size = stats.dbSizeBytes > 1_048_576
+                ? `${(stats.dbSizeBytes / 1_048_576).toFixed(1)} MB`
+                : `${(stats.dbSizeBytes / 1024).toFixed(1)} KB`;
+            lines.push(`Database file size: ${size}`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // formatSearchResults
+    // ---------------------------------------------------------------------------
+    /**
+     * Format search results as markdown.
+     *
+     * Output:
+     * ```markdown
+     * ## Search Results for "orders"
+     *
+     * | Score | Name | Kind | Source |
+     * |-------|------|------|--------|
+     * | 1.00 | orders | table | @prod/public |
+     * | 0.85 | order_items | table | @prod/public |
+     * | 0.72 | total_order_amount | function | @prod/public |
+     * ```
+     *
+     * @param results - Ranked search results from QueryBuilder.searchNodes
+     */
+    formatSearchResults(results) {
+        const lines = [];
+        if (results.length === 0) {
+            lines.push('*No results found.*');
+            lines.push('');
+            return lines.join('\n');
+        }
+        lines.push('| Score | Name | Kind | Qualified Name |');
+        lines.push('|-------|------|------|----------------|');
+        for (const r of results) {
+            const scoreStr = r.score.toFixed(2);
+            const name = r.node.name;
+            const kind = r.node.kind;
+            const qn = r.node.qualifiedName;
+            lines.push(`| ${scoreStr} | ${name} | ${kind} | \`${qn}\` |`);
+        }
+        lines.push('');
+        // Append highlights if present
+        let hasHighlights = false;
+        for (const r of results) {
+            if (r.highlights && r.highlights.length > 0) {
+                hasHighlights = true;
+                break;
+            }
+        }
+        if (hasHighlights) {
+            lines.push('**Matches:**');
+            lines.push('');
+            for (const r of results) {
+                if (r.highlights && r.highlights.length > 0) {
+                    lines.push(`- \`${r.node.name}\`: ${r.highlights.join('; ')}`);
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Format a single column table row.
+     */
+    _formatColumnRow(col, foreignKeys) {
+        const nullable = col.isNullable ? 'YES' : 'NO';
+        const defaultVal = col.defaultValue ?? '';
+        const pk = col.isPrimaryKey ? 'PK' : '';
+        // Find FK that this column participates in
+        const fk = foreignKeys.find((fk) => fk.columns.includes(col.name));
+        const fkDisplay = fk
+            ? `${fk.referencedTable}(${fk.referencedColumns.join(',')})`
+            : '';
+        const comment = col.comment ?? '';
+        // Escape pipe characters in values
+        const safeType = this._escapePipe(col.dataType);
+        return `| ${col.name} | ${safeType} | ${nullable} | ${defaultVal} | ${pk} | ${fkDisplay} | ${comment} |`;
+    }
+    /**
+     * Format a single index entry.
+     *
+     * Examples:
+     *   - idx_orders_user_id on (user_id)
+     *   - pk_orders PRIMARY KEY using btree (id)
+     */
+    _formatIndexLine(idx) {
+        const cols = idx.columns.join(', ');
+        if (idx.primary) {
+            const method = idx.method ?? 'btree';
+            return `- ${idx.name} PRIMARY KEY using ${method} (${cols})`;
+        }
+        const unique = idx.unique ? ' UNIQUE' : '';
+        return `- ${idx.name} on (${cols})${unique}`;
+    }
+    /**
+     * Format a single foreign key entry.
+     *
+     * Examples:
+     *   - fk_orders_user → users(id) ON DELETE CASCADE
+     */
+    _formatForeignKeyLine(fk) {
+        const cols = fk.columns.join(', ');
+        const refs = `${fk.referencedTable}(${fk.referencedColumns.join(', ')})`;
+        const parts = [`- ${fk.constraintName} → ${refs}`];
+        if (fk.onDelete)
+            parts.push(`ON DELETE ${fk.onDelete.toUpperCase()}`);
+        if (fk.onUpdate)
+            parts.push(`ON UPDATE ${fk.onUpdate.toUpperCase()}`);
+        return parts.join(' ');
+    }
+    /**
+     * Escape pipe characters so they don't break markdown table columns.
+     */
+    _escapePipe(value) {
+        return value.replace(/\|/g, '\\|');
+    }
+}
+exports.SchemaFormatter = SchemaFormatter;
+//# sourceMappingURL=formatter.js.map

package/dist/context/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/context/formatter.ts"],"names":[],"mappings":"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"}

package/dist/context/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Context Builder
+ *
+ * Builds rich schema context from the database knowledge graph.
+ * Composes table schemas, relationship chains, and formats them
+ * as markdown for LLM consumption.
+ */
+import { QueryBuilder } from '../db/queries';
+import { GraphTraverser } from '../graph/traversal';
+import { TableSchema } from '../types';
+export declare class ContextBuilder {
+    private readonly projectRoot;
+    private readonly queries;
+    private readonly traverser;
+    /**
+     * @param projectRoot - Root path of the project (used for resolving .dbgraph/)
+     * @param queries     - QueryBuilder instance for raw lookups
+     * @param traverser   - GraphTraverser instance for BFS / ancestor / child queries
+     */
+    constructor(projectRoot: string, queries: QueryBuilder, traverser: GraphTraverser);
+    /**
+     * Build a complete TableSchema description from the graph.
+     *
+     * Resolution steps:
+     *  1. Fetch the table / view node.
+     *  2. Fetch child nodes via `contains` edges — separate columns from indexes.
+     *  3. Identify primary-key columns via `primary_key` edges.
+     *  4. Identify foreign-key columns via `references` edges on each column.
+     *  5. Collect index metadata from child index nodes.
+     *  6. Collect FK constraints via `foreign_key` edges and incoming `references`.
+     *  7. Assemble and return a TableSchema.
+     *
+     * @param nodeId - The graph node ID of the table or view.
+     */
+    getTableSchema(nodeId: string): Promise<TableSchema>;
+    /**
+     * Build a markdown context string for a table or view.
+     *
+     * Accepts either:
+     *  - A graph node ID (exact `id` lookup)
+     *  - A qualified or simple name (searched via `searchNodes`)
+     *
+     * The output includes:
+     *  - Full table schema (columns, PKs, FKs, indexes)
+     *  - Parent hierarchy (database → schema → table)
+     *  - Tables that reference this table (incoming FK relationships)
+     *
+     * @param tableNameOrId - Table name, qualified name, or graph node ID.
+     */
+    buildContext(tableNameOrId: string): Promise<string>;
+    /**
+     * Extract the parent table ID for a column node by tracing its incoming
+     * `contains` edge.
+     */
+    private _parentTableId;
+    /**
+     * Resolve the data type for a column node.
+     * Priority: metadata.dataType → parse from signature → "unknown".
+     */
+    private _columnDataType;
+    /**
+     * Determine whether a column is nullable.
+     * Priority: metadata.isNullable → parse from signature → true.
+     */
+    private _columnIsNullable;
+    /**
+     * Extract default value for a column.
+     * Priority: metadata.defaultValue → parse from signature.
+     */
+    private _columnDefault;
+    /**
+     * Derive which columns an index covers by looking at the index node's
+     * metadata or its `indexed_by` edges to column nodes.
+     */
+    private _getIndexedColumnNames;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAIL,WAAW,EAIZ,MAAM,UAAU,CAAC;AAMlB,qBAAa,cAAc;IAOvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B;;;;OAIG;gBAEgB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc;IAO5C;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsM1D;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoL1D;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAe/B"}