@gmickel/gno 0.20.0 → 0.22.1

package/README.md

@@ -32,7 +32,15 @@ GNO is a local knowledge engine that turns your documents into a searchable, con
 
 ---
 
-## What's New in v0.19
+## What's New in v0.21
+
+- **Ask CLI Query Modes**: `gno ask` now accepts repeatable `--query-mode term|intent|hyde` entries, matching the existing Ask API and Web controls
+
+### v0.20
+
+- **Improved Model Init Fallbacks**: upgraded `node-llama-cpp` to `3.17.1` and switched to `build: "autoAttempt"` for better backend selection/fallback behavior
+
+### v0.19
 
 - **Exclusion Filters**: explicit `exclude` controls across CLI, API, Web, and MCP to hard-prune unwanted docs by title/path/body text
 - **Ask Query-Mode Parity**: Ask now supports structured `term` / `intent` / `hyde` controls in both API and Web UI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.20.0",
+  "version": "0.22.1",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",
@@ -54,7 +54,40 @@
     "eval:hybrid": "bun --bun evalite evals/hybrid.eval.ts",
     "eval:hybrid:baseline": "bun scripts/hybrid-benchmark.ts --write",
     "eval:hybrid:delta": "bun scripts/hybrid-benchmark.ts --delta",
+    "eval:retrieval-candidates": "bun scripts/retrieval-candidate-benchmark.ts",
+    "eval:retrieval-candidates:write": "bun scripts/retrieval-candidate-benchmark.ts --write",
     "eval:watch": "bun --bun evalite watch",
+    "research:finetune:bootstrap": "bun research/finetune/scripts/bootstrap-promotion-fixtures.ts",
+    "research:finetune:autonomous:noop": "bun research/finetune/autonomous/scripts/noop-run.ts",
+    "research:finetune:autonomous:evaluate": "bun research/finetune/autonomous/scripts/evaluate-run.ts",
+    "research:finetune:autonomous:propose-mix-variants": "bun research/finetune/autonomous/scripts/propose-mix-variants.ts",
+    "research:finetune:autonomous:list-search-candidates": "bun research/finetune/autonomous/scripts/list-search-candidates.ts",
+    "research:finetune:autonomous:run-candidate": "bun research/finetune/autonomous/scripts/run-candidate.ts",
+    "research:finetune:autonomous:search": "bun research/finetune/autonomous/scripts/search.ts",
+    "research:finetune:autonomous:leaderboard": "bun research/finetune/autonomous/scripts/leaderboard.ts",
+    "research:finetune:autonomous:confirm-winner": "bun research/finetune/autonomous/scripts/confirm-winner.ts",
+    "research:finetune:autonomous:check-promotion-targets": "bun research/finetune/autonomous/scripts/check-promotion-targets.ts",
+    "research:finetune:validate": "bun research/finetune/scripts/validate-sandbox.ts",
+    "research:finetune:qmd-import": "bun research/finetune/scripts/import-qmd-training.ts",
+    "research:finetune:mlx:build-dataset": "bun research/finetune/scripts/build-mlx-dataset.ts",
+    "research:finetune:build-variant-dataset": "bun research/finetune/scripts/build-variant-dataset.ts",
+    "research:finetune:list-mix-variants": "bun research/finetune/scripts/list-mix-variants.ts",
+    "research:finetune:list-prompt-variants": "bun research/finetune/scripts/list-prompt-variants.ts",
+    "research:finetune:export-env": "bun research/finetune/scripts/setup-export-env.ts",
+    "research:finetune:export-gguf": "bun research/finetune/scripts/export-gguf.ts",
+    "research:finetune:smoke-gno-export": "bun research/finetune/scripts/smoke-gno-export.ts",
+    "research:finetune:select-best": "bun research/finetune/scripts/select-best-checkpoint.ts",
+    "research:finetune:fuse-best": "bun research/finetune/scripts/fuse-best-checkpoint.ts",
+    "research:finetune:benchmark-export": "bun research/finetune/scripts/benchmark-exported-model.ts",
+    "research:finetune:repeat-benchmark-compare": "bun research/finetune/scripts/repeat-benchmark-compare.ts",
+    "research:finetune:compare-runs": "bun research/finetune/scripts/compare-runs.ts",
+    "research:finetune:promotion-bundle": "bun research/finetune/scripts/generate-promotion-bundle.ts",
+    "research:finetune:finalize": "bun research/finetune/scripts/finalize-promoted-model.ts",
+    "research:finetune:promote": "bun research/finetune/scripts/promote-run.ts",
+    "research:finetune:plan-sweep": "bun research/finetune/scripts/plan-alternate-sweep.ts",
+    "research:finetune:mlx:train": "bun research/finetune/scripts/train-mlx.ts",
+    "research:finetune:mlx:fuse": "bun research/finetune/scripts/fuse-mlx.ts",
+    "research:finetune:mlx:smoke": "bun research/finetune/scripts/smoke-mlx.ts",
     "reset": "bun run src/index.ts reset --confirm",
     "docs:verify": "bun run scripts/docs-verify.ts",
     "website:install": "cd website && bundle install",

package/src/cli/commands/ask.ts

@@ -200,6 +200,7 @@ export async function ask(
       tagsAll: options.tagsAll,
       tagsAny: options.tagsAny,
       exclude: options.exclude,
+      queryModes: options.queryModes,
       noExpand: options.noExpand,
       noRerank: options.noRerank,
       candidateLimit: options.candidateLimit,

package/src/cli/program.ts

@@ -608,6 +608,12 @@ function wireSearchCommands(program: Command): void {
       "--exclude <values>",
       "exclude docs containing any term (comma-separated)"
     )
+    .option(
+      "--query-mode <mode:text>",
+      "structured mode entry (repeatable): term:<text>, intent:<text>, or hyde:<text>",
+      (value: string, previous: string[] = []) => [...previous, value],
+      []
+    )
     .option("--fast", "skip expansion and reranking (fastest)")
     .option("--thorough", "enable query expansion (slower)")
     .option("-C, --candidate-limit <num>", "max candidates passed to reranking")
@@ -640,6 +646,16 @@ function wireSearchCommands(program: Command): void {
       const categories = parseCsvValues(cmdOpts.category);
       const exclude = parseCsvValues(cmdOpts.exclude);
 
+      let queryModes: import("../pipeline/types").QueryModeInput[] | undefined;
+      if (Array.isArray(cmdOpts.queryMode) && cmdOpts.queryMode.length > 0) {
+        const { parseQueryModeSpecs } = await import("../pipeline/query-modes");
+        const parsed = parseQueryModeSpecs(cmdOpts.queryMode as string[]);
+        if (!parsed.ok) {
+          throw new CliError("VALIDATION", parsed.error.message);
+        }
+        queryModes = parsed.value;
+      }
+
       // Determine expansion/rerank settings based on flags
       // Default: skip expansion (balanced mode)
       let noExpand = true;
@@ -665,6 +681,7 @@ function wireSearchCommands(program: Command): void {
         author: cmdOpts.author as string | undefined,
         intent: cmdOpts.intent as string | undefined,
         exclude,
+        queryModes,
         noExpand,
         noRerank,
         candidateLimit,

package/src/pipeline/expansion.ts

@@ -421,6 +421,30 @@ function parseExpansionResult(output: string): ExpansionResult | null {
   }
 }
 
+/**
+ * Build the exact expansion prompt used by production query expansion.
+ * Exported for benchmark/eval harnesses that need to inspect raw model output.
+ */
+export function buildExpansionPrompt(
+  query: string,
+  options: Pick<ExpansionOptions, "lang" | "intent"> = {}
+): string {
+  const template = getPromptTemplate(options.lang);
+  return buildPrompt(query, template, options.intent);
+}
+
+/**
+ * Parse raw expansion output using the same schema + guardrails as production.
+ * Exported for benchmark/eval harnesses that need raw-model diagnostics.
+ */
+export function parseExpansionOutput(
+  output: string,
+  query: string
+): ExpansionResult | null {
+  const parsed = parseExpansionResult(output);
+  return parsed ? applyExpansionGuardrails(query, parsed) : null;
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Expansion Function
 // ─────────────────────────────────────────────────────────────────────────────
@@ -448,8 +472,7 @@ export async function expandQuery(
   const timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
 
   // Build prompt
-  const template = getPromptTemplate(options.lang);
-  const prompt = buildPrompt(query, template, options.intent);
+  const prompt = buildExpansionPrompt(query, options);
 
   // Run with timeout (clear timer to avoid resource leak)
   let timeoutId: ReturnType<typeof setTimeout> | undefined;
@@ -484,11 +507,11 @@ export async function expandQuery(
     }
 
     // Parse result
-    const parsed = parseExpansionResult(result.value);
+    const parsed = parseExpansionOutput(result.value, query);
     if (!parsed) {
       return ok(null);
     }
-    return ok(applyExpansionGuardrails(query, parsed));
+    return ok(parsed);
   } catch {
     if (timeoutId) {
       clearTimeout(timeoutId);