@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,qDAAqD;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,6BAA6B;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwB;IAExB,OAAO;QACL,iBAAiB;QACjB,oBAAoB,CAAC,OAAO,CAAC;QAC7B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,sBAAsB,CAAC,OAAO,CAAC;QAC/B,mBAAmB,CAAC,OAAO,CAAC;QAC5B,sBAAsB,CAAC,OAAO,CAAC;QAC/B,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB;QACrB,0BAA0B,CAAC,OAAO,CAAC;QACnC,yBAAyB,CAAC,OAAO,CAAC;QAClC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,wBAAwB,CAAC,OAAO,CAAC;QACjC,qBAAqB,CAAC,OAAO,CAAC;QAC9B,yBAAyB,CAAC,OAAO,CAAC;QAClC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,mBAAmB,CAAC,OAAO,CAAC;QAC5B,6BAA6B;QAC7B,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,oBAAoB,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/adapters/postgresql/resources/indexes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Indexes Resource
+ *
+ * Index usage statistics with unused/rarely-used detection and DROP recommendations.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createIndexesResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=indexes.d.ts.map

package/dist/adapters/postgresql/resources/indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/indexes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAmCjC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CAqJpB"}

package/dist/adapters/postgresql/resources/indexes.js

@@ -0,0 +1,130 @@
+/**
+ * Indexes Resource
+ *
+ * Index usage statistics with unused/rarely-used detection and DROP recommendations.
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createIndexesResource(adapter) {
+    return {
+        uri: "postgres://indexes",
+        name: "Index Statistics",
+        description: "Index usage statistics with unused/rarely-used detection and DROP recommendations",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            // Get index usage statistics including last scan time and table row count
+            const indexResult = await adapter.executeQuery(`
+                SELECT
+                    sui.schemaname,
+                    sui.relname as tablename,
+                    sui.indexrelname as indexname,
+                    sui.idx_scan as index_scans,
+                    sui.idx_tup_read as tuples_read,
+                    sui.idx_tup_fetch as tuples_fetched,
+                    pg_size_pretty(pg_relation_size(sui.indexrelid)) as index_size,
+                    pg_relation_size(sui.indexrelid) as size_bytes,
+                    sui.last_idx_scan,
+                    (sui.idx_scan = 0 AND sui.last_idx_scan IS NULL) as potentially_new,
+                    COALESCE(sut.n_live_tup, 0) as table_rows
+                FROM pg_stat_user_indexes sui
+                LEFT JOIN pg_stat_user_tables sut ON sui.relid = sut.relid
+                WHERE sui.schemaname NOT IN ('pg_catalog', 'information_schema')
+                ORDER BY sui.idx_scan ASC, pg_relation_size(sui.indexrelid) DESC
+                LIMIT 50
+            `);
+            const indexes = (indexResult.rows ?? []);
+            // Separate indexes by status with improved categorization
+            // Empty table indexes: 0 scans because table has no data
+            const emptyTableIndexes = indexes.filter((idx) => idx.index_scans === 0 && idx.table_rows === 0);
+            // Potentially new: 0 scans, table has data, no scan history
+            const potentiallyNewIndexes = indexes.filter((idx) => idx.index_scans === 0 && idx.potentially_new && idx.table_rows > 0);
+            // Truly unused: 0 scans, table has data, has scan history (was used before)
+            const trulyUnusedIndexes = indexes.filter((idx) => idx.index_scans === 0 &&
+                !idx.potentially_new &&
+                idx.table_rows > 0 &&
+                idx.size_bytes > 1024 * 1024);
+            const rarelyUsed = indexes.filter((idx) => idx.index_scans > 0 &&
+                idx.index_scans < 100 &&
+                idx.size_bytes > 10 * 1024 * 1024);
+            // Generate recommendations
+            const recommendations = [];
+            // Include indexes on empty tables as info
+            for (const idx of emptyTableIndexes.slice(0, 3)) {
+                recommendations.push({
+                    type: "EMPTY_TABLE",
+                    priority: "INFO",
+                    index: idx.schemaname + "." + idx.indexname,
+                    table: idx.tablename,
+                    size: idx.index_size,
+                    scans: idx.index_scans,
+                    tableRows: idx.table_rows,
+                    message: "Index has 0 scans because table is empty. Will be used when data is inserted.",
+                });
+            }
+            // Include recently created indexes as info only
+            for (const idx of potentiallyNewIndexes.slice(0, 3)) {
+                recommendations.push({
+                    type: "RECENTLY_CREATED",
+                    priority: "LOW",
+                    index: idx.schemaname + "." + idx.indexname,
+                    table: idx.tablename,
+                    size: idx.index_size,
+                    scans: idx.index_scans,
+                    tableRows: idx.table_rows,
+                    message: `Index has 0 scans on active table (${String(idx.table_rows)} rows). May be newly created or for rarely-run queries.`,
+                });
+            }
+            for (const idx of trulyUnusedIndexes.slice(0, 5)) {
+                recommendations.push({
+                    type: "UNUSED_INDEX",
+                    priority: "HIGH",
+                    index: idx.schemaname + "." + idx.indexname,
+                    table: idx.tablename,
+                    size: idx.index_size,
+                    scans: idx.index_scans,
+                    action: "DROP INDEX IF EXISTS " +
+                        idx.schemaname +
+                        "." +
+                        idx.indexname +
+                        ";",
+                    benefit: "Reclaim " + idx.index_size + " and reduce write overhead",
+                });
+            }
+            for (const idx of rarelyUsed.slice(0, 3)) {
+                recommendations.push({
+                    type: "RARELY_USED",
+                    priority: "MEDIUM",
+                    index: idx.schemaname + "." + idx.indexname,
+                    table: idx.tablename,
+                    size: idx.index_size,
+                    scans: idx.index_scans,
+                    action: "-- Review before dropping: " +
+                        idx.schemaname +
+                        "." +
+                        idx.indexname,
+                    benefit: idx.index_scans.toString() +
+                        " scans for " +
+                        idx.index_size +
+                        " index",
+                });
+            }
+            if (recommendations.length === 0) {
+                recommendations.push({
+                    type: "HEALTHY",
+                    message: "No obvious index optimization opportunities found",
+                });
+            }
+            return {
+                totalIndexes: indexes.length,
+                emptyTableIndexes: emptyTableIndexes.length,
+                potentiallyNewIndexes: potentiallyNewIndexes.length,
+                unusedIndexes: trulyUnusedIndexes.length,
+                rarelyUsedIndexes: rarelyUsed.length,
+                indexDetails: indexes.slice(0, 20),
+                recommendations,
+                summary: `Analyzed ${indexes.length.toString()} indexes. Found ${trulyUnusedIndexes.length.toString()} unused on active tables, ${emptyTableIndexes.length.toString()} on empty tables, ${potentiallyNewIndexes.length.toString()} potentially new, and ${rarelyUsed.length.toString()} rarely-used.`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=indexes.js.map

package/dist/adapters/postgresql/resources/indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/indexes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAkCxE,MAAM,UAAU,qBAAqB,CACnC,OAAwB;IAExB,OAAO;QACL,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,mFAAmF;QACrF,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,QAAwB,EAAE,EAAE;YACxD,0EAA0E;YAC1E,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;;;aAkBxC,CAAC,CAAC;YACT,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAA0B,CAAC;YAElE,0DAA0D;YAC1D,yDAAyD;YACzD,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CACtC,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,CACjE,CAAC;YAEF,4DAA4D;YAC5D,MAAM,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAC1C,CAAC,GAAa,EAAE,EAAE,CAChB,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CACrE,CAAC;YAEF,4EAA4E;YAC5E,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CACvC,CAAC,GAAa,EAAE,EAAE,CAChB,GAAG,CAAC,WAAW,KAAK,CAAC;gBACrB,CAAC,GAAG,CAAC,eAAe;gBACpB,GAAG,CAAC,UAAU,GAAG,CAAC;gBAClB,GAAG,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI,CAC/B,CAAC;YAEF,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAC/B,CAAC,GAAa,EAAE,EAAE,CAChB,GAAG,CAAC,WAAW,GAAG,CAAC;gBACnB,GAAG,CAAC,WAAW,GAAG,GAAG;gBACrB,GAAG,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CACpC,CAAC;YAEF,2BAA2B;YAC3B,MAAM,eAAe,GAA0B,EAAE,CAAC;YAElD,0CAA0C;YAC1C,KAAK,MAAM,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAChD,eAAe,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,MAAM;oBAChB,KAAK,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS;oBAC3C,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,UAAU;oBACpB,KAAK,EAAE,GAAG,CAAC,WAAW;oBACtB,SAAS,EAAE,GAAG,CAAC,UAAU;oBACzB,OAAO,EACL,+EAA+E;iBAClF,CAAC,CAAC;YACL,CAAC;YAED,gDAAgD;YAChD,KAAK,MAAM,GAAG,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACpD,eAAe,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,kBAAkB;oBACxB,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS;oBAC3C,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,UAAU;oBACpB,KAAK,EAAE,GAAG,CAAC,WAAW;oBACtB,SAAS,EAAE,GAAG,CAAC,UAAU;oBACzB,OAAO,EAAE,sCAAsC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,yDAAyD;iBAC/H,CAAC,CAAC;YACL,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjD,eAAe,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,MAAM;oBAChB,KAAK,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS;oBAC3C,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,UAAU;oBACpB,KAAK,EAAE,GAAG,CAAC,WAAW;oBACtB,MAAM,EACJ,uBAAuB;wBACvB,GAAG,CAAC,UAAU;wBACd,GAAG;wBACH,GAAG,CAAC,SAAS;wBACb,GAAG;oBACL,OAAO,EAAE,UAAU,GAAG,GAAG,CAAC,UAAU,GAAG,4BAA4B;iBACpE,CAAC,CAAC;YACL,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzC,eAAe,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS;oBAC3C,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,IAAI,EAAE,GAAG,CAAC,UAAU;oBACpB,KAAK,EAAE,GAAG,CAAC,WAAW;oBACtB,MAAM,EACJ,6BAA6B;wBAC7B,GAAG,CAAC,UAAU;wBACd,GAAG;wBACH,GAAG,CAAC,SAAS;oBACf,OAAO,EACL,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE;wBAC1B,aAAa;wBACb,GAAG,CAAC,UAAU;wBACd,QAAQ;iBACX,CAAC,CAAC;YACL,CAAC;YAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,eAAe,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,mDAAmD;iBAC7D,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,iBAAiB,EAAE,iBAAiB,CAAC,MAAM;gBAC3C,qBAAqB,EAAE,qBAAqB,CAAC,MAAM;gBACnD,aAAa,EAAE,kBAAkB,CAAC,MAAM;gBACxC,iBAAiB,EAAE,UAAU,CAAC,MAAM;gBACpC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClC,eAAe;gBACf,OAAO,EAAE,YAAY,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,6BAA6B,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,qBAAqB,qBAAqB,CAAC,MAAM,CAAC,QAAQ,EAAE,yBAAyB,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe;aACtS,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/postgresql/resources/kcache.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pg_stat_kcache Status Resource
+ *
+ * Provides pg_stat_kcache OS-level performance metrics summary.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createKcacheResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=kcache.d.ts.map

package/dist/adapters/postgresql/resources/kcache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kcache.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/kcache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAmFlE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA0PpB"}

package/dist/adapters/postgresql/resources/kcache.js

@@ -0,0 +1,219 @@
+/**
+ * pg_stat_kcache Status Resource
+ *
+ * Provides pg_stat_kcache OS-level performance metrics summary.
+ */
+import { LOW_PRIORITY } from "../../../utils/resourceAnnotations.js";
+/** Safely convert unknown value to string */
+function toStr(value) {
+    return typeof value === "string" ? value : "";
+}
+async function getKcacheColumnNames(adapter) {
+    const result = await adapter.executeQuery(`
+        SELECT column_name FROM information_schema.columns 
+        WHERE table_name = 'pg_stat_kcache' AND column_name = 'exec_user_time'
+    `);
+    const isNewVersion = (result.rows?.length ?? 0) > 0;
+    if (isNewVersion) {
+        return {
+            userTime: "exec_user_time",
+            systemTime: "exec_system_time",
+            reads: "exec_reads",
+            writes: "exec_writes",
+        };
+    }
+    return {
+        userTime: "user_time",
+        systemTime: "system_time",
+        reads: "reads",
+        writes: "writes",
+    };
+}
+export function createKcacheResource(adapter) {
+    return {
+        uri: "postgres://kcache",
+        name: "pg_stat_kcache Status",
+        description: "pg_stat_kcache OS-level CPU and I/O performance metrics summary",
+        mimeType: "application/json",
+        annotations: LOW_PRIORITY,
+        handler: async () => {
+            const result = {
+                extensionInstalled: false,
+                extensionVersion: null,
+                pgStatStatementsInstalled: false,
+                summary: {
+                    totalQueries: 0,
+                    totalCpuTime: 0,
+                    totalReads: 0,
+                    totalWrites: 0,
+                },
+                topCpuQueries: [],
+                topIoQueries: [],
+                resourceClassification: {
+                    cpuBound: 0,
+                    ioBound: 0,
+                    balanced: 0,
+                },
+                recommendations: [],
+            };
+            // Check for pg_stat_statements first (required) - outside try-catch for correct error messaging
+            const stmtCheck = await adapter.executeQuery(`SELECT extversion FROM pg_extension WHERE extname = 'pg_stat_statements'`);
+            result.pgStatStatementsInstalled = (stmtCheck.rows?.length ?? 0) > 0;
+            // Check if pg_stat_kcache is installed
+            const extCheck = await adapter.executeQuery(`SELECT extversion FROM pg_extension WHERE extname = 'pg_stat_kcache'`);
+            if (!extCheck.rows || extCheck.rows.length === 0) {
+                result.recommendations.push("pg_stat_kcache extension is not installed. Use pg_kcache_create_extension to enable OS-level performance monitoring.");
+                if (!result.pgStatStatementsInstalled) {
+                    result.recommendations.push("pg_stat_statements is also required and not installed.");
+                }
+                return JSON.stringify(result, null, 2);
+            }
+            result.extensionInstalled = true;
+            const extVersion = extCheck.rows[0]?.["extversion"];
+            result.extensionVersion =
+                typeof extVersion === "string" ? extVersion : null;
+            if (!result.pgStatStatementsInstalled) {
+                result.recommendations.push("pg_stat_statements is required but not installed. pg_stat_kcache will not function properly.");
+                return JSON.stringify(result, null, 2);
+            }
+            try {
+                // Get version-aware column names
+                const cols = await getKcacheColumnNames(adapter);
+                // Get summary statistics using the FUNCTION (not the VIEW)
+                const summaryResult = await adapter.executeQuery(`SELECT 
+                        COUNT(*)::int as total_queries,
+                        COALESCE(SUM(${cols.userTime} + ${cols.systemTime}), 0)::float as total_cpu,
+                        COALESCE(SUM(${cols.reads}), 0)::bigint as total_reads,
+                        COALESCE(SUM(${cols.writes}), 0)::bigint as total_writes
+                     FROM pg_stat_kcache()`);
+                if (summaryResult.rows && summaryResult.rows.length > 0) {
+                    const row = summaryResult.rows[0];
+                    result.summary.totalQueries = Number(row?.["total_queries"] ?? 0);
+                    result.summary.totalCpuTime = Number(row?.["total_cpu"] ?? 0);
+                    result.summary.totalReads = Number(row?.["total_reads"] ?? 0);
+                    result.summary.totalWrites = Number(row?.["total_writes"] ?? 0);
+                }
+                // Get top CPU-consuming queries using FUNCTION
+                const cpuResult = await adapter.executeQuery(`SELECT 
+                        substring(s.query, 1, 100) as query,
+                        s.calls::int,
+                        round((k.${cols.userTime} + k.${cols.systemTime})::numeric, 3) as cpu_time,
+                        round(((k.${cols.userTime} + k.${cols.systemTime}) / NULLIF(s.calls, 0))::numeric, 6) as cpu_per_call
+                     FROM pg_stat_kcache() k
+                     JOIN pg_stat_statements s ON k.queryid = s.queryid AND k.dbid = s.dbid AND k.userid = s.userid
+                     WHERE s.calls > 0
+                     ORDER BY (k.${cols.userTime} + k.${cols.systemTime}) DESC
+                     LIMIT 5`);
+                if (cpuResult.rows) {
+                    for (const row of cpuResult.rows) {
+                        result.topCpuQueries.push({
+                            queryPreview: toStr(row["query"]),
+                            calls: Number(row["calls"] ?? 0),
+                            cpuTimeSeconds: Number(row["cpu_time"] ?? 0),
+                            cpuPerCall: Number(row["cpu_per_call"] ?? 0),
+                        });
+                    }
+                }
+                // Get top I/O-consuming queries using FUNCTION
+                const ioResult = await adapter.executeQuery(`SELECT 
+                        substring(s.query, 1, 100) as query,
+                        s.calls::int,
+                        k.${cols.reads}::bigint as reads,
+                        k.${cols.writes}::bigint as writes
+                     FROM pg_stat_kcache() k
+                     JOIN pg_stat_statements s ON k.queryid = s.queryid AND k.dbid = s.dbid AND k.userid = s.userid
+                     WHERE s.calls > 0
+                     ORDER BY k.${cols.reads} DESC
+                     LIMIT 5`);
+                if (ioResult.rows) {
+                    for (const row of ioResult.rows) {
+                        result.topIoQueries.push({
+                            queryPreview: toStr(row["query"]),
+                            calls: Number(row["calls"] ?? 0),
+                            readsBytes: Number(row["reads"] ?? 0),
+                            writesBytes: Number(row["writes"] ?? 0),
+                        });
+                    }
+                }
+                // Resource classification using FUNCTION
+                const classResult = await adapter.executeQuery(`WITH metrics AS (
+                        SELECT 
+                            queryid,
+                            (${cols.userTime} + ${cols.systemTime}) as cpu_time,
+                            ${cols.reads} + ${cols.writes} as io_bytes
+                        FROM pg_stat_kcache()
+                        WHERE ${cols.userTime} + ${cols.systemTime} > 0 OR ${cols.reads} + ${cols.writes} > 0
+                    )
+                    SELECT 
+                        CASE 
+                            WHEN cpu_time > io_bytes / 1000000.0 * 2 THEN 'cpu_bound'
+                            WHEN io_bytes / 1000000.0 > cpu_time * 2 THEN 'io_bound'
+                            ELSE 'balanced'
+                        END as classification,
+                        COUNT(*)::int as count
+                    FROM metrics
+                    GROUP BY 1`);
+                if (classResult.rows) {
+                    for (const row of classResult.rows) {
+                        const classification = toStr(row["classification"]);
+                        const count = Number(row["count"] ?? 0);
+                        if (classification === "cpu_bound") {
+                            result.resourceClassification.cpuBound = count;
+                        }
+                        else if (classification === "io_bound") {
+                            result.resourceClassification.ioBound = count;
+                        }
+                        else {
+                            result.resourceClassification.balanced = count;
+                        }
+                    }
+                }
+                // Generate recommendations
+                if (result.summary.totalQueries === 0) {
+                    result.recommendations.push("No query statistics collected yet. Run some queries and check again.");
+                }
+                else if (result.summary.totalReads === 0 &&
+                    result.summary.totalWrites === 0 &&
+                    result.summary.totalCpuTime === 0) {
+                    result.recommendations.push("All pg_stat_kcache metrics are zero. Possible causes: (1) No query activity since last reset, (2) pg_stat_kcache not in shared_preload_libraries (requires server restart), (3) Stats recently reset with pg_stat_kcache_reset(). Check postgresql.conf for: shared_preload_libraries = 'pg_stat_statements,pg_stat_kcache'");
+                }
+                // Generate recommendations based on workload classification
+                // Only provide classification recommendations when there's meaningful activity
+                const totalClassified = result.resourceClassification.cpuBound +
+                    result.resourceClassification.ioBound +
+                    result.resourceClassification.balanced;
+                const hasSignificantActivity = totalClassified >= 5 && result.summary.totalCpuTime >= 0.1;
+                if (!hasSignificantActivity && totalClassified > 0) {
+                    result.recommendations.push("Insufficient query activity for meaningful workload classification. Run more queries to gather accurate metrics.");
+                }
+                else if (result.resourceClassification.cpuBound >
+                    result.resourceClassification.ioBound * 2) {
+                    result.recommendations.push("Workload is heavily CPU-bound. Consider optimizing complex calculations or using materialized views.");
+                }
+                if (hasSignificantActivity &&
+                    result.resourceClassification.ioBound >
+                        result.resourceClassification.cpuBound * 2) {
+                    result.recommendations.push("Workload is heavily I/O-bound. Review indexes and consider increasing shared_buffers.");
+                }
+                if (result.topCpuQueries.length > 0 &&
+                    result.topCpuQueries[0] !== undefined &&
+                    result.topCpuQueries[0].cpuTimeSeconds > 100) {
+                    result.recommendations.push("Some queries have very high CPU time. Use pg_kcache_top_cpu for detailed analysis.");
+                }
+                // Add classification thresholds explanation
+                result.classificationThresholds = {
+                    formula: "Compares (user_time + system_time) vs (reads + writes in MB). cpu_time > io_MB * 2 = CPU-bound; io_MB > cpu_time * 2 = I/O-bound; else balanced.",
+                    cpuBound: "Query spends 2x more time on CPU than on I/O operations. Optimize calculations, use materialized views, or simplify queries.",
+                    ioBound: "Query spends 2x more time on I/O than CPU. Add indexes, increase shared_buffers, or optimize disk access patterns.",
+                    balanced: "Query has relatively equal CPU and I/O usage. Standard optimization techniques apply.",
+                };
+            }
+            catch {
+                // Extension is installed but data queries failed
+                result.recommendations.push("Error querying pg_stat_kcache data. Check permissions on pg_stat_kcache() function.");
+            }
+            return JSON.stringify(result, null, 2);
+        },
+    };
+}
+//# sourceMappingURL=kcache.js.map

package/dist/adapters/postgresql/resources/kcache.js.map

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

package/dist/adapters/postgresql/resources/locks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Locks Resource
+ *
+ * Lock contention detection and blocking query identification.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createLocksResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=locks.d.ts.map

package/dist/adapters/postgresql/resources/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/locks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAyBjC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA8FpB"}

package/dist/adapters/postgresql/resources/locks.js

@@ -0,0 +1,89 @@
+/**
+ * Locks Resource
+ *
+ * Lock contention detection and blocking query identification.
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createLocksResource(adapter) {
+    return {
+        uri: "postgres://locks",
+        name: "Lock Information",
+        description: "Current lock information with contention detection",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            // Get lock information
+            const locksResult = await adapter.executeQuery(`
+                SELECT
+                    l.locktype,
+                    l.mode,
+                    l.granted,
+                    l.pid,
+                    a.usename,
+                    a.application_name,
+                    a.client_addr::text as client_addr,
+                    a.state,
+                    a.wait_event_type,
+                    a.wait_event,
+                    COALESCE(r.relname, l.relation::text) as relation,
+                    LEFT(a.query, 100) as query_preview,
+                    EXTRACT(EPOCH FROM age(now(), a.query_start)) as query_duration_seconds
+                FROM pg_locks l
+                LEFT JOIN pg_stat_activity a ON l.pid = a.pid
+                LEFT JOIN pg_class r ON l.relation = r.oid
+                WHERE l.pid != pg_backend_pid()
+                ORDER BY l.granted, a.query_start NULLS LAST
+                LIMIT 50
+            `);
+            const locks = (locksResult.rows ?? []);
+            // Get active session count for context
+            const sessionResult = await adapter.executeQuery(`
+                SELECT COUNT(*) as count FROM pg_stat_activity 
+                WHERE pid != pg_backend_pid() 
+                  AND state = 'active'
+            `);
+            const activeSessions = Number(sessionResult.rows?.[0]?.["count"] ?? 0);
+            // Analyze locks
+            const blockingLocks = locks.filter((lock) => !lock.granted);
+            const activeLocks = locks.filter((lock) => lock.granted);
+            // Generate warnings
+            const warnings = [];
+            if (blockingLocks.length > 0) {
+                warnings.push({
+                    severity: "HIGH",
+                    message: blockingLocks.length.toString() + " blocked queries detected",
+                    recommendation: "Review blocking queries and consider terminating long-running transactions",
+                });
+            }
+            if (locks.length > 100) {
+                warnings.push({
+                    severity: "MEDIUM",
+                    message: "High number of locks (" +
+                        locks.length.toString() +
+                        ") - showing top 50",
+                    recommendation: "May indicate lock contention or long-running transactions",
+                });
+            }
+            if (warnings.length === 0) {
+                warnings.push({
+                    severity: "INFO",
+                    message: "No lock contention detected",
+                });
+            }
+            // Generate summary message
+            const summary = locks.length === 0
+                ? `No locks detected. ${String(activeSessions)} active sessions. Empty result is normal when queries complete quickly.`
+                : `${String(locks.length)} locks held by ${String(new Set(locks.map((l) => l.pid)).size)} processes. ${String(activeSessions)} active sessions.`;
+            return {
+                totalLocks: locks.length,
+                activeLocks: activeLocks.length,
+                blockingLocks: blockingLocks.length,
+                activeSessions,
+                lockDetails: locks,
+                warnings,
+                summary,
+            };
+        },
+    };
+}
+//# sourceMappingURL=locks.js.map

package/dist/adapters/postgresql/resources/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/locks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAwBxE,MAAM,UAAU,mBAAmB,CACjC,OAAwB;IAExB,OAAO;QACL,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,QAAwB,EAAE,EAAE;YACxD,uBAAuB;YACvB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;aAqBxC,CAAC,CAAC;YACT,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAyB,CAAC;YAE/D,uCAAuC;YACvC,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;aAI1C,CAAC,CAAC;YACT,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAEvE,gBAAgB;YAChB,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAElE,oBAAoB;YACpB,MAAM,QAAQ,GAAkB,EAAE,CAAC;YAEnC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM;oBAChB,OAAO,EACL,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,2BAA2B;oBAC/D,cAAc,EACZ,4EAA4E;iBAC/E,CAAC,CAAC;YACL,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,QAAQ;oBAClB,OAAO,EACL,wBAAwB;wBACxB,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;wBACvB,oBAAoB;oBACtB,cAAc,EACZ,2DAA2D;iBAC9D,CAAC,CAAC;YACL,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,6BAA6B;iBACvC,CAAC,CAAC;YACL,CAAC;YAED,2BAA2B;YAC3B,MAAM,OAAO,GACX,KAAK,CAAC,MAAM,KAAK,CAAC;gBAChB,CAAC,CAAC,sBAAsB,MAAM,CAAC,cAAc,CAAC,yEAAyE;gBACvH,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC;YAErJ,OAAO;gBACL,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,WAAW,EAAE,WAAW,CAAC,MAAM;gBAC/B,aAAa,EAAE,aAAa,CAAC,MAAM;gBACnC,cAAc;gBACd,WAAW,EAAE,KAAK;gBAClB,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/postgresql/resources/partman.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pg_partman Status Resource
+ *
+ * Provides pg_partman partition set status, configuration, and health.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createPartmanResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=partman.d.ts.map

package/dist/adapters/postgresql/resources/partman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partman.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/partman.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA0ClE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA6LpB"}