@creeperhost/modlens-mcp 1.6.0

package/dist/tools/kubejs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubejs.js","sourceRoot":"","sources":["../../src/tools/kubejs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,iFAAiF;AAEjF,MAAM,eAAe,GAA6B;IAC9C,YAAY,EAAS,CAAC,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC;IACxM,eAAe,EAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,CAAC;IACrF,eAAe,EAAM,CAAC,eAAe,CAAC;IACtC,YAAY,EAAS,CAAC,YAAY,EAAE,eAAe,EAAE,kBAAkB,CAAC;IACxE,aAAa,EAAQ,CAAC,QAAQ,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,gBAAgB,CAAC;IACnG,eAAe,EAAM,CAAC,eAAe,EAAE,yBAAyB,EAAE,eAAe,CAAC;IAClF,gBAAgB,EAAK,CAAC,aAAa,EAAE,eAAe,CAAC;IACrD,gBAAgB,EAAK,CAAC,aAAa,EAAE,eAAe,CAAC;IACrD,iBAAiB,EAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC;IACvD,iBAAiB,EAAI,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC;IACnG,kBAAkB,EAAG,CAAC,wBAAwB,EAAE,iBAAiB,EAAE,+BAA+B,CAAC;IACnG,cAAc,EAAO,CAAC,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,CAAC;IAC1E,eAAe,EAAM,CAAC,cAAc,EAAE,aAAa,EAAE,oBAAoB,CAAC;IAC1E,eAAe,EAAM,CAAC,qBAAqB,EAAE,+BAA+B,EAAE,mBAAmB,CAAC;IAClG,cAAc,EAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC;IACvD,iBAAiB,EAAI,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,CAAC;IACpF,kBAAkB,EAAG,CAAC,iBAAiB,EAAE,cAAc,CAAC;CAC3D,CAAC;AAEF,iFAAiF;AAEjF,SAAS,OAAO,CAAC,GAAW,EAAE,OAAiB,CAAC,KAAK,EAAE,KAAK,CAAC;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACjB,CAAC;AAYD,SAAS,aAAa,CAAC,YAAoB,EAAE,OAAe;IACxD,MAAM,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,gBAAgB;YACvE,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe;QAC3E,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,EAAQ,YAAY;QACxB,SAAS,EAAG,KAAK,CAAC,MAAM;QACxB,QAAQ,EAAI,OAAO,CAAC,MAAM;QAC1B,UAAU;QACV,QAAQ;KACX,CAAC;AACN,CAAC;AAED,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,iCAAiC,UAAU,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,kDAAkD;IAClD,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAW,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,KAAK,GAAY,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEvF,OAAO;QACH,UAAU;QACV,SAAS,EAAQ,OAAO,CAAC,MAAM;QAC/B,aAAa,EAAI,MAAM,CAAC,MAAM;QAC9B,UAAU;QACV,eAAe;QACf,OAAO,EAAU,MAAM;QACvB,YAAY,EAAK,KAAK;KACzB,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,UAAkB,EAClB,KAAa,EACb,KAAK,GAAG,EAAE;IAEV,MAAM,KAAK,GAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,KAAK,GAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,OAAO,GAA2D,EAAE,CAAC;IAE3E,KAAK,EACL,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,OAAO,CAAC,IAAI,CAAC;wBACT,IAAI,EAAK,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;wBAC5E,IAAI,EAAK,CAAC,GAAG,CAAC;wBACd,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;qBACzC,CAAC,CAAC;oBACH,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;wBAAE,MAAM,KAAK,CAAC;gBAC7C,CAAC;YACL,CAAC;QACL,CAAC;QAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACH,UAAU;QACV,KAAK;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,MAAM,EAAQ,OAAO,CAAC,MAAM,IAAI,KAAK;QACrC,OAAO;KACV,CAAC;AACN,CAAC;AAED,oFAAoF;AAEpF,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE/C,SAAS,WAAW,CAAC,IAAY;IAC7B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,EAAE,CAAC;QACN,IAAI,UAAU,CAAC,IAAI,IAAI,eAAe,EAAE,CAAC;YACrC,sCAAsC;YACtC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF,SAAS,MAAM,CAAC,CAAW,EAAE,CAAW;IACpC,IAAI,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC7C,UAAkB,EAClB,KAAa,EACb,KAAK,GAAG,EAAE;IAEV,IAAI,CAAC,MAAM,iBAAiB,EAAE,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,iCAAiC,UAAU,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;IAChE,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAqG,EAAE,CAAC;IAEpH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG;gBAAE,SAAS;YAEnB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,GAAG;gBACT,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK;gBACxC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACxE,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;aAClC,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEnC,OAAO;QACH,UAAU;QACV,KAAK;QACL,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,OAAO,EAAE,GAAG;KACf,CAAC;AACN,CAAC"}

package/dist/tools/mappings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP tools for Minecraft mappings and JAR remapping.
+ *
+ * Tools:
+ *   find_mapping    - Translate a symbol name between official/intermediary/yarn/mojmap
+ *   remap_mod_jar   - Remap a mod JAR using TinyRemapper (official → yarn or mojmap)
+ *   get_parchment   - Get Parchment parameter names + javadocs for a class
+ *   list_parchment_versions - List available Parchment builds for a MC version
+ */
+import { type MappingNs } from "../mappings.js";
+export declare function findMapping(symbol: string, version: string, sourceNs: MappingNs, targetNs: MappingNs): Promise<object>;
+export declare function remapModJar(inputJar: string, outputJar: string, version: string, toMapping: "yarn" | "mojmap"): Promise<object>;
+export declare function getParchment(className: string, mcVersion: string): Promise<object>;
+export declare function listParchmentVersions(mcVersion: string): Promise<object>;
+/** Return a summary of all parchment data for a version (class names + counts). */
+export declare function getParchmentSummary(mcVersion: string): Promise<object>;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/tools/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../../src/tools/mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAkG,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhJ,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,SAAS,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAGD,wBAAsB,WAAW,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,QAAQ,GAC7B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAGD,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BxF;AAGD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAGD,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5E"}

package/dist/tools/mappings.js

@@ -0,0 +1,85 @@
+/**
+ * MCP tools for Minecraft mappings and JAR remapping.
+ *
+ * Tools:
+ *   find_mapping    - Translate a symbol name between official/intermediary/yarn/mojmap
+ *   remap_mod_jar   - Remap a mod JAR using TinyRemapper (official → yarn or mojmap)
+ *   get_parchment   - Get Parchment parameter names + javadocs for a class
+ *   list_parchment_versions - List available Parchment builds for a MC version
+ */
+import { translateSymbol, remapJar, getParchmentClass, listAvailableParchmentVersions, getParchmentData } from "../mappings.js";
+import { assertJarPath } from "../security.js";
+import { extname } from "path";
+// ── find_mapping ──────────────────────────────────────────────────────────────
+export async function findMapping(symbol, version, sourceNs, targetNs) {
+    const result = await translateSymbol(symbol, sourceNs, targetNs, version);
+    return result;
+}
+// ── remap_mod_jar ─────────────────────────────────────────────────────────────
+export async function remapModJar(inputJar, outputJar, version, toMapping) {
+    assertJarPath(inputJar);
+    if (extname(outputJar).toLowerCase() !== ".jar") {
+        throw new Error("outputJar must have a .jar extension");
+    }
+    const result = await remapJar(inputJar, outputJar, version, toMapping);
+    return {
+        success: true,
+        inputJar,
+        outputJar: result.outputJar,
+        mcVersion: version,
+        mapping: toMapping,
+        note: result.note,
+    };
+}
+// ── get_parchment ─────────────────────────────────────────────────────────────
+export async function getParchment(className, mcVersion) {
+    const cls = await getParchmentClass(className, mcVersion);
+    if (!cls) {
+        return {
+            found: false,
+            className,
+            mcVersion,
+            message: `No Parchment data for ${className} in MC ${mcVersion}. Parchment may not have a build for this MC version yet, or the class may not have parameter names documented.`,
+        };
+    }
+    return {
+        found: true,
+        className: cls.name,
+        mcVersion,
+        javadoc: cls.javadoc,
+        methods: [...cls.methods.entries()].map(([key, m]) => ({
+            key,
+            name: m.name,
+            descriptor: m.descriptor,
+            javadoc: m.javadoc,
+            parameters: m.parameters,
+        })),
+        fields: [...cls.fields.entries()].map(([key, f]) => ({
+            key,
+            name: f.name,
+            javadoc: f.javadoc,
+        })),
+    };
+}
+// ── list_parchment_versions ───────────────────────────────────────────────────
+export async function listParchmentVersions(mcVersion) {
+    const versions = await listAvailableParchmentVersions(mcVersion);
+    return { mcVersion, availableBuilds: versions, count: versions.length };
+}
+// ── get_parchment_summary ─────────────────────────────────────────────────────
+/** Return a summary of all parchment data for a version (class names + counts). */
+export async function getParchmentSummary(mcVersion) {
+    const data = await getParchmentData(mcVersion);
+    if (!data) {
+        return { found: false, mcVersion, message: "No Parchment data available for this MC version." };
+    }
+    const classes = [...data.classes.entries()].map(([name, cls]) => ({
+        name,
+        methodCount: cls.methods.size,
+        fieldCount: cls.fields.size,
+        hasJavadoc: !!(cls.javadoc?.length),
+        paramCount: [...cls.methods.values()].reduce((s, m) => s + m.parameters.length, 0),
+    }));
+    return { found: true, mcVersion, classCount: classes.length, classes };
+}
+//# sourceMappingURL=mappings.js.map

package/dist/tools/mappings.js.map

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

package/dist/tools/mc-fts.d.ts

@@ -0,0 +1,101 @@
+/**
+ * index_minecraft_version
+ * Reads the already-decompiled source tree and upserts every .java file
+ * into mc_source_files for FTS. Decompilation must have finished first
+ * (run decompile_minecraft_version and wait for status "done").
+ */
+export declare function indexMcVersion(version: string, force?: boolean): Promise<{
+    status: string;
+    indexed: number;
+    skipped: number;
+}>;
+/**
+ * search_mc_indexed
+ * Fast FTS search over indexed MC source. Supports:
+ *   - Plain text / keyword queries (uses plainto_tsquery 'simple' config — no stemming)
+ *   - Boolean: "Entity AND tick", "player OR entity", "hurt -damage"
+ *   - Phrase: wrap in double-quotes passed as tsquery: '"onHurt"'
+ */
+export declare function searchMcIndexed(query: string, version: string, limit?: number): Promise<Array<{
+    className: string;
+    snippet: string;
+}>>;
+/**
+ * Returns true if the FTS index has been built for this MC version.
+ * Checks `indexed` flag on the McVersion row.
+ */
+export declare function isMcVersionIndexed(version: string): Promise<boolean>;
+/**
+ * index_mc_source_semantic
+ * Embeds MC source files for a version using Ollama. Processes files that have
+ * no embedding yet (safe to re-run / resume after interruption).
+ *
+ * Only embeds the first chunk (class header ~1500 chars) — enough for semantic
+ * class-level search without spending hours on full-file embedding.
+ *
+ * @param version    MC version string e.g. "26.1.2"
+ * @param batchSize  Files per batch (pause between batches to avoid OOM)
+ */
+export declare function indexMcSourceSemantic(version: string, batchSize?: number): Promise<{
+    status: string;
+    embedded: number;
+    skipped: number;
+    remaining: number;
+}>;
+/**
+ * search_mc_source_semantic
+ * Semantic (vector) search over embedded MC source files.
+ * Falls back to FTS if Ollama is unavailable.
+ */
+export declare function searchMcSourceSemantic(query: string, version: string, limit?: number, provenance?: string): Promise<Array<{
+    className: string;
+    similarity: number;
+    source: string;
+}>>;
+/**
+ * index_mod_source_fts
+ * Walks the decompiled source tree of a mod and upserts every .java file into
+ * mod_source_files. This populates both the PostgreSQL GIN index and the SQLite
+ * FTS5 virtual table (via triggers) — no Ollama required.
+ * Safe to re-run; already-indexed files are updated in-place.
+ */
+export declare function indexModSourceFts(dbId: number): Promise<{
+    status: string;
+    indexed: number;
+    skipped: number;
+}>;
+/**
+ * search_mod_source_indexed
+ * BM25-ranked FTS search over indexed mod source files.
+ * Works for any loader (fabric, neoforge, forge, quilt) — mods are filtered by dbId.
+ * Requires index_fts (or index_semantic) to have been run first.
+ */
+export declare function searchModSourceIndexed(dbId: number, query: string, limit?: number): Promise<Array<{
+    className: string;
+    snippet: string;
+}>>;
+/**
+ * index_mod_source_semantic
+ * Walks the decompiled source tree of a mod (by dbId), upserts each .java file
+ * into mod_source_files (also populates FTS index), then embeds each file in
+ * batches using Ollama.
+ */
+export declare function indexModSourceSemantic(dbId: number, batchSize?: number, maxFiles?: number): Promise<{
+    status: string;
+    indexed: number;
+    embedded: number;
+    skipped: number;
+    remaining: number;
+    error?: string;
+}>;
+/**
+ * search_mod_source_semantic
+ * Semantic (vector) search over embedded mod source files for a given dbId.
+ */
+export declare function searchModSourceSemantic(query: string, dbId: number, limit?: number, provenance?: string): Promise<Array<{
+    className: string;
+    modId: string;
+    similarity: number;
+    source: string;
+}>>;
+//# sourceMappingURL=mc-fts.d.ts.map

package/dist/tools/mc-fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mc-fts.d.ts","sourceRoot":"","sources":["../../src/tools/mc-fts.ts"],"names":[],"mappings":"AAmCA;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC;IAC1E,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CACpD,CAAC,CA0CD;AAID;;;;;;GAMG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACX,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAMxD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1E;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,SAAK,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAyCnF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,EACV,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAQ3E;AAID;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,IAAI,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/D;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACX,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAIxD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,SAAK,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCpH;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,EACV,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAc1F"}

package/dist/tools/mc-fts.js

@@ -0,0 +1,279 @@
+/**
+ * PostgreSQL full-text search for vanilla Minecraft source.
+ * index_minecraft_version: walks a completed Vineflower decompile, stores
+ *   source in the mc_source_files table.
+ * search_mc_indexed: runs a fast FTS query via to_tsvector('simple', content).
+ *
+ * The GIN index is created automatically by `npm run db:setup`.
+ * (scripts/create-fts-index.mjs — runs after prisma migrate deploy)
+ */
+import { readFile, readdir } from "fs/promises";
+import { join, relative } from "path";
+import { mcPaths } from "../minecraft.js";
+import { isDecompileDone } from "../java-tools.js";
+import { ensureMcVersion, findMcVersionById, findMcVersionByVersionId, updateMcVersion, upsertMcSourceFile, searchMcSourceFiles } from "../repositories/mcVersion.js";
+import { findModById, upsertModSourceFile, findModSourceFilesUnembedded, countUnembeddedModSourceFiles, searchModSourceFiles } from "../repositories/mod.js";
+import { embed, isOllamaAvailable, chunkText } from "../embeddings.js";
+import { upsertSourceEmbedding, searchSourceByVector, countUnembedded, upsertModSourceEmbedding, searchModSourceByVector } from "../repositories/embeddings.js";
+async function ensureMcVersionRecord(version) {
+    return ensureMcVersion(version);
+}
+/** Collect all .java file paths under a directory tree. */
+async function collectJavaFiles(dir) {
+    const out = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+        const full = join(dir, e.name);
+        if (e.isDirectory())
+            out.push(...await collectJavaFiles(full));
+        else if (e.name.endsWith(".java"))
+            out.push(full);
+    }
+    return out;
+}
+/**
+ * index_minecraft_version
+ * Reads the already-decompiled source tree and upserts every .java file
+ * into mc_source_files for FTS. Decompilation must have finished first
+ * (run decompile_minecraft_version and wait for status "done").
+ */
+export async function indexMcVersion(version, force = false) {
+    const outDir = mcPaths.decompiled(version);
+    const decompStatus = await isDecompileDone(outDir);
+    if (decompStatus !== "done") {
+        throw new Error(`MC ${version} decompile is not complete (status: ${decompStatus}). ` +
+            `Run decompile_minecraft_version("${version}") first.`);
+    }
+    const mcVersionId = await ensureMcVersionRecord(version);
+    if (!force) {
+        const existing = await findMcVersionById(mcVersionId);
+        if (existing?.indexed)
+            return { status: "already_indexed", indexed: 0, skipped: 0 };
+    }
+    const javaFiles = await collectJavaFiles(outDir);
+    let indexed = 0;
+    let skipped = 0;
+    // Batch upserts in chunks of 50 to avoid huge transactions
+    const BATCH = 50;
+    for (let i = 0; i < javaFiles.length; i += BATCH) {
+        const chunk = javaFiles.slice(i, i + BATCH);
+        for (const filePath of chunk) {
+            const relPath = relative(outDir, filePath);
+            // Convert path to internal class name: com/example/Foo.java → com/example/Foo
+            const className = relPath.replace(/\\/g, "/").replace(/\.java$/, "");
+            try {
+                const content = await readFile(filePath, "utf8");
+                await upsertMcSourceFile(mcVersionId, className, content);
+                indexed++;
+            }
+            catch {
+                skipped++;
+            }
+        }
+    }
+    await updateMcVersion(mcVersionId, { indexed: true });
+    return { status: "done", indexed, skipped };
+}
+/**
+ * search_mc_indexed
+ * Fast FTS search over indexed MC source. Supports:
+ *   - Plain text / keyword queries (uses plainto_tsquery 'simple' config — no stemming)
+ *   - Boolean: "Entity AND tick", "player OR entity", "hurt -damage"
+ *   - Phrase: wrap in double-quotes passed as tsquery: '"onHurt"'
+ */
+export async function searchMcIndexed(query, version, limit = 20) {
+    const row = await findMcVersionByVersionId(version);
+    if (!row) {
+        throw new Error(`Version "${version}" is not in the database. Run index_minecraft_version("${version}") first.`);
+    }
+    return searchMcSourceFiles(row.id, query, limit);
+}
+/**
+ * Returns true if the FTS index has been built for this MC version.
+ * Checks `indexed` flag on the McVersion row.
+ */
+export async function isMcVersionIndexed(version) {
+    const row = await findMcVersionByVersionId(version);
+    return row?.indexed === true;
+}
+// ── Semantic indexing ─────────────────────────────────────────────────────────
+/**
+ * index_mc_source_semantic
+ * Embeds MC source files for a version using Ollama. Processes files that have
+ * no embedding yet (safe to re-run / resume after interruption).
+ *
+ * Only embeds the first chunk (class header ~1500 chars) — enough for semantic
+ * class-level search without spending hours on full-file embedding.
+ *
+ * @param version    MC version string e.g. "26.1.2"
+ * @param batchSize  Files per batch (pause between batches to avoid OOM)
+ */
+export async function indexMcSourceSemantic(version, batchSize = 50) {
+    if (!await isOllamaAvailable()) {
+        throw new Error("Ollama is not available. Set OLLAMA_URL and ensure Ollama is running with `ollama pull nomic-embed-text`.");
+    }
+    const row = await findMcVersionByVersionId(version);
+    if (!row) {
+        throw new Error(`Version "${version}" is not in the database. Run index_minecraft_version("${version}") first.`);
+    }
+    const mcVersionId = row.id;
+    const remaining0 = await countUnembedded("mc_source_files", mcVersionId);
+    if (remaining0 === 0) {
+        return { status: "already_embedded", embedded: 0, skipped: 0, remaining: 0 };
+    }
+    // Fetch rows without embeddings in batches — always from offset 0
+    // so re-runs pick up any rows that failed in a previous pass
+    let embedded = 0;
+    let skipped = 0;
+    while (true) {
+        const { getDb } = await import("../db.js");
+        const _db = await getDb();
+        const batch = await _db.$queryRawUnsafe(`SELECT id, class_name, content FROM mc_source_files
+             WHERE mc_version_id = $1 AND embedding IS NULL
+             ORDER BY id LIMIT $2`, mcVersionId, batchSize);
+        if (!batch.length)
+            break;
+        for (const file of batch) {
+            try {
+                const chunkSize = parseInt(process.env.OLLAMA_EMBED_CHUNK ?? "500", 10);
+                const chunk = chunkText(file.content, chunkSize)[0];
+                const vec = await embed(chunk);
+                await upsertSourceEmbedding(file.id, vec);
+                embedded++;
+            }
+            catch {
+                skipped++;
+            }
+        }
+        await new Promise(r => setTimeout(r, 50));
+    }
+    const remaining = await countUnembedded("mc_source_files", mcVersionId);
+    return { status: "done", embedded, skipped, remaining };
+}
+/**
+ * search_mc_source_semantic
+ * Semantic (vector) search over embedded MC source files.
+ * Falls back to FTS if Ollama is unavailable.
+ */
+export async function searchMcSourceSemantic(query, version, limit = 10, provenance) {
+    const row = await findMcVersionByVersionId(version);
+    if (!row) {
+        throw new Error(`Version "${version}" is not in the database. Run index_minecraft_version("${version}") first.`);
+    }
+    const vec = await embed(query);
+    const rows = await searchSourceByVector(vec, row.id, limit, provenance);
+    return rows.map(r => ({ className: r.class_name, similarity: Math.round(r.similarity * 1000) / 1000, source: r.embed_source ?? "local" }));
+}
+// ── Mod source semantic index / search ────────────────────────────────────────
+/**
+ * index_mod_source_fts
+ * Walks the decompiled source tree of a mod and upserts every .java file into
+ * mod_source_files. This populates both the PostgreSQL GIN index and the SQLite
+ * FTS5 virtual table (via triggers) — no Ollama required.
+ * Safe to re-run; already-indexed files are updated in-place.
+ */
+export async function indexModSourceFts(dbId) {
+    const mod = await findModById(dbId);
+    if (!mod)
+        throw new Error(`Mod #${dbId} not found`);
+    if (!mod.decompPath)
+        throw new Error(`Mod #${dbId} has no decompiled source. Run mod decompile first.`);
+    const javaFiles = await collectJavaFiles(mod.decompPath);
+    let indexed = 0;
+    let skipped = 0;
+    const BATCH = 50;
+    for (let i = 0; i < javaFiles.length; i += BATCH) {
+        for (const filePath of javaFiles.slice(i, i + BATCH)) {
+            const relPath = relative(mod.decompPath, filePath);
+            const className = relPath.replace(/\\/g, "/").replace(/\.java$/, "");
+            try {
+                const content = await readFile(filePath, "utf8");
+                await upsertModSourceFile(dbId, className, content);
+                indexed++;
+            }
+            catch {
+                skipped++;
+            }
+        }
+    }
+    return { status: "done", indexed, skipped };
+}
+/**
+ * search_mod_source_indexed
+ * BM25-ranked FTS search over indexed mod source files.
+ * Works for any loader (fabric, neoforge, forge, quilt) — mods are filtered by dbId.
+ * Requires index_fts (or index_semantic) to have been run first.
+ */
+export async function searchModSourceIndexed(dbId, query, limit = 20) {
+    const mod = await findModById(dbId);
+    if (!mod)
+        throw new Error(`Mod #${dbId} not found`);
+    return searchModSourceFiles(dbId, query, limit);
+}
+/**
+ * index_mod_source_semantic
+ * Walks the decompiled source tree of a mod (by dbId), upserts each .java file
+ * into mod_source_files (also populates FTS index), then embeds each file in
+ * batches using Ollama.
+ */
+export async function indexModSourceSemantic(dbId, batchSize = 50, maxFiles) {
+    if (!await isOllamaAvailable()) {
+        throw new Error("Ollama is not available. Set OLLAMA_URL and ensure Ollama is running with `ollama pull nomic-embed-text`.");
+    }
+    // Reuse FTS indexer for the file-walk step (also populates FTS index)
+    const { indexed, skipped: walkSkipped } = await indexModSourceFts(dbId);
+    // Embed in batches — always fetch from offset 0 so we never skip
+    // unembedded rows that were inserted after a previous failed run
+    let embedded = 0;
+    let embedSkipped = 0;
+    let firstError = "";
+    const cap = maxFiles ?? Infinity;
+    while (embedded + embedSkipped < cap) {
+        const batch = await findModSourceFilesUnembedded(dbId, Math.min(batchSize, cap - embedded - embedSkipped), 0);
+        if (!batch.length)
+            break;
+        for (const file of batch) {
+            if (embedded + embedSkipped >= cap)
+                break;
+            try {
+                const chunkSize = parseInt(process.env.OLLAMA_EMBED_CHUNK ?? "500", 10);
+                const chunk = chunkText(file.content, chunkSize)[0];
+                const vec = await embed(chunk);
+                await upsertModSourceEmbedding(file.id, vec);
+                embedded++;
+            }
+            catch (err) {
+                embedSkipped++;
+                if (!firstError)
+                    firstError = err instanceof Error ? err.message : String(err);
+                if (embedded + embedSkipped <= 3) {
+                    console.error(`[embed] skip ${file.id}: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+        }
+        await new Promise(r => setTimeout(r, 50));
+    }
+    const remaining = await countUnembeddedModSourceFiles(dbId);
+    return { status: "done", indexed, embedded, skipped: walkSkipped + embedSkipped, remaining, ...(firstError ? { error: firstError } : {}) };
+}
+/**
+ * search_mod_source_semantic
+ * Semantic (vector) search over embedded mod source files for a given dbId.
+ */
+export async function searchModSourceSemantic(query, dbId, limit = 10, provenance) {
+    if (!await isOllamaAvailable()) {
+        throw new Error("Ollama is not available. Set OLLAMA_URL and ensure Ollama is running with `ollama pull nomic-embed-text`.");
+    }
+    const mod = await findModById(dbId);
+    if (!mod)
+        throw new Error(`Mod #${dbId} not found`);
+    const vec = await embed(query);
+    const rows = await searchModSourceByVector(vec, dbId, limit, provenance);
+    return rows.map(r => ({
+        className: r.class_name,
+        modId: mod.modId,
+        similarity: Math.round(r.similarity * 1000) / 1000,
+        source: r.embed_source ?? "local",
+    }));
+}
+//# sourceMappingURL=mc-fts.js.map

package/dist/tools/mc-fts.js.map

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

package/dist/tools/mcmeta.d.ts

@@ -0,0 +1,41 @@
+/** List all available Minecraft versions from the summary branch. */
+export declare function getMcmetaVersions(filter?: "release" | "snapshot" | "all"): Promise<object>;
+/** Get block state properties and defaults for a MC version. */
+export declare function getMcBlocks(version?: string): Promise<object>;
+/** Get the Brigadier command tree for a MC version. */
+export declare function getMcCommands(version?: string): Promise<object>;
+/** Get registry list (summary) or a specific registry's entries. */
+export declare function getMcRegistries(version?: string, registry?: string): Promise<object>;
+/** Get sounds.json for a MC version. */
+export declare function getMcSounds(version?: string): Promise<object>;
+/** Get item component definitions for a MC version. */
+export declare function getMcItemComponents(version?: string): Promise<object>;
+/** Get or list files from the data/data-json branch (vanilla datapack). */
+export declare function getMcDataFile(filePath: string, version?: string, jsonOnly?: boolean): Promise<object>;
+/** Get or download a file from the assets branch. Binary files (png, ogg) return cached path. */
+export declare function getMcAssetFile(filePath: string, version?: string, jsonOnly?: boolean): Promise<object>;
+/** List files within a directory on a specific branch/version by reading cache or using the GitHub tree API. */
+export declare function listMcDataFiles(dirPath: string, version: string, branch: string): Promise<object>;
+/** Compare a data/asset file between two MC versions using the diff branch. */
+export declare function diffMcData(filePath: string, versionA: string, versionB: string, branch?: string): Promise<object>;
+/** Get texture atlas data from the atlas branch. */
+export declare function getMcAtlas(version?: string, atlas?: string): Promise<object>;
+/** Fetch any arbitrary file from mcmeta by specifying the full ref and path. */
+export declare function getMcmetaRaw(ref: string, filePath: string): Promise<object>;
+/** Get registry entries from the dedicated registries branch for a specific registry. */
+export declare function getRegistryEntries(registry: string, version?: string): Promise<object>;
+/**
+ * Compare two Minecraft versions using the GitHub compare API on the given branch.
+ * Returns the list of files added, modified, and removed between the two versions.
+ * Results are cached to ~/.modlens-cache/mcmeta/compare/{versionA}..{versionB}/{branch}.json
+ */
+export declare function compareVersions(versionA: string, versionB: string, branch?: string): Promise<object>;
+/**
+ * Get the list of files changed in a specific Minecraft version
+ * by comparing it to its parent commit in the given branch.
+ *
+ * Uses the GitHub commits API to fetch the diff for the version's commit.
+ * Results are cached to ~/.modlens-cache/mcmeta/changelog/{version}/{branch}.json
+ */
+export declare function getVersionChangelog(version: string, branch?: string): Promise<object>;
+//# sourceMappingURL=mcmeta.d.ts.map

package/dist/tools/mcmeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcmeta.d.ts","sourceRoot":"","sources":["../../src/tools/mcmeta.ts"],"names":[],"mappings":"AAqFA,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAShG;AAED,gEAAgE;AAChE,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,uDAAuD;AACvD,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED,oEAAoE;AACpE,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1F;AAED,wCAAwC;AACxC,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,uDAAuD;AACvD,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3E;AAED,2EAA2E;AAC3E,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,iGAAiG;AACjG,wBAAsB,cAAc,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,gHAAgH;AAChH,wBAAsB,eAAe,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED,+EAA+E;AAC/E,wBAAsB,UAAU,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,oDAAoD;AACpD,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAalF;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,yFAAyF;AACzF,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB5F;AAID;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CAsCjB"}