@creeperhost/modlens-mcp 1.6.0 → 1.6.4

package/dist/cli.js

@@ -83,273 +83,273 @@ function modIdArg(val, name) {
     return isNaN(n) ? s : n;
 }
 // ── Help ─────────────────────────────────────────────────────────────────────
-const HELP = `
-modlens CLI — analyze Minecraft mod JARs
-
-Usage: node dist/cli.js <command> [args] [--flags]
-
-DATABASE & CATALOG
-  stats                              DB statistics (mod count, classes, loaders)
-  list                               List all mods
-                                     [--loader=] [--mc-version=] [--has-mixins] [--decompiled] [--limit=50]
-  get <modId|dbId>                   Get full metadata for a mod
-  search <query>                     Search mods by name/id  [--loader=] [--mc-version=] [--limit=20]
-  deps <modId|dbId>                  List mod dependencies  [--recursive]
-
-INGEST
-  ingest <jarPath>                   Ingest a mod JAR  [--skip-source] [--skip-index]
-  ingest-neoforge <version>          Download + ingest NeoForge (e.g. 21.1.228)  [--skip-index]
-  ingest-forge <version>             Download + ingest Forge (e.g. 1.20.1-47.3.22)  [--skip-index]
-  ingest-fabric-api <version>        Download + ingest Fabric API (e.g. 0.116.11+1.21.1)  [--skip-index]
-  batch-ingest <dir>                 Ingest all JARs in a directory  [--index]
-  reindex                            Index class names for un-indexed mods  [--db-id=N]
-
-DECOMPILE & SOURCE
-  decompile <dbId>                   Decompile entire mod JAR with Vineflower
-  decompile-class <dbId> <class>     Decompile a single class (faster)
-  source <dbId> [path]               Browse or read decompiled source
-  search-source <query>              Search decompiled source  [--db-id=N] [--regex] [--limit=50]
-
-BYTECODE ANALYSIS
-  search-class <dbId> <query>        Search for a class by name
-  members <dbId> <class>             List methods and fields of a class
-  bytecode <dbId> <class>            Raw javap bytecode for a class
-  refs <dbId> <target>               Find references to a class/method/field
-  inheritance <dbId> <class>         Superclass, interfaces, subclasses
-  diff <dbIdA> <dbIdB>               Compare two mod versions (added/removed classes)
-
-MIXIN ANALYSIS
-  mixin-targets <modId|dbId>         MC classes this mod injects into
-  resolve-mixins <dbId>              Parse @Mixin bytecode and update DB targets
-  mixin-conflicts <targetClass>      All mods injecting into the same MC class
-  at-entries <dbId>                  Access Transformer entries
-  aw-entries <dbId>                  Access Widener entries
-
-PLATFORM
-  sync-modrinth <dbId>               Look up mod on Modrinth
-  sync-curseforge <dbId>             Look up mod on CurseForge
-  check-updates <dbId>               Check for newer versions
-  download-source <dbId>             Download GitHub/GitLab source
-
-VERSIONS
-  mc-versions                        List Minecraft versions  [--type=release|snapshot|all]
-  neoforge-versions                  List NeoForge versions  [--mc-version=1.21.1] [--limit=20]
-  fabric-api-versions                List Fabric API versions  [--mc-version=1.21.1] [--limit=20]
-
-BATCH
-  batch-resolve-mixins               Resolve @Mixin targets for all mixin mods
-
-MOD: ADDITIONAL ACTIONS
-  dep-graph                          Dependency graph for all ingested mods  [--mc-version=]
-  version-conflicts                  Find mods with conflicting version requirements
-  source-urls [query]                List Modrinth/CurseForge source URLs (filter by query)
-  decompile-status <dbId>            Decompilation progress for a mod
-  batch-decompile                    Decompile all un-decompiled mods  [--concurrency=2]
-  get-paths <dbId>                   JAR/decomp paths so you can grep natively
-  batch-sync                         Batch sync all mods from platform APIs
-                                     [--sync-modrinth] [--sync-curseforge] [--download-sources]
-                                     [--mod-id-filter=] [--limit=]
-
-MOD BYTECODE: ADVANCED
-  cross-refs <target>                Cross-mod references to a class/method/field
-                                     [--mc-version=] [--loader=] [--limit=]
-  diff-detailed <dbIdA> <dbIdB>      AST-level method/field diff with breaking-change flags
-                                     [--packages=a/b,c/d] [--limit=200] [--semantic] [--cache] [--force]
-  find-implementors <target>         Find all classes implementing an interface/extending a class
-                                     [--mod-id=] [--limit=] [--transitive]
-  scan-registrations <dbId>          Scan mod for registry object registrations
-  annotated-by <annotation>          Find classes annotated with a given annotation  [--mod-id=] [--limit=]
-  event-listeners <event>            Find event listener registrations  [--mod-id=] [--limit=]
-  optional-integrations <dbId>       Detect optional mod integrations (soft dependencies)
-  network-payloads <dbId>            Extract network packet/payload types
-  config-schema <dbId>               Extract configuration class schemas
-
-MIXIN ANALYSIS: ADVANCED
-  targets-in-package <packagePrefix> All mods targeting a class within a package  [--mc-version=]
-  at-conflicts                       AT/AW entries conflicting across mods  [--mc-version=] [--loader=]
-
-MIXIN SCAN (cross-mod conflict matrix)
-  mixin-scan list                    List mods with mixins  [--loader=] [--mc-version=]
-  mixin-scan conflict-matrix         Full mixin conflict matrix  [--loader=] [--mc-version=] [--min-conflicts=]
-  mixin-scan class-detail <class>    All mixins targeting a single MC class
-  mixin-scan hotspots                Most-targeted MC classes  [--top=N] [--loader=]
-  mixin-scan batch-resolve           Resolve mixin targets for all mods  [--loader=] [--mc-version=]
-
-VANILLA MC SOURCE
-  mc-source search-class <ver> <q>   Search for a vanilla class by name
-  mc-source get-source <ver> <class> Get decompiled vanilla source  [--start-line=] [--end-line=] [--max-lines=]
-  mc-source bytecode <ver> <class>   Raw javap bytecode for a vanilla class
-  mc-source class-members <ver> <c>  Methods and fields of a vanilla class
-  mc-source find-refs <ver> <target> References to a class/method/field in vanilla
-  mc-source inheritance <ver> <c>    Inheritance tree for a vanilla class
-  mc-source diff <verA> <verB>       High-level diff between two MC versions
-  mc-source diff-detailed <A> <B>    AST-level method/field diff  [--packages=] [--limit=200] [--semantic] [--cache] [--force]
-  mc-source decompile <ver>          Decompile MC version with Vineflower  [--force]
-  mc-source decompile-status <ver>   Check decompilation progress
-  mc-source search-code <ver> <q>    Full-text search over vanilla source  [--search-type=content|class|method|field|all] [--regex] [--limit=50]
-  mc-source index <ver>              Index vanilla source for BM25 search  [--force]
-  mc-source search-indexed <ver> <q> BM25-ranked FTS over vanilla source  [--limit=20]
-  mc-source search-events <ver>      Browse event classes  [query]  [--modloader=minecraft|neoforge|fabric|fabric-api]
-  mc-source validate-aw <ver> <file> Validate an .accesswidener file against vanilla
-  mc-source analyze-mixin <ver> <f>  Analyze a mixin Java source file
-  mc-source search-semantic <ver> <q> Semantic search (requires Ollama + index)  [--limit=10]
-  mc-source get-paths <ver>          On-disk jar/decomp/index paths
-
-MAPPINGS
-  mappings find <sym> <ver> <src> <tgt>  Translate symbol between namespaces (official|intermediary|yarn|mojmap)
-  mappings remap <in.jar> <out.jar> <ver> <mapping>  Remap a JAR between namespaces
-  mappings parchment <class> <mcVersion>  Parchment parameter/javadoc for a class
-  mappings list-parchment <mcVersion>     Available Parchment versions
-  mappings parchment-summary <mcVersion>  Stats on Parchment coverage
-
-DOCS
-  docs seed                          Seed built-in documentation entries
-  docs get <query>                   Get documentation by title/class
-  docs search <query>                Keyword search  [--category=] [--namespace=]
-  docs list                          List all docs  [--category=] [--namespace=] [--tag=] [--limit=100]
-  docs delete <id>                   Delete a doc entry by ID
-  docs semantic-search <query>       Semantic search (requires Ollama)  [--limit=10]
-
-PRIMERS (version migration guides)
-  primers seed                       Seed built-in porting primers
-  primers get <id>                   Get primer by ID
-  primers by-version <from> <to>     Get primers for a version range  [--modloader=]
-  primers search <query>             Keyword search  [--modloader=] [--limit=]
-  primers list                       List all primers  [--modloader=] [--limit=]
-  primers delete <id>                Delete a primer by ID
-  primers semantic-search <query>    Semantic search (requires Ollama)  [--limit=10]
-
-MC REGISTRY
-  mc-registry blocks                 Vanilla block list  [--version=]
-  mc-registry commands               Vanilla command tree  [--version=]
-  mc-registry registries             Registry keys  [--version=] [--registry=]
-  mc-registry sounds                 Sound event list  [--version=]
-  mc-registry item-components        Item component types  [--version=]
-  mc-registry registry-entries <reg> Entries in a registry  [--version=]
-  mc-registry mcmeta-versions        Versions index  [--filter=release|snapshot|all]
-
-MC DATA
-  mc-data tags                       Vanilla data tags  [--version=] [--registry=] [--tag-id=] [--namespace=]
-  mc-data find-tags-for <entry>      Tags containing an entry  --registry=  [--version=] [--namespace=]
-  mc-data recipes                    Recipe list  [--version=] [--type=] [--output-item=]
-  mc-data get-recipe <id>            Single recipe  [--version=]
-  mc-data find-recipes-for <item>    Recipes producing an item  [--version=]
-  mc-data loot-tables                Loot table list  [--version=] [--category=]
-  mc-data get-loot-table <path>      Single loot table  [--version=]
-  mc-data lang                       Language entries  [--version=] [--filter=] [--limit=]
-  mc-data blockstate <block>         Blockstate JSON  [--version=]
-  mc-data model <path>               Model JSON  [--version=] [--resolve-parents]
-  mc-data model-tree <path>          Model parent chain  [--version=]
-  mc-data biomes                     Biome list  [--version=]
-  mc-data get-biome <id>             Biome data  [--version=]
-  mc-data damage-types               Damage type list  [--version=]
-  mc-data enchantments               Enchantment list  [--version=]
-  mc-data get-enchantment <id>       Enchantment data  [--version=]
-  mc-data advancements               Advancement list  [--version=] [--category=]
-  mc-data get-advancement <id>       Advancement data  [--version=]
-  mc-data structures                 Structure list  [--version=]
-  mc-data get-structure <id>         Structure data  [--version=]
-  mc-data particles                  Particle list  [--version=]
-  mc-data get-particle <id>          Particle data  [--version=]
-  mc-data entity-attributes          Entity attribute list  [--entity=] [--version=] [--mod-id=]
-
-MC FILES (misode/mcmeta assets)
-  mc-files get-data <path>           Get a data-pack file  [--version=] [--json-only]
-  mc-files get-asset <path>          Get an assets file  [--version=] [--json-only]
-  mc-files list-files <dir>          List files in a branch dir  --version=  [--branch=]
-  mc-files diff <path>               Diff a file across versions  --version-a=  --version-b=  [--branch=data]
-  mc-files atlas                     Atlas sprite map  [--version=] [--atlas=blocks]
-  mc-files raw <path>                Raw file by git ref  --ref=  
-  mc-files compare                   Compare two versions summary  --version-a=  --version-b=  [--branch=]
-  mc-files changelog                 Version changelog  --version=  [--branch=]
-
-MOD JAR (file browser)
-  mod-jar list-files <modId>         List files inside the JAR  [--prefix=]
-  mod-jar get-file <modId>           Read a JAR file  --path=
-  mod-jar lang <modId>               Language entries  [--filter=] [--limit=]
-  mod-jar sounds <modId>             Sound events  [--namespace=]
-  mod-jar atlas <modId>              Atlas sprite map  [--atlas=] [--namespace=]
-  mod-jar registry-entries <modId>   Custom registry entries  [--type=] [--filter=] [--limit=]
-  mod-jar manifest <modId>           mod.json / mods.toml / fabric.mod.json manifest
-  mod-jar list-configs <modId>       List config files in JAR
-  mod-jar get-config <modId>         Read a config file  --path=
-
-MOD DATA (structured data from JAR)
-  mod-data list <modId> <type>       List data entries  [--namespace=] [--filter=]
-  mod-data get <modId> <type> <id>   Get a data entry  [--namespace=] [--registry=] [--model-path=]
-  mod-data diff <dbIdA> <dbIdB>      Diff data between two mod versions  [--data-type=]
-  mod-data trace-item <itemId>       Trace crafting recipe chain  [--max-depth=]
-
-MOD TAGS (cross-mod data-pack tags)
-  mod-tags index <modId>             Index data-pack tags for one mod
-  mod-tags index-all                 Index tags for all ingested mods
-  mod-tags namespaces                List all tag namespaces
-  mod-tags contributors <tagPath>    Mods contributing to a tag  [--registry=]
-  mod-tags expand <tagPath>          Recursively expand a tag  [--registry=] [--max-depth=]
-  mod-tags mod-list <modId>          Tags provided by a mod  [--registry=]
-  mod-tags find-conflicts            Tags with replace:true conflicts  [--registry=]
-  mod-tags search <query>            Search tags  [--registry=] [--limit=]
-
-GRADLE
-  gradle get-files <modId>           Extract Gradle build files
-  gradle search <query>              Search Gradle files across mods  [--mod-id-filter=] [--limit=]
-  gradle compare-deps                Compare dependency versions across mods  [--group-filter=] [--mod-id-filter=]
-
-REPORTS (generate Markdown)
-  report mixin-conflicts             [--loader=] [--mc-version=] [--min-conflicts=] [--save-path=]
-  report tag-conflicts               [--registry=] [--save-path=]
-  report version-conflicts           [--save-path=]
-  report mod-overview                --mod-id=  [--save-path=]
-  report gradle-deps                 [--group-filter=] [--mod-id-filter=] [--save-path=]
-  report pack-compat                 --mod-id=  [--save-path=]
-  report dep-graph                   [--mc-version=] [--save-path=]
-  report sidedness                   [--db-ids=1,2,3] [--save-path=]
-  report mod-complexity              [--db-ids=1,2,3] [--save-path=]
-  report pack-changelog              --old-ids=1,2  --new-ids=3,4  [--save-path=]
-
-PACK TOOLS
-  pack-tools asset-conflicts         Asset path conflicts  [--asset-type=textures|models|sounds|...] [--mc-version=] [--loader=] [--limit=]
-  pack-tools vanilla-overrides       Mods overriding vanilla data/assets  [--override-type=data|assets|all] [--data-subtype=] [--mc-version=] [--loader=]
-  pack-tools sidedness <modId>       Classify a mod as client/common/server
-  pack-tools pack-sidedness          Classify all mods by sidedness  [--mc-version=] [--loader=]
-  pack-tools complexity              Mod complexity scores  [--mc-version=] [--loader=]
-  pack-tools pack-changelog          Diff two pack snapshots  --old-ids=1,2  --new-ids=3,4
-  pack-tools data-conflicts          Data path conflicts  [--data-type=recipe|loot_tables|...] [--mc-version=] [--loader=] [--limit=]
-
-KUBEJS
-  kubejs index <scriptsDir>          Index a kubejs/ scripts directory
-  kubejs search <scriptsDir> <query> Search indexed KubeJS scripts  [--limit=]
-
-MODPACKS.CH
-  modpacks search <query>            Search modpacks  [--namespace=ftb|curseforge] [--limit=20]
-  modpacks featured                  Featured packs  [--limit=20]
-  modpacks info <packId>             Pack metadata  [--namespace=]
-  modpacks manifest <packId> <verId> Pack manifest  [--namespace=]
-  modpacks list-versions             Pack version list  [--namespace=] [--pack-id=]
-  modpacks list-files                Pack file list  [--namespace=] [--pack-id=] [--version-id=] [--file-type=]
-  modpacks ftb-mod-info <modId>      FTB mod info  [--mc-version=] [--loader=]
-  modpacks find-mod                  Find a mod across packs  [--mod-db-id=] [--cf-project=]
-
-DIAGNOSTICS
-  crash-log <logPath>                Analyze a crash log file (ranked suspect mods)
-  missing-deps                       Find declared deps not satisfied in DB  [--mc-version=] [--loader=]
-  compat-check <jarPath>             Quick mod compatibility check  [--mc-version=] [--loader=]
-
-FTS / INDEXED SEARCH (no Ollama required)
-  index-fts <dbId>                   Index decompiled mod source for BM25/FTS search
-                                     Works for all loaders: NeoForge, Fabric, Forge, Quilt
-  search-indexed <dbId> <query>      BM25-ranked FTS search over indexed mod source  [--limit=20]
-
-SEMANTIC SEARCH (optional — requires Ollama)
-  backfill-embeddings                Embed all docs/primers/mc-source for semantic search
-                                     [--type=docs|primers|source] [--version=<mc-version>]
-                                     (omit --type to run docs + primers; --type=source needs --version)
-
-Environment:
-  DATABASE_URL        PostgreSQL connection string (required)
-  OLLAMA_URL          Ollama base URL for semantic search (optional, default http://localhost:11434)
-  OLLAMA_EMBED_MODEL  Ollama embedding model (optional, default nomic-embed-text)
-  CURSEFORGE_API_KEY  CurseForge API key (optional, needed for sync-curseforge)
+const HELP = `
+modlens CLI — analyze Minecraft mod JARs
+
+Usage: node dist/cli.js <command> [args] [--flags]
+
+DATABASE & CATALOG
+  stats                              DB statistics (mod count, classes, loaders)
+  list                               List all mods
+                                     [--loader=] [--mc-version=] [--has-mixins] [--decompiled] [--limit=50]
+  get <modId|dbId>                   Get full metadata for a mod
+  search <query>                     Search mods by name/id  [--loader=] [--mc-version=] [--limit=20]
+  deps <modId|dbId>                  List mod dependencies  [--recursive]
+
+INGEST
+  ingest <jarPath>                   Ingest a mod JAR  [--skip-source] [--skip-index]
+  ingest-neoforge <version>          Download + ingest NeoForge (e.g. 21.1.228)  [--skip-index]
+  ingest-forge <version>             Download + ingest Forge (e.g. 1.20.1-47.3.22)  [--skip-index]
+  ingest-fabric-api <version>        Download + ingest Fabric API (e.g. 0.116.11+1.21.1)  [--skip-index]
+  batch-ingest <dir>                 Ingest all JARs in a directory  [--index]
+  reindex                            Index class names for un-indexed mods  [--db-id=N]
+
+DECOMPILE & SOURCE
+  decompile <dbId>                   Decompile entire mod JAR with Vineflower
+  decompile-class <dbId> <class>     Decompile a single class (faster)
+  source <dbId> [path]               Browse or read decompiled source
+  search-source <query>              Search decompiled source  [--db-id=N] [--regex] [--limit=50]
+
+BYTECODE ANALYSIS
+  search-class <dbId> <query>        Search for a class by name
+  members <dbId> <class>             List methods and fields of a class
+  bytecode <dbId> <class>            Raw javap bytecode for a class
+  refs <dbId> <target>               Find references to a class/method/field
+  inheritance <dbId> <class>         Superclass, interfaces, subclasses
+  diff <dbIdA> <dbIdB>               Compare two mod versions (added/removed classes)
+
+MIXIN ANALYSIS
+  mixin-targets <modId|dbId>         MC classes this mod injects into
+  resolve-mixins <dbId>              Parse @Mixin bytecode and update DB targets
+  mixin-conflicts <targetClass>      All mods injecting into the same MC class
+  at-entries <dbId>                  Access Transformer entries
+  aw-entries <dbId>                  Access Widener entries
+
+PLATFORM
+  sync-modrinth <dbId>               Look up mod on Modrinth
+  sync-curseforge <dbId>             Look up mod on CurseForge
+  check-updates <dbId>               Check for newer versions
+  download-source <dbId>             Download GitHub/GitLab source
+
+VERSIONS
+  mc-versions                        List Minecraft versions  [--type=release|snapshot|all]
+  neoforge-versions                  List NeoForge versions  [--mc-version=1.21.1] [--limit=20]
+  fabric-api-versions                List Fabric API versions  [--mc-version=1.21.1] [--limit=20]
+
+BATCH
+  batch-resolve-mixins               Resolve @Mixin targets for all mixin mods
+
+MOD: ADDITIONAL ACTIONS
+  dep-graph                          Dependency graph for all ingested mods  [--mc-version=]
+  version-conflicts                  Find mods with conflicting version requirements
+  source-urls [query]                List Modrinth/CurseForge source URLs (filter by query)
+  decompile-status <dbId>            Decompilation progress for a mod
+  batch-decompile                    Decompile all un-decompiled mods  [--concurrency=2]
+  get-paths <dbId>                   JAR/decomp paths so you can grep natively
+  batch-sync                         Batch sync all mods from platform APIs
+                                     [--sync-modrinth] [--sync-curseforge] [--download-sources]
+                                     [--mod-id-filter=] [--limit=]
+
+MOD BYTECODE: ADVANCED
+  cross-refs <target>                Cross-mod references to a class/method/field
+                                     [--mc-version=] [--loader=] [--limit=]
+  diff-detailed <dbIdA> <dbIdB>      AST-level method/field diff with breaking-change flags
+                                     [--packages=a/b,c/d] [--limit=200] [--semantic] [--cache] [--force]
+  find-implementors <target>         Find all classes implementing an interface/extending a class
+                                     [--mod-id=] [--limit=] [--transitive]
+  scan-registrations <dbId>          Scan mod for registry object registrations
+  annotated-by <annotation>          Find classes annotated with a given annotation  [--mod-id=] [--limit=]
+  event-listeners <event>            Find event listener registrations  [--mod-id=] [--limit=]
+  optional-integrations <dbId>       Detect optional mod integrations (soft dependencies)
+  network-payloads <dbId>            Extract network packet/payload types
+  config-schema <dbId>               Extract configuration class schemas
+
+MIXIN ANALYSIS: ADVANCED
+  targets-in-package <packagePrefix> All mods targeting a class within a package  [--mc-version=]
+  at-conflicts                       AT/AW entries conflicting across mods  [--mc-version=] [--loader=]
+
+MIXIN SCAN (cross-mod conflict matrix)
+  mixin-scan list                    List mods with mixins  [--loader=] [--mc-version=]
+  mixin-scan conflict-matrix         Full mixin conflict matrix  [--loader=] [--mc-version=] [--min-conflicts=]
+  mixin-scan class-detail <class>    All mixins targeting a single MC class
+  mixin-scan hotspots                Most-targeted MC classes  [--top=N] [--loader=]
+  mixin-scan batch-resolve           Resolve mixin targets for all mods  [--loader=] [--mc-version=]
+
+VANILLA MC SOURCE
+  mc-source search-class <ver> <q>   Search for a vanilla class by name
+  mc-source get-source <ver> <class> Get decompiled vanilla source  [--start-line=] [--end-line=] [--max-lines=]
+  mc-source bytecode <ver> <class>   Raw javap bytecode for a vanilla class
+  mc-source class-members <ver> <c>  Methods and fields of a vanilla class
+  mc-source find-refs <ver> <target> References to a class/method/field in vanilla
+  mc-source inheritance <ver> <c>    Inheritance tree for a vanilla class
+  mc-source diff <verA> <verB>       High-level diff between two MC versions
+  mc-source diff-detailed <A> <B>    AST-level method/field diff  [--packages=] [--limit=200] [--semantic] [--cache] [--force]
+  mc-source decompile <ver>          Decompile MC version with Vineflower  [--force]
+  mc-source decompile-status <ver>   Check decompilation progress
+  mc-source search-code <ver> <q>    Full-text search over vanilla source  [--search-type=content|class|method|field|all] [--regex] [--limit=50]
+  mc-source index <ver>              Index vanilla source for BM25 search  [--force]
+  mc-source search-indexed <ver> <q> BM25-ranked FTS over vanilla source  [--limit=20]
+  mc-source search-events <ver>      Browse event classes  [query]  [--modloader=minecraft|neoforge|fabric|fabric-api]
+  mc-source validate-aw <ver> <file> Validate an .accesswidener file against vanilla
+  mc-source analyze-mixin <ver> <f>  Analyze a mixin Java source file
+  mc-source search-semantic <ver> <q> Semantic search (requires Ollama + index)  [--limit=10]
+  mc-source get-paths <ver>          On-disk jar/decomp/index paths
+
+MAPPINGS
+  mappings find <sym> <ver> <src> <tgt>  Translate symbol between namespaces (official|intermediary|yarn|mojmap)
+  mappings remap <in.jar> <out.jar> <ver> <mapping>  Remap a JAR between namespaces
+  mappings parchment <class> <mcVersion>  Parchment parameter/javadoc for a class
+  mappings list-parchment <mcVersion>     Available Parchment versions
+  mappings parchment-summary <mcVersion>  Stats on Parchment coverage
+
+DOCS
+  docs seed                          Seed built-in documentation entries
+  docs get <query>                   Get documentation by title/class
+  docs search <query>                Keyword search  [--category=] [--namespace=]
+  docs list                          List all docs  [--category=] [--namespace=] [--tag=] [--limit=100]
+  docs delete <id>                   Delete a doc entry by ID
+  docs semantic-search <query>       Semantic search (requires Ollama)  [--limit=10]
+
+PRIMERS (version migration guides)
+  primers seed                       Seed built-in porting primers
+  primers get <id>                   Get primer by ID
+  primers by-version <from> <to>     Get primers for a version range  [--modloader=]
+  primers search <query>             Keyword search  [--modloader=] [--limit=]
+  primers list                       List all primers  [--modloader=] [--limit=]
+  primers delete <id>                Delete a primer by ID
+  primers semantic-search <query>    Semantic search (requires Ollama)  [--limit=10]
+
+MC REGISTRY
+  mc-registry blocks                 Vanilla block list  [--version=]
+  mc-registry commands               Vanilla command tree  [--version=]
+  mc-registry registries             Registry keys  [--version=] [--registry=]
+  mc-registry sounds                 Sound event list  [--version=]
+  mc-registry item-components        Item component types  [--version=]
+  mc-registry registry-entries <reg> Entries in a registry  [--version=]
+  mc-registry mcmeta-versions        Versions index  [--filter=release|snapshot|all]
+
+MC DATA
+  mc-data tags                       Vanilla data tags  [--version=] [--registry=] [--tag-id=] [--namespace=]
+  mc-data find-tags-for <entry>      Tags containing an entry  --registry=  [--version=] [--namespace=]
+  mc-data recipes                    Recipe list  [--version=] [--type=] [--output-item=]
+  mc-data get-recipe <id>            Single recipe  [--version=]
+  mc-data find-recipes-for <item>    Recipes producing an item  [--version=]
+  mc-data loot-tables                Loot table list  [--version=] [--category=]
+  mc-data get-loot-table <path>      Single loot table  [--version=]
+  mc-data lang                       Language entries  [--version=] [--filter=] [--limit=]
+  mc-data blockstate <block>         Blockstate JSON  [--version=]
+  mc-data model <path>               Model JSON  [--version=] [--resolve-parents]
+  mc-data model-tree <path>          Model parent chain  [--version=]
+  mc-data biomes                     Biome list  [--version=]
+  mc-data get-biome <id>             Biome data  [--version=]
+  mc-data damage-types               Damage type list  [--version=]
+  mc-data enchantments               Enchantment list  [--version=]
+  mc-data get-enchantment <id>       Enchantment data  [--version=]
+  mc-data advancements               Advancement list  [--version=] [--category=]
+  mc-data get-advancement <id>       Advancement data  [--version=]
+  mc-data structures                 Structure list  [--version=]
+  mc-data get-structure <id>         Structure data  [--version=]
+  mc-data particles                  Particle list  [--version=]
+  mc-data get-particle <id>          Particle data  [--version=]
+  mc-data entity-attributes          Entity attribute list  [--entity=] [--version=] [--mod-id=]
+
+MC FILES (misode/mcmeta assets)
+  mc-files get-data <path>           Get a data-pack file  [--version=] [--json-only]
+  mc-files get-asset <path>          Get an assets file  [--version=] [--json-only]
+  mc-files list-files <dir>          List files in a branch dir  --version=  [--branch=]
+  mc-files diff <path>               Diff a file across versions  --version-a=  --version-b=  [--branch=data]
+  mc-files atlas                     Atlas sprite map  [--version=] [--atlas=blocks]
+  mc-files raw <path>                Raw file by git ref  --ref=  
+  mc-files compare                   Compare two versions summary  --version-a=  --version-b=  [--branch=]
+  mc-files changelog                 Version changelog  --version=  [--branch=]
+
+MOD JAR (file browser)
+  mod-jar list-files <modId>         List files inside the JAR  [--prefix=]
+  mod-jar get-file <modId>           Read a JAR file  --path=
+  mod-jar lang <modId>               Language entries  [--filter=] [--limit=]
+  mod-jar sounds <modId>             Sound events  [--namespace=]
+  mod-jar atlas <modId>              Atlas sprite map  [--atlas=] [--namespace=]
+  mod-jar registry-entries <modId>   Custom registry entries  [--type=] [--filter=] [--limit=]
+  mod-jar manifest <modId>           mod.json / mods.toml / fabric.mod.json manifest
+  mod-jar list-configs <modId>       List config files in JAR
+  mod-jar get-config <modId>         Read a config file  --path=
+
+MOD DATA (structured data from JAR)
+  mod-data list <modId> <type>       List data entries  [--namespace=] [--filter=]
+  mod-data get <modId> <type> <id>   Get a data entry  [--namespace=] [--registry=] [--model-path=]
+  mod-data diff <dbIdA> <dbIdB>      Diff data between two mod versions  [--data-type=]
+  mod-data trace-item <itemId>       Trace crafting recipe chain  [--max-depth=]
+
+MOD TAGS (cross-mod data-pack tags)
+  mod-tags index <modId>             Index data-pack tags for one mod
+  mod-tags index-all                 Index tags for all ingested mods
+  mod-tags namespaces                List all tag namespaces
+  mod-tags contributors <tagPath>    Mods contributing to a tag  [--registry=]
+  mod-tags expand <tagPath>          Recursively expand a tag  [--registry=] [--max-depth=]
+  mod-tags mod-list <modId>          Tags provided by a mod  [--registry=]
+  mod-tags find-conflicts            Tags with replace:true conflicts  [--registry=]
+  mod-tags search <query>            Search tags  [--registry=] [--limit=]
+
+GRADLE
+  gradle get-files <modId>           Extract Gradle build files
+  gradle search <query>              Search Gradle files across mods  [--mod-id-filter=] [--limit=]
+  gradle compare-deps                Compare dependency versions across mods  [--group-filter=] [--mod-id-filter=]
+
+REPORTS (generate Markdown)
+  report mixin-conflicts             [--loader=] [--mc-version=] [--min-conflicts=] [--save-path=]
+  report tag-conflicts               [--registry=] [--save-path=]
+  report version-conflicts           [--save-path=]
+  report mod-overview                --mod-id=  [--save-path=]
+  report gradle-deps                 [--group-filter=] [--mod-id-filter=] [--save-path=]
+  report pack-compat                 --mod-id=  [--save-path=]
+  report dep-graph                   [--mc-version=] [--save-path=]
+  report sidedness                   [--db-ids=1,2,3] [--save-path=]
+  report mod-complexity              [--db-ids=1,2,3] [--save-path=]
+  report pack-changelog              --old-ids=1,2  --new-ids=3,4  [--save-path=]
+
+PACK TOOLS
+  pack-tools asset-conflicts         Asset path conflicts  [--asset-type=textures|models|sounds|...] [--mc-version=] [--loader=] [--limit=]
+  pack-tools vanilla-overrides       Mods overriding vanilla data/assets  [--override-type=data|assets|all] [--data-subtype=] [--mc-version=] [--loader=]
+  pack-tools sidedness <modId>       Classify a mod as client/common/server
+  pack-tools pack-sidedness          Classify all mods by sidedness  [--mc-version=] [--loader=]
+  pack-tools complexity              Mod complexity scores  [--mc-version=] [--loader=]
+  pack-tools pack-changelog          Diff two pack snapshots  --old-ids=1,2  --new-ids=3,4
+  pack-tools data-conflicts          Data path conflicts  [--data-type=recipe|loot_tables|...] [--mc-version=] [--loader=] [--limit=]
+
+KUBEJS
+  kubejs index <scriptsDir>          Index a kubejs/ scripts directory
+  kubejs search <scriptsDir> <query> Search indexed KubeJS scripts  [--limit=]
+
+MODPACKS.CH
+  modpacks search <query>            Search modpacks  [--namespace=ftb|curseforge] [--limit=20]
+  modpacks featured                  Featured packs  [--limit=20]
+  modpacks info <packId>             Pack metadata  [--namespace=]
+  modpacks manifest <packId> <verId> Pack manifest  [--namespace=]
+  modpacks list-versions             Pack version list  [--namespace=] [--pack-id=]
+  modpacks list-files                Pack file list  [--namespace=] [--pack-id=] [--version-id=] [--file-type=]
+  modpacks ftb-mod-info <modId>      FTB mod info  [--mc-version=] [--loader=]
+  modpacks find-mod                  Find a mod across packs  [--mod-db-id=] [--cf-project=]
+
+DIAGNOSTICS
+  crash-log <logPath>                Analyze a crash log file (ranked suspect mods)
+  missing-deps                       Find declared deps not satisfied in DB  [--mc-version=] [--loader=]
+  compat-check <jarPath>             Quick mod compatibility check  [--mc-version=] [--loader=]
+
+FTS / INDEXED SEARCH (no Ollama required)
+  index-fts <dbId>                   Index decompiled mod source for BM25/FTS search
+                                     Works for all loaders: NeoForge, Fabric, Forge, Quilt
+  search-indexed <dbId> <query>      BM25-ranked FTS search over indexed mod source  [--limit=20]
+
+SEMANTIC SEARCH (optional — requires Ollama)
+  backfill-embeddings                Embed all docs/primers/mc-source for semantic search
+                                     [--type=docs|primers|source] [--version=<mc-version>]
+                                     (omit --type to run docs + primers; --type=source needs --version)
+
+Environment:
+  DATABASE_URL        PostgreSQL connection string (required)
+  OLLAMA_URL          Ollama base URL for semantic search (optional, default http://localhost:11434)
+  OLLAMA_EMBED_MODEL  Ollama embedding model (optional, default nomic-embed-text)
+  CURSEFORGE_API_KEY  CurseForge API key (optional, needed for sync-curseforge)
 `.trim();
 // ── Commands ─────────────────────────────────────────────────────────────────
 if (!command || command === "--help" || command === "-h") {

package/dist/db-backend.d.ts

@@ -4,6 +4,19 @@
  */
 export type Backend = "postgres" | "pglite" | "sqlite";
 export declare function detectBackend(): Backend;
+/**
+ * Prisma case-insensitive `contains`/`equals` modifier, backend-aware.
+ *
+ * Postgres/PGlite support `mode: "insensitive"` (ILIKE). The SQLite Prisma
+ * connector rejects the `mode` argument entirely (`Unknown argument 'mode'`),
+ * but SQLite's `LIKE` is already case-insensitive for ASCII — so we omit it.
+ *
+ * Spread into a string filter:
+ *   { title: { contains: q, ...caseInsensitive() } }
+ */
+export declare function caseInsensitive(): {
+    mode?: "insensitive";
+};
 /**
  * Serialize an array to a JSON string for SQLite String columns.
  * On postgres/pglite, returns the original value unchanged.
@@ -13,5 +26,5 @@ export declare function serializeArray<T>(value: T[]): T[] | string;
  * Deserialize a SQLite JSON string column back to an array.
  * On postgres/pglite, returns the original value unchanged.
  */
-export declare function deserializeArray<T>(value: T[] | string | null | undefined): T[];
+export declare function deserializeArray<T>(value: unknown): T[];
 //# sourceMappingURL=db-backend.d.ts.map

package/dist/db-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-backend.d.ts","sourceRoot":"","sources":["../src/db-backend.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,wBAAgB,aAAa,IAAI,OAAO,CAOvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,CAK/E"}
+{"version":3,"file":"db-backend.d.ts","sourceRoot":"","sources":["../src/db-backend.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,wBAAgB,aAAa,IAAI,OAAO,CAOvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,CAE1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAKvD"}

package/dist/db-backend.js

@@ -13,6 +13,19 @@ export function detectBackend() {
     // case (zero-config embedded backend the launcher bootstraps on first run).
     return "sqlite";
 }
+/**
+ * Prisma case-insensitive `contains`/`equals` modifier, backend-aware.
+ *
+ * Postgres/PGlite support `mode: "insensitive"` (ILIKE). The SQLite Prisma
+ * connector rejects the `mode` argument entirely (`Unknown argument 'mode'`),
+ * but SQLite's `LIKE` is already case-insensitive for ASCII — so we omit it.
+ *
+ * Spread into a string filter:
+ *   { title: { contains: q, ...caseInsensitive() } }
+ */
+export function caseInsensitive() {
+    return detectBackend() === "sqlite" ? {} : { mode: "insensitive" };
+}
 /**
  * Serialize an array to a JSON string for SQLite String columns.
  * On postgres/pglite, returns the original value unchanged.

package/dist/db-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-backend.js","sourceRoot":"","sources":["../src/db-backend.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;GAGG;AAIH,MAAM,UAAU,aAAa;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,UAAU,CAAC;IACxF,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9E,0EAA0E;IAC1E,4EAA4E;IAC5E,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,KAAU;IACxC,IAAI,aAAa,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAI,KAAsC;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAQ,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IACjE,CAAC;IACD,OAAQ,KAAa,IAAI,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"db-backend.js","sourceRoot":"","sources":["../src/db-backend.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;GAGG;AAIH,MAAM,UAAU,aAAa;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,UAAU,CAAC;IACxF,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9E,0EAA0E;IAC1E,4EAA4E;IAC5E,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,aAAa,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,KAAU;IACxC,IAAI,aAAa,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAI,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAQ,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IACjE,CAAC;IACD,OAAQ,KAAa,IAAI,EAAE,CAAC;AAChC,CAAC"}