@wei840222/qmd 2026.9.29 → 2026.9.30

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Dependency upgrades and runtime engine modernization: Updated Node.js engine target to `>=24.21.0` (LTS Krypton) and packageManager to `pnpm@12.6.0`. Upgraded dependencies and toolchain including `node-llama-cpp` to `3.22.1`, `zod` to `4.6.5`, `@modelcontextprotocol/server` to `2.1.0`, `picomatch` to `4.0.7`, `yaml` to `2.9.1`, `tsx` to `4.23.15`, `oxlint` to `1.85.0`, `vitest` to `4.1.11` (patching security advisory GHSA-82fw-gwwq-j7x9), and refreshed patch/minor dependency overrides.
+
 ### Fixed
 
 - Metadata extraction error retry: `isDocumentMetadataCurrent` now requires an error-free extraction, allowing `qmd update` to automatically re-attempt extraction on documents that previously failed without requiring manual edits.
@@ -19,7 +23,7 @@
 - Document file path and title metadata in candidate reranking: candidate documents for chat-based and remote rerankers now retain document file paths and titles, enabling rerankers to evaluate provenance and temporal references.
 - Relative temporal resolution in query expansion: `expandQuery` prompts now instruct models to calculate exact ISO dates from relative time expressions (e.g. "yesterday", "昨天", "today", "last week") against current local time for lexical and vector search.
 - Added file, title, and current local time to TypeSafe Jev candidate reranking and intent classification states, with temporal constraint guidance.
-- Search intent playbook and guidance for query expansion: Added `JEV_STRATEGY_PLAYBOOK` mapping Jev intent classifications (`code_search`, `concept_search`, `factual_lookup`, `broad_exploration`) to concrete lexical and vector search guidance passed to downstream expansion LLMs in dedicated `<search_intent>` XML blocks, keeping untrusted context separate.
+- Search intent playbook and guidance for query expansion: Added `JEV_STRATEGY_PLAYBOOK` mapping Jev intent classifications (`troubleshooting`, `how_to_guide`, `code_search`, `concept_search`, `factual_lookup`, `broad_exploration`) to concrete lexical and vector search guidance passed to downstream expansion LLMs in dedicated `<search_intent>` XML blocks, keeping untrusted context separate.
 
 ## [2026.9.25] - 2026-09-26
 

package/dist/cli/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "14c9c5c",
-  "builtAt": "2026-09-29T03:20:38.715Z"
+  "commit": "6ac6043",
+  "builtAt": "2026-09-29T05:54:42.265Z"
 }

package/dist/remote-jev.js

@@ -3,6 +3,18 @@ import { getFormattedLocalTime } from "./remote-llm.js";
 export const DEFAULT_JEV_TIMEOUT_MS = 30000;
 export const DEFAULT_JEV_RERANK_BATCH_SIZE = 40;
 export const JEV_STRATEGY_PLAYBOOK = {
+    troubleshooting: {
+        label: "Troubleshooting & Bug Fix",
+        objective: "Diagnosing errors, exceptions, stack traces, failure modes, or broken states.",
+        lexGuidance: "Prioritize exact error codes, exception class names, HTTP statuses, and failed syscall/function identifiers. Exclude generic noise like 'why', 'error', 'issue'.",
+        vecGuidance: "Formulate concrete diagnostic or remediation questions (e.g., 'how to resolve <error> caused by <reason>').",
+    },
+    how_to_guide: {
+        label: "How-To & Procedural Guide",
+        objective: "Looking for step-by-step setup guides, workflows, recipes, installation, or migration steps.",
+        lexGuidance: "Include tool/command names, CLI flags, configuration filenames, and workflow action verbs without extra filler words.",
+        vecGuidance: "Formulate procedural task questions (e.g., 'step-by-step guide to configure or implement <task>').",
+    },
     code_search: {
         label: "Code Search",
         objective: "Looking for specific code, functions, APIs, syntax, or implementations.",
@@ -74,8 +86,10 @@ export class RemoteJev {
             model: this.model,
             questions: {
                 strategy: choice("What type of search is the user performing given the query and optional context?", {
+                    troubleshooting: "Diagnosing errors, exceptions, stack traces, or broken behavior",
+                    how_to_guide: "Step-by-step instructions, installation, configuration, or migration workflows",
                     code_search: "Looking for specific code, functions, APIs, or implementations",
-                    concept_search: "Looking for explanations, concepts, or documentation",
+                    concept_search: "Looking for explanations, concepts, architecture, or documentation",
                     factual_lookup: "Looking for specific facts, configurations, or settings",
                     broad_exploration: "Exploring a topic broadly without a specific target",
                 }),

package/package.json

@@ -1,8 +1,30 @@
 {
   "name": "@wei840222/qmd",
-  "version": "2026.9.29",
-  "packageManager": "pnpm@11.15.1",
+  "version": "2026.9.30",
   "description": "Query Markup Documents - On-device hybrid search for markdown files with BM25, vector search, and LLM reranking",
+  "author": "Wan, Jiun Wei <wei840222@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "markdown",
+    "search",
+    "fts",
+    "full-text-search",
+    "vector",
+    "semantic-search",
+    "sqlite",
+    "bm25",
+    "embeddings",
+    "rag",
+    "mcp",
+    "reranking",
+    "knowledge-base",
+    "local-ai",
+    "llm"
+  ],
+  "engines": {
+    "node": ">=24.21.0"
+  },
+  "packageManager": "pnpm@12.6.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -64,21 +86,21 @@
     "url": "https://github.com/wei840222/qmd/issues"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "2.0.0",
+    "@modelcontextprotocol/server": "2.1.0",
     "@node-rs/jieba": "2.0.3",
     "@typesafe-ai/sdk": "^0.6.0",
     "fast-glob": "3.3.3",
     "lru-cache": "^11.5.3",
-    "node-llama-cpp": "3.20.0",
-    "picomatch": "4.0.5",
+    "node-llama-cpp": "3.22.1",
+    "picomatch": "4.0.7",
     "sqlite-vec": "0.1.9",
     "tree-sitter-go": "0.25.0",
     "tree-sitter-python": "0.25.0",
     "tree-sitter-rust": "0.24.0",
     "tree-sitter-typescript": "0.23.2",
     "web-tree-sitter": "0.26.12",
-    "yaml": "2.9.0",
-    "zod": "4.2.1"
+    "yaml": "2.9.1",
+    "zod": "4.6.5"
   },
   "optionalDependencies": {
     "sqlite-vec-darwin-arm64": "0.1.9",
@@ -88,50 +110,28 @@
     "sqlite-vec-windows-x64": "0.1.9"
   },
   "devDependencies": {
-    "@oxlint/plugins": "1.78.0",
-    "oxlint": "1.78.0",
-    "tsx": "4.23.12",
-    "vitest": "3.2.7"
+    "@oxlint/plugins": "1.85.0",
+    "oxlint": "1.85.0",
+    "tsx": "4.23.15",
+    "vitest": "4.1.11"
   },
   "overrides": {
-    "@hono/node-server": "2.0.10",
-    "ajv": "8.18.0",
-    "esbuild": "0.28.1",
+    "@hono/node-server": "2.1.2",
+    "ajv": "8.20.0",
+    "esbuild": "0.28.2",
     "fast-uri": "3.1.5",
-    "hono": "4.12.34",
-    "ip-address": "10.3.1",
+    "hono": "4.13.10",
+    "ip-address": "10.7.2",
     "nanoid": "3.3.18",
-    "path-to-regexp": "8.4.0",
-    "postcss": "8.5.23",
-    "qs": "6.15.3",
-    "rollup": "4.59.0",
+    "path-to-regexp": "8.4.2",
+    "postcss": "8.5.28",
+    "qs": "6.16.0",
+    "rollup": "4.63.5",
     "simple-git": "3.36.0",
-    "tar": "7.5.21",
+    "tar": "7.5.22",
     "vite": "7.3.5"
   },
   "peerDependencies": {
     "typescript": "^5.9.3 || ^6.0.0-0"
-  },
-  "engines": {
-    "node": ">=22.16.0"
-  },
-  "keywords": [
-    "markdown",
-    "search",
-    "fts",
-    "full-text-search",
-    "vector",
-    "semantic-search",
-    "sqlite",
-    "bm25",
-    "embeddings",
-    "rag",
-    "mcp",
-    "reranking",
-    "knowledge-base",
-    "local-ai",
-    "llm"
-  ],
-  "author": "Wan, Jiun Wei <wei840222@gmail.com>",
-  "license": "MIT"
+  }
 }