specmem-hardwicksoftware 3.5.99

package/dist/packages/packageTools.d.ts

@@ -0,0 +1,255 @@
+/**
+ * packageTools - MCP tools for tracking package history
+ *
+ * yooo these tools let you track node_modules without indexing them
+ * fr fr the big brain move
+ */
+import { MCPTool } from '../mcp/toolRegistry.js';
+import { DependencyHistoryManager, PackageHistoryQuery, DependencyHistoryRecord, CurrentDependency } from './dependencyHistory.js';
+import { ConnectionPoolGoBrrr } from '../db/connectionPoolGoBrrr.js';
+/**
+ * GetPackageHistory - get history for a specific package
+ */
+export declare class GetPackageHistory implements MCPTool<{
+    packageName: string;
+    limit?: number;
+}, {
+    history: DependencyHistoryRecord[];
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packageName: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+        required: "packageName"[];
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(params: {
+        packageName: string;
+        limit?: number;
+    }): Promise<{
+        history: DependencyHistoryRecord[];
+    }>;
+}
+/**
+ * GetRecentPackageChanges - get recent package changes across all projects
+ */
+export declare class GetRecentPackageChanges implements MCPTool<{
+    days?: number;
+    limit?: number;
+}, {
+    changes: DependencyHistoryRecord[];
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            days: {
+                type: string;
+                default: number;
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(params: {
+        days?: number;
+        limit?: number;
+    }): Promise<{
+        changes: DependencyHistoryRecord[];
+    }>;
+}
+/**
+ * GetCurrentDependencies - get all currently installed packages
+ */
+export declare class GetCurrentDependencies implements MCPTool<{
+    packageJsonPath?: string;
+}, {
+    dependencies: CurrentDependency[];
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packageJsonPath: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(params: {
+        packageJsonPath?: string;
+    }): Promise<{
+        dependencies: CurrentDependency[];
+    }>;
+}
+/**
+ * WhenWasPackageAdded - find when a package was first added
+ */
+export declare class WhenWasPackageAdded implements MCPTool<{
+    packageName: string;
+    packageJsonPath?: string;
+}, {
+    addedAt: Date | null;
+    found: boolean;
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packageName: {
+                type: string;
+                description: string;
+            };
+            packageJsonPath: {
+                type: string;
+                description: string;
+            };
+        };
+        required: "packageName"[];
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(params: {
+        packageName: string;
+        packageJsonPath?: string;
+    }): Promise<{
+        addedAt: Date | null;
+        found: boolean;
+    }>;
+}
+/**
+ * QueryPackageHistory - flexible query for package history
+ */
+export declare class QueryPackageHistory implements MCPTool<PackageHistoryQuery, {
+    results: DependencyHistoryRecord[];
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packageName: {
+                type: string;
+                description: string;
+            };
+            eventType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            packageType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            packageJsonPath: {
+                type: string;
+                description: string;
+            };
+            projectName: {
+                type: string;
+                description: string;
+            };
+            fromDate: {
+                type: string;
+                description: string;
+            };
+            toDate: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(params: PackageHistoryQuery & {
+        fromDate?: string;
+        toDate?: string;
+    }): Promise<{
+        results: DependencyHistoryRecord[];
+    }>;
+}
+/**
+ * GetPackageStats - get aggregated statistics about package usage
+ */
+export declare class GetPackageStats implements MCPTool<Record<string, never>, {
+    totalPackages: number;
+    totalChanges: number;
+    mostChangedPackages: Array<{
+        packageName: string;
+        changeCount: number;
+    }>;
+    recentlyAdded: Array<{
+        packageName: string;
+        addedAt: Date;
+    }>;
+}> {
+    private historyManager;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    constructor(historyManager: DependencyHistoryManager);
+    execute(): Promise<{
+        totalPackages: number;
+        totalChanges: number;
+        mostChangedPackages: Array<{
+            packageName: string;
+            changeCount: number;
+        }>;
+        recentlyAdded: Array<{
+            packageName: string;
+            addedAt: Date;
+        }>;
+    }>;
+}
+export declare const PACKAGE_TOOLS: {
+    GetPackageHistory: typeof GetPackageHistory;
+    GetRecentPackageChanges: typeof GetRecentPackageChanges;
+    GetCurrentDependencies: typeof GetCurrentDependencies;
+    WhenWasPackageAdded: typeof WhenWasPackageAdded;
+    QueryPackageHistory: typeof QueryPackageHistory;
+    GetPackageStats: typeof GetPackageStats;
+};
+/**
+ * createPackageTools - creates all package tracking tools
+ */
+export declare function createPackageTools(pool?: ConnectionPoolGoBrrr): {
+    getPackageHistory: GetPackageHistory;
+    getRecentPackageChanges: GetRecentPackageChanges;
+    getCurrentDependencies: GetCurrentDependencies;
+    whenWasPackageAdded: WhenWasPackageAdded;
+    queryPackageHistory: QueryPackageHistory;
+    getPackageStats: GetPackageStats;
+};
+//# sourceMappingURL=packageTools.d.ts.map

package/dist/packages/packageTools.d.ts.map

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

package/dist/packages/packageTools.js

@@ -0,0 +1,242 @@
+/**
+ * packageTools - MCP tools for tracking package history
+ *
+ * yooo these tools let you track node_modules without indexing them
+ * fr fr the big brain move
+ */
+import { logger } from '../utils/logger.js';
+import { DependencyHistoryManager } from './dependencyHistory.js';
+import { getThePool } from '../db/connectionPoolGoBrrr.js';
+/**
+ * GetPackageHistory - get history for a specific package
+ */
+export class GetPackageHistory {
+    historyManager;
+    name = 'get_package_history';
+    description = 'get the history of changes for a specific npm package - shows when it was added, updated, or removed';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            packageName: {
+                type: 'string',
+                description: 'the name of the package to get history for (e.g., "express", "react")'
+            },
+            limit: {
+                type: 'number',
+                default: 100,
+                description: 'maximum number of history entries to return'
+            }
+        },
+        required: ['packageName']
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'getting package history - whenDidWeAddThisPackage');
+        const history = await this.historyManager.getPackageHistory(params.packageName, params.limit ?? 100);
+        logger.info({ packageName: params.packageName, entryCount: history.length }, 'package history retrieved');
+        return { history };
+    }
+}
+/**
+ * GetRecentPackageChanges - get recent package changes across all projects
+ */
+export class GetRecentPackageChanges {
+    historyManager;
+    name = 'recent_package_changes';
+    description = 'get recent dependency changes across all package.json files - shows what packages were added/updated/removed recently';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            days: {
+                type: 'number',
+                default: 7,
+                description: 'number of days to look back (default: 7)'
+            },
+            limit: {
+                type: 'number',
+                default: 50,
+                description: 'maximum number of changes to return'
+            }
+        }
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'getting recent package changes');
+        const changes = await this.historyManager.getRecentChanges(params.days ?? 7, params.limit ?? 50);
+        logger.info({ changeCount: changes.length }, 'recent changes retrieved');
+        return { changes };
+    }
+}
+/**
+ * GetCurrentDependencies - get all currently installed packages
+ */
+export class GetCurrentDependencies {
+    historyManager;
+    name = 'current_dependencies';
+    description = 'get all currently installed packages from package.json files - shows what packages do we have';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            packageJsonPath: {
+                type: 'string',
+                description: 'optional path to a specific package.json file (if not provided, returns all dependencies)'
+            }
+        }
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'getting current dependencies - whatPackagesDoWeHave');
+        const dependencies = await this.historyManager.getCurrentDependencies(params.packageJsonPath);
+        logger.info({ dependencyCount: dependencies.length }, 'current dependencies retrieved');
+        return { dependencies };
+    }
+}
+/**
+ * WhenWasPackageAdded - find when a package was first added
+ */
+export class WhenWasPackageAdded {
+    historyManager;
+    name = 'when_package_added';
+    description = 'find when a package was first added to the project - whenDidWeAddThisPackage fr';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            packageName: {
+                type: 'string',
+                description: 'the name of the package to check (e.g., "express", "react")'
+            },
+            packageJsonPath: {
+                type: 'string',
+                description: 'optional path to a specific package.json file'
+            }
+        },
+        required: ['packageName']
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'checking when package was added');
+        const addedAt = await this.historyManager.whenWasPackageAdded(params.packageName, params.packageJsonPath);
+        logger.info({ packageName: params.packageName, addedAt, found: !!addedAt }, 'package addition date checked');
+        return {
+            addedAt,
+            found: !!addedAt
+        };
+    }
+}
+/**
+ * QueryPackageHistory - flexible query for package history
+ */
+export class QueryPackageHistory {
+    historyManager;
+    name = 'query_package_history';
+    description = 'flexible query for package history with filtering - search by name, event type, date range, etc';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            packageName: {
+                type: 'string',
+                description: 'filter by package name'
+            },
+            eventType: {
+                type: 'string',
+                enum: ['added', 'updated', 'removed'],
+                description: 'filter by event type'
+            },
+            packageType: {
+                type: 'string',
+                enum: ['dependency', 'devDependency', 'peerDependency', 'optionalDependency'],
+                description: 'filter by dependency type'
+            },
+            packageJsonPath: {
+                type: 'string',
+                description: 'filter by package.json path'
+            },
+            projectName: {
+                type: 'string',
+                description: 'filter by project name'
+            },
+            fromDate: {
+                type: 'string',
+                description: 'filter events from this date (ISO 8601 format)'
+            },
+            toDate: {
+                type: 'string',
+                description: 'filter events until this date (ISO 8601 format)'
+            },
+            limit: {
+                type: 'number',
+                default: 100,
+                description: 'maximum number of results to return'
+            }
+        }
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'querying package history');
+        // convert string dates to Date objects
+        const query = {
+            ...params,
+            fromDate: params.fromDate ? new Date(params.fromDate) : undefined,
+            toDate: params.toDate ? new Date(params.toDate) : undefined
+        };
+        const results = await this.historyManager.queryHistory(query);
+        logger.info({ resultCount: results.length }, 'package history query complete');
+        return { results };
+    }
+}
+/**
+ * GetPackageStats - get aggregated statistics about package usage
+ */
+export class GetPackageStats {
+    historyManager;
+    name = 'get_package_stats';
+    description = 'get statistics about package usage - total packages, most changed, recently added, etc';
+    inputSchema = {
+        type: 'object',
+        properties: {}
+    };
+    constructor(historyManager) {
+        this.historyManager = historyManager;
+    }
+    async execute() {
+        logger.debug('getting package stats - packageHistoryGoCrazy');
+        const stats = await this.historyManager.getPackageStats();
+        logger.info({ totalPackages: stats.totalPackages, totalChanges: stats.totalChanges }, 'package stats retrieved');
+        return stats;
+    }
+}
+// export all tools
+export const PACKAGE_TOOLS = {
+    GetPackageHistory,
+    GetRecentPackageChanges,
+    GetCurrentDependencies,
+    WhenWasPackageAdded,
+    QueryPackageHistory,
+    GetPackageStats
+};
+/**
+ * createPackageTools - creates all package tracking tools
+ */
+export function createPackageTools(pool) {
+    const actualPool = pool ?? getThePool();
+    const historyManager = new DependencyHistoryManager(actualPool);
+    return {
+        getPackageHistory: new GetPackageHistory(historyManager),
+        getRecentPackageChanges: new GetRecentPackageChanges(historyManager),
+        getCurrentDependencies: new GetCurrentDependencies(historyManager),
+        whenWasPackageAdded: new WhenWasPackageAdded(historyManager),
+        queryPackageHistory: new QueryPackageHistory(historyManager),
+        getPackageStats: new GetPackageStats(historyManager)
+    };
+}
+//# sourceMappingURL=packageTools.js.map

package/dist/packages/packageTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageTools.js","sourceRoot":"","sources":["../../src/packages/packageTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,wBAAwB,EAIzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAwB,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAuBR;IAnBpB,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAAG,sGAAsG,CAAC;IAErH,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,aAAsB,CAAC;KACnC,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,MAA+C;QAG3D,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,mDAAmD,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CACzD,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,KAAK,IAAI,GAAG,CACpB,CAAC;QAEF,MAAM,CAAC,IAAI,CACT,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EAC/D,2BAA2B,CAC5B,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAuBd;IAnBpB,IAAI,GAAG,wBAAwB,CAAC;IAChC,WAAW,GAAG,uHAAuH,CAAC;IAEtI,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,0CAA0C;aACxD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,qCAAqC;aACnD;SACF;KACF,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,MAAyC;QAGrD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CACxD,MAAM,CAAC,IAAI,IAAI,CAAC,EAChB,MAAM,CAAC,KAAK,IAAI,EAAE,CACnB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAEzE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAiBb;IAbpB,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAAG,+FAA+F,CAAC;IAE9G,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;aACzG;SACF;KACF,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,MAAoC;QAGhD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,qDAAqD,CAAC,CAAC;QAEhF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,sBAAsB,CACnE,MAAM,CAAC,eAAe,CACvB,CAAC;QAEF,MAAM,CAAC,IAAI,CACT,EAAE,eAAe,EAAE,YAAY,CAAC,MAAM,EAAE,EACxC,gCAAgC,CACjC,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAsBV;IAlBpB,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAAG,iFAAiF,CAAC;IAEhG,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;SACF;QACD,QAAQ,EAAE,CAAC,aAAsB,CAAC;KACnC,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,MAAyD;QAIrE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,iCAAiC,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAC3D,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,eAAe,CACvB,CAAC;QAEF,MAAM,CAAC,IAAI,CACT,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAC9D,+BAA+B,CAChC,CAAC;QAEF,OAAO;YACL,OAAO;YACP,KAAK,EAAE,CAAC,CAAC,OAAO;SACjB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAgDV;IA5CpB,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GAAG,iGAAiG,CAAC;IAEhH,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;gBACrC,WAAW,EAAE,sBAAsB;aACpC;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,CAAC;gBAC7E,WAAW,EAAE,2BAA2B;aACzC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,qCAAqC;aACnD;SACF;KACF,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,MAGb;QACC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAErD,uCAAuC;QACvC,MAAM,KAAK,GAAwB;YACjC,GAAG,MAAM;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9D,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAE/E,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAiBN;IARpB,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAAG,wFAAwF,CAAC;IAEvG,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf,CAAC;IAEF,YAAoB,cAAwC;QAAxC,mBAAc,GAAd,cAAc,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO;QAMX,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAE9D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;QAE1D,MAAM,CAAC,IAAI,CACT,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,EACxE,yBAAyB,CAC1B,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,mBAAmB;AACnB,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,eAAe;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA2B;IAQ5D,MAAM,UAAU,GAAG,IAAI,IAAI,UAAU,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAEhE,OAAO;QACL,iBAAiB,EAAE,IAAI,iBAAiB,CAAC,cAAc,CAAC;QACxD,uBAAuB,EAAE,IAAI,uBAAuB,CAAC,cAAc,CAAC;QACpE,sBAAsB,EAAE,IAAI,sBAAsB,CAAC,cAAc,CAAC;QAClE,mBAAmB,EAAE,IAAI,mBAAmB,CAAC,cAAc,CAAC;QAC5D,mBAAmB,EAAE,IAAI,mBAAmB,CAAC,cAAc,CAAC;QAC5D,eAAe,EAAE,IAAI,eAAe,CAAC,cAAc,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/packages/packageTracker.d.ts

@@ -0,0 +1,98 @@
+/**
+ * PackageJson - the structure we care about
+ */
+export interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+}
+/**
+ * DependencyChange - represents a change in dependencies
+ */
+export interface DependencyChange {
+    packageName: string;
+    eventType: 'added' | 'updated' | 'removed';
+    packageType: 'dependency' | 'devDependency' | 'peerDependency' | 'optionalDependency';
+    oldVersion?: string;
+    newVersion?: string;
+    timestamp: Date;
+}
+/**
+ * PackageSnapshot - a snapshot of package.json at a point in time
+ */
+export interface PackageSnapshot {
+    filePath: string;
+    projectName?: string;
+    projectVersion?: string;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    optionalDependencies: Record<string, string>;
+    timestamp: Date;
+}
+/**
+ * PackageTracker - tracks changes in package.json files
+ *
+ * features that GO HARD:
+ * - reads package.json and package-lock.json
+ * - diffs dependencies between versions
+ * - detects added/updated/removed packages
+ * - handles monorepos with multiple package.json files
+ * - supports npm, yarn, pnpm
+ */
+export declare class PackageTracker {
+    private snapshots;
+    /**
+     * readPackageJson - reads and parses a package.json file
+     */
+    readPackageJson(filePath: string): Promise<PackageJson | null>;
+    /**
+     * createSnapshot - creates a snapshot from package.json
+     */
+    createSnapshot(filePath: string): Promise<PackageSnapshot | null>;
+    /**
+     * diffSnapshots - compares two snapshots and finds changes
+     * returns list of changes that occurred
+     */
+    diffSnapshots(oldSnapshot: PackageSnapshot | null, newSnapshot: PackageSnapshot): DependencyChange[];
+    /**
+     * diffDependencyType - compares a specific type of dependencies
+     */
+    private diffDependencyType;
+    /**
+     * trackPackageChanges - tracks changes in a package.json file
+     * returns the list of changes detected
+     */
+    trackPackageChanges(filePath: string): Promise<DependencyChange[]>;
+    /**
+     * getSnapshot - gets the current snapshot for a file
+     */
+    getSnapshot(filePath: string): PackageSnapshot | undefined;
+    /**
+     * getAllSnapshots - returns all tracked snapshots
+     */
+    getAllSnapshots(): Map<string, PackageSnapshot>;
+    /**
+     * clearSnapshot - removes a snapshot from cache
+     */
+    clearSnapshot(filePath: string): boolean;
+    /**
+     * clearAllSnapshots - clears all cached snapshots
+     */
+    clearAllSnapshots(): void;
+    /**
+     * findPackageJsonFiles - recursively finds all package.json files
+     * useful for monorepos
+     */
+    findPackageJsonFiles(rootPath: string, maxDepth?: number): Promise<string[]>;
+    /**
+     * getLockFileType - detects which lock file is used
+     */
+    getLockFileType(packageJsonPath: string): Promise<'npm' | 'yarn' | 'pnpm' | 'none'>;
+}
+export declare function getPackageTracker(): PackageTracker;
+export declare function resetPackageTracker(): void;
+//# sourceMappingURL=packageTracker.d.ts.map

package/dist/packages/packageTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageTracker.d.ts","sourceRoot":"","sources":["../../src/packages/packageTracker.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAA2C;IAE5D;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWpE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoBvE;;;OAGG;IACH,aAAa,CACX,WAAW,EAAE,eAAe,GAAG,IAAI,EACnC,WAAW,EAAE,eAAe,GAC3B,gBAAgB,EAAE;IA4FrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;;OAGG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyBxE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI/C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;OAGG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiC7E;;OAEG;IACG,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAoB1F;AAKD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}