Skip to content

[Bug] v1.5.0 requires FTS5 which is missing in official Node.js builds #1532

Description

@xsdxq-null

This issue was generated by an AI assistant (Codex/OpenAI).

Description

codegraph v1.5.0 uses Node.js built-in node:sqlite and requires FTS5, but official Node.js binaries do not compile FTS5 by default. This causes codegraph init and codegraph index to fail on any standard Node.js installation.

Environment

  • OS: Windows 11 (also affects all platforms)
  • Node.js: v22.14.0 (official build from nodejs.org)
  • codegraph: v1.5.0
  • SQLite version: 3.47.2 (no ENABLE_FTS5 in compile_options)

Error

[ERR] Failed to index: no such module: fts5

Direct reproduction:`javascript
const { DatabaseSync } = require('node:sqlite');
const db = new DatabaseSync(':memory:');
db.exec('CREATE VIRTUAL TABLE t USING fts5(content)');
// Error: no such module: fts5
``n

Root Cause

Node.js node:sqlite module uses SQLite compiled WITHOUT FTS5 extension. codegraph v1.5.0 relies on FTS5 for full-text search (CREATE VIRTUAL TABLE ... USING fts5).

Suggestions

  1. Detect FTS5 at runtime, fallback to LIKE-based or FTS4 search
  2. Document FTS5 as a requirement
  3. Make FTS5 optional for basic indexing

Workaround

npm install -g @colbymchenry/codegraph@1.0.1

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions