Install FTS feature

[mohammad-kasaei-mohaymen]

Area

gitnexus (CLI / core / indexing / MCP server)

Summary

in a Debian environment
I try to install gitnexus@1.6.7
but I can not use FTS

Context

I am trying to install simply using npm but without network connection. I have an NPM mirror accessible not any other network connection.
but I can not use FTS.

{"level":40,"time":1781226045556,"name":"gitnexus","msg":"GitNexus: FTS extension unavailable; continuing without FTS features. load-only policy: extension not pre-installed"}
{"level":40,"time":1781226060702,"name":"gitnexus","msg":"GitNexus: FTS extension unavailable; continuing without FTS features. INSTALL fts timed out after 15000ms"}

Expected behavior

To be able to install the FTS extensions in the fully offline environment. independent of network connection.
Every dependency must be downloaded just from the NPM registry that I have no other parts of the internet because I don't have internet connection in my environment

Actual behavior

Does not have FTS in fully offline mode

Steps to reproduce

1. in a fully offline mode install gitnexus
2. try to analyze a repo

Environment

Doctor command

[INFO ] Analyze Doctor: GitNexus Doctor

Runtime
  OS:       linux/x64
  Node:     v22.22.3
  GitNexus: 1.6.7
  LadybugDB:unknown
  native    ✓ lbugjs.node loaded
  ONNX:     1.26.0

Capabilities
  Graph store:      available
  Full-text search: available
  VECTOR index:     available
  Semantic mode:    vector-index
  Ext install:      load-only (offline; load only, no network install)
  Exact scan limit: 10000 chunks

Embeddings
  Backend:    local
  Device:     auto
  Threads:    4
  Batch:      16 nodes
  Sub-batch:  8 chunks
  Support:    ✓ local embeddings supported

Logs / screenshots

Incremental: changed=0, added=0, deleted=0 (skipping wipe + 15 unchanged file rows preserved)
{"level":40,"time":1781226045556,"name":"gitnexus","msg":"GitNexus: FTS extension unavailable; continuing without FTS features. load-only policy: extension not pre-installed"}
{"level":40,"time":1781226060702,"name":"gitnexus","msg":"GitNexus: FTS extension unavailable; continuing without FTS features. INSTALL fts timed out after 15000ms"}
�[2K
FTS extension unavailable; skipping search-index creation. Full-text/BM25 search will be disabled until the LadybugDB FTS extension is installed once with network access (GITNEXUS_LBUG_EXTENSION_INSTALL=auto) or pre-installed for offline use. Run `gitnexus doctor` for details.

  Repository indexed successfully (17.0s)

  46 nodes | 36 edges | 0 clusters | 0 flows
  /app/repos/ai-knowledge-repo

  Warning: full-text/BM25 search is disabled — the LadybugDB FTS extension was unavailable.
  Install it once with network access (GITNEXUS_LBUG_EXTENSION_INSTALL=auto) then rerun, or
  run `gitnexus analyze --repair-fts` when connected. Run `gitnexus doctor` for details.

[honeweimimeng]

1.Download https://extension.ladybugdb.com/v0.17.0/linux_amd64/fts/libfts.lbug_extension to your machine,
2.create the ~/.lbdb/extension/0.17.0/linux_amd64/fts and ~/.lbdb/extension/0.17.0/linux_amd64/common directory
3.Place the file libfts.lbug_extension in the directory ~/.lbdb/extension/0.17.0/linux_amd64/fts
4.in repo root,execute command gitnexus analyze --repair-fts

[mohammad-kasaei-mohaymen]

Thanks for your suggestion. it is working. but I have a question is it good to have such a dependency. I think it is better to have a mechanism to download this from npm or somewhere directly