@tobilu/qmd 1.0.5 → 1.0.7

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## [Unreleased]
 
+## [1.0.7] - 2026-02-18
+
+### Changes
+
+- LLM: add LiquidAI LFM2-1.2B as an alternative base model for query
+  expansion fine-tuning. LFM2's hybrid architecture (convolutions + attention)
+  is 2x faster at decode/prefill vs standard transformers — good fit for
+  on-device inference.
+- CLI: support multiple `-c` flags to search across several collections at
+  once (e.g. `qmd search -c notes -c journals "query"`). #191 (thanks
+  @openclaw)
+
+### Fixes
+
+- Return empty JSON array `[]` instead of no output when `--json` search
+  finds no results.
+- Resolve relative paths passed to `--index` so they don't produce malformed
+  config entries.
+- Respect `XDG_CONFIG_HOME` for collection config path instead of always
+  using `~/.config`. #190 (thanks @openclaw)
+- CLI: empty-collection hint now shows the correct `collection add` command.
+  #200 (thanks @vincentkoc)
+
+## [1.0.6] - 2026-02-16
+
+### Changes
+
+- CLI: `qmd status` now shows models with full HuggingFace links instead of
+  static names in `--help`. Model info is derived from the actual configured
+  URIs so it stays accurate if models change.
+- Release tooling: pre-push hook handles non-interactive shells (CI, editors)
+  gracefully — warnings auto-proceed instead of hanging on a tty prompt.
+  Annotated tags now resolve correctly for CI checks.
+
 ## [1.0.5] - 2026-02-16
 
 The npm package now ships compiled JavaScript instead of raw TypeScript,

package/dist/collections.js

@@ -18,13 +18,27 @@ let currentIndexName = "index";
  * Config file will be ~/.config/qmd/{indexName}.yml
  */
 export function setConfigIndexName(name) {
-    currentIndexName = name;
+    // Resolve relative paths to absolute paths and sanitize for use as filename
+    if (name.includes('/')) {
+        const { resolve } = require('path');
+        const { cwd } = require('process');
+        const absolutePath = resolve(cwd(), name);
+        // Replace path separators with underscores to create a valid filename
+        currentIndexName = absolutePath.replace(/\//g, '_').replace(/^_/, '');
+    }
+    else {
+        currentIndexName = name;
+    }
 }
 function getConfigDir() {
     // Allow override via QMD_CONFIG_DIR for testing
     if (process.env.QMD_CONFIG_DIR) {
         return process.env.QMD_CONFIG_DIR;
     }
+    // Respect XDG Base Directory specification (consistent with store.ts)
+    if (process.env.XDG_CONFIG_HOME) {
+        return join(process.env.XDG_CONFIG_HOME, "qmd");
+    }
     return join(homedir(), ".config", "qmd");
 }
 function getConfigFilePath() {

package/dist/llm.d.ts

@@ -128,6 +128,8 @@ export type RerankDocument = {
     text: string;
     title?: string;
 };
+export declare const LFM2_GENERATE_MODEL = "hf:LiquidAI/LFM2-1.2B-GGUF/LFM2-1.2B-Q4_K_M.gguf";
+export declare const LFM2_INSTRUCT_MODEL = "hf:LiquidAI/LFM2.5-1.2B-Instruct-GGUF/LFM2.5-1.2B-Instruct-Q4_K_M.gguf";
 export declare const DEFAULT_EMBED_MODEL_URI = "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf";
 export declare const DEFAULT_RERANK_MODEL_URI = "hf:ggml-org/Qwen3-Reranker-0.6B-Q8_0-GGUF/qwen3-reranker-0.6b-q8_0.gguf";
 export declare const DEFAULT_GENERATE_MODEL_URI = "hf:tobil/qmd-query-expansion-1.7B-gguf/qmd-query-expansion-1.7B-q4_k_m.gguf";

package/dist/llm.js

@@ -33,6 +33,11 @@ const DEFAULT_EMBED_MODEL = "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma
 const DEFAULT_RERANK_MODEL = "hf:ggml-org/Qwen3-Reranker-0.6B-Q8_0-GGUF/qwen3-reranker-0.6b-q8_0.gguf";
 // const DEFAULT_GENERATE_MODEL = "hf:ggml-org/Qwen3-0.6B-GGUF/Qwen3-0.6B-Q8_0.gguf";
 const DEFAULT_GENERATE_MODEL = "hf:tobil/qmd-query-expansion-1.7B-gguf/qmd-query-expansion-1.7B-q4_k_m.gguf";
+// Alternative generation models for query expansion:
+// LiquidAI LFM2 - hybrid architecture optimized for edge/on-device inference
+// Use these as base for fine-tuning with configs/sft_lfm2.yaml
+export const LFM2_GENERATE_MODEL = "hf:LiquidAI/LFM2-1.2B-GGUF/LFM2-1.2B-Q4_K_M.gguf";
+export const LFM2_INSTRUCT_MODEL = "hf:LiquidAI/LFM2.5-1.2B-Instruct-GGUF/LFM2.5-1.2B-Instruct-Q4_K_M.gguf";
 export const DEFAULT_EMBED_MODEL_URI = DEFAULT_EMBED_MODEL;
 export const DEFAULT_RERANK_MODEL_URI = DEFAULT_RERANK_MODEL;
 export const DEFAULT_GENERATE_MODEL_URI = DEFAULT_GENERATE_MODEL;

package/dist/qmd.js

@@ -36,7 +36,16 @@ function getDbPath() {
     return store?.dbPath ?? storeDbPathOverride ?? getDefaultDbPath();
 }
 function setIndexName(name) {
-    storeDbPathOverride = name ? getDefaultDbPath(name) : undefined;
+    let normalizedName = name;
+    // Normalize relative paths to prevent malformed database paths
+    if (name && name.includes('/')) {
+        const { resolve } = require('path');
+        const { cwd } = require('process');
+        const absolutePath = resolve(cwd(), name);
+        // Replace path separators with underscores to create a valid filename
+        normalizedName = absolutePath.replace(/\//g, '_').replace(/^_/, '');
+    }
+    storeDbPathOverride = normalizedName ? getDefaultDbPath(normalizedName) : undefined;
     // Reset open handle so next use opens the new index
     closeDb();
 }
@@ -256,6 +265,18 @@ async function showStatus() {
     else {
         console.log(`\n${c.dim}No collections. Run 'qmd collection add .' to index markdown files.${c.reset}`);
     }
+    // Models
+    {
+        // hf:org/repo/file.gguf → https://huggingface.co/org/repo
+        const hfLink = (uri) => {
+            const match = uri.match(/^hf:([^/]+\/[^/]+)\//);
+            return match ? `https://huggingface.co/${match[1]}` : uri;
+        };
+        console.log(`\n${c.bold}Models${c.reset}`);
+        console.log(`  Embedding:   ${hfLink(DEFAULT_EMBED_MODEL_URI)}`);
+        console.log(`  Reranking:   ${hfLink(DEFAULT_RERANK_MODEL_URI)}`);
+        console.log(`  Generation:  ${hfLink(DEFAULT_GENERATE_MODEL_URI)}`);
+    }
     // Device / GPU info
     try {
         const llm = getDefaultLlamaCpp();
@@ -950,7 +971,7 @@ function listFiles(pathArg) {
         // No argument - list all collections
         const yamlCollections = yamlListCollections();
         if (yamlCollections.length === 0) {
-            console.log("No collections found. Run 'qmd add .' to index files.");
+            console.log("No collections found. Run 'qmd collection add .' to index files.");
             closeDb();
             return;
         }
@@ -1074,7 +1095,7 @@ function collectionList() {
     const db = getDb();
     const collections = listCollections(db);
     if (collections.length === 0) {
-        console.log("No collections found. Run 'qmd add .' to create one.");
+        console.log("No collections found. Run 'qmd collection add .' to create one.");
         closeDb();
         return;
     }
@@ -1604,22 +1625,42 @@ function outputResults(results, query, opts) {
         }
     }
 }
-function search(query, opts) {
-    const db = getDb();
-    // Validate collection filter if specified
-    let collectionName;
-    if (opts.collection) {
-        const coll = getCollectionFromYaml(opts.collection);
+// Resolve -c collection filter: supports single string, array, or undefined.
+// Returns validated collection names (exits on unknown collection).
+function resolveCollectionFilter(raw) {
+    if (!raw)
+        return [];
+    const names = Array.isArray(raw) ? raw : [raw];
+    const validated = [];
+    for (const name of names) {
+        const coll = getCollectionFromYaml(name);
         if (!coll) {
-            console.error(`Collection not found: ${opts.collection}`);
+            console.error(`Collection not found: ${name}`);
             closeDb();
             process.exit(1);
         }
-        collectionName = opts.collection;
+        validated.push(name);
     }
+    return validated;
+}
+// Post-filter results to only include files from specified collections.
+function filterByCollections(results, collectionNames) {
+    if (collectionNames.length <= 1)
+        return results;
+    const prefixes = collectionNames.map(n => `qmd://${n}/`);
+    return results.filter(r => {
+        const path = r.filepath || r.file || '';
+        return prefixes.some(p => path.startsWith(p));
+    });
+}
+function search(query, opts) {
+    const db = getDb();
+    // Validate collection filter (supports multiple -c flags)
+    const collectionNames = resolveCollectionFilter(opts.collection);
+    const singleCollection = collectionNames.length === 1 ? collectionNames[0] : undefined;
     // Use large limit for --all, otherwise fetch more than needed and let outputResults filter
     const fetchLimit = opts.all ? 100000 : Math.max(50, opts.limit * 2);
-    const results = searchFTS(db, query, fetchLimit, collectionName);
+    const results = filterByCollections(searchFTS(db, query, fetchLimit, singleCollection), collectionNames);
     // Add context to results
     const resultsWithContext = results.map(r => ({
         file: r.filepath,
@@ -1633,7 +1674,12 @@ function search(query, opts) {
     }));
     closeDb();
     if (resultsWithContext.length === 0) {
-        console.log("No results found.");
+        if (opts.format === "json") {
+            console.log("[]");
+        }
+        else {
+            console.log("No results found.");
+        }
         return;
     }
     outputResults(resultsWithContext, query, opts);
@@ -1656,18 +1702,13 @@ function logExpansionTree(originalQuery, expanded) {
 }
 async function vectorSearch(query, opts, _model = DEFAULT_EMBED_MODEL) {
     const store = getStore();
-    if (opts.collection) {
-        const coll = getCollectionFromYaml(opts.collection);
-        if (!coll) {
-            console.error(`Collection not found: ${opts.collection}`);
-            closeDb();
-            process.exit(1);
-        }
-    }
+    // Validate collection filter (supports multiple -c flags)
+    const collectionNames = resolveCollectionFilter(opts.collection);
+    const singleCollection = collectionNames.length === 1 ? collectionNames[0] : undefined;
     checkIndexHealth(store.db);
     await withLLMSession(async () => {
-        const results = await vectorSearchQuery(store, query, {
-            collection: opts.collection,
+        let results = await vectorSearchQuery(store, query, {
+            collection: singleCollection,
             limit: opts.all ? 500 : (opts.limit || 10),
             minScore: opts.minScore || 0.3,
             hooks: {
@@ -1677,9 +1718,21 @@ async function vectorSearch(query, opts, _model = DEFAULT_EMBED_MODEL) {
                 },
             },
         });
+        // Post-filter for multi-collection
+        if (collectionNames.length > 1) {
+            results = results.filter(r => {
+                const prefixes = collectionNames.map(n => `qmd://${n}/`);
+                return prefixes.some(p => r.file.startsWith(p));
+            });
+        }
         closeDb();
         if (results.length === 0) {
-            console.log("No results found.");
+            if (opts.format === "json") {
+                console.log("[]");
+            }
+            else {
+                console.log("No results found.");
+            }
             return;
         }
         outputResults(results.map(r => ({
@@ -1695,18 +1748,13 @@ async function vectorSearch(query, opts, _model = DEFAULT_EMBED_MODEL) {
 }
 async function querySearch(query, opts, _embedModel = DEFAULT_EMBED_MODEL, _rerankModel = DEFAULT_RERANK_MODEL) {
     const store = getStore();
-    if (opts.collection) {
-        const coll = getCollectionFromYaml(opts.collection);
-        if (!coll) {
-            console.error(`Collection not found: ${opts.collection}`);
-            closeDb();
-            process.exit(1);
-        }
-    }
+    // Validate collection filter (supports multiple -c flags)
+    const collectionNames = resolveCollectionFilter(opts.collection);
+    const singleCollection = collectionNames.length === 1 ? collectionNames[0] : undefined;
     checkIndexHealth(store.db);
     await withLLMSession(async () => {
-        const results = await hybridQuery(store, query, {
-            collection: opts.collection,
+        let results = await hybridQuery(store, query, {
+            collection: singleCollection,
             limit: opts.all ? 500 : (opts.limit || 10),
             minScore: opts.minScore || 0,
             hooks: {
@@ -1726,9 +1774,21 @@ async function querySearch(query, opts, _embedModel = DEFAULT_EMBED_MODEL, _rera
                 },
             },
         });
+        // Post-filter for multi-collection
+        if (collectionNames.length > 1) {
+            results = results.filter(r => {
+                const prefixes = collectionNames.map(n => `qmd://${n}/`);
+                return prefixes.some(p => r.file.startsWith(p));
+            });
+        }
         closeDb();
         if (results.length === 0) {
-            console.log("No results found.");
+            if (opts.format === "json") {
+                console.log("[]");
+            }
+            else {
+                console.log("No results found.");
+            }
             return;
         }
         // Map to CLI output format — use bestChunk for snippet display
@@ -1756,9 +1816,6 @@ function parseCLI() {
             context: {
                 type: "string",
             },
-            "no-lex": {
-                type: "boolean",
-            },
             help: { type: "boolean", short: "h" },
             version: { type: "boolean", short: "v" },
             // Search options
@@ -1771,7 +1828,7 @@ function parseCLI() {
             xml: { type: "boolean" },
             files: { type: "boolean" },
             json: { type: "boolean" },
-            collection: { type: "string", short: "c" }, // Filter by collection
+            collection: { type: "string", short: "c", multiple: true }, // Filter by collection(s)
             // Collection options
             name: { type: "string" }, // collection name
             mask: { type: "string" }, // glob pattern
@@ -1877,11 +1934,6 @@ function showHelp() {
     console.log("  --max-bytes <num>          - Skip files larger than N bytes (default: 10240)");
     console.log("  --json/--csv/--md/--xml/--files - Output format (same as search)");
     console.log("");
-    console.log("Models (auto-downloaded from HuggingFace):");
-    console.log("  Embedding: embeddinggemma-300M-Q8_0");
-    console.log("  Reranking: qwen3-reranker-0.6b-q8_0");
-    console.log("  Generation: Qwen3-0.6B-Q8_0");
-    console.log("");
     console.log(`Index: ${getDbPath()}`);
 }
 async function showVersion() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tobilu/qmd",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Query Markup Documents - On-device hybrid search for markdown files with BM25, vector search, and LLM reranking",
   "type": "module",
   "bin": {