@gmickel/gno 0.7.0 → 0.8.1

package/package.json

@@ -1,40 +1,38 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
-    "search",
-    "semantic-search",
-    "rag",
-    "vector-search",
     "embeddings",
+    "llm",
     "local-first",
     "mcp",
-    "llm"
+    "rag",
+    "search",
+    "semantic-search",
+    "vector-search"
   ],
-  "author": "Gordon Mickel <gordon@mickel.tech>",
+  "homepage": "https://gno.sh",
+  "bugs": {
+    "url": "https://github.com/gmickel/gno/issues"
+  },
   "license": "MIT",
+  "author": "Gordon Mickel <gordon@mickel.tech>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gmickel/gno.git"
   },
-  "bugs": {
-    "url": "https://github.com/gmickel/gno/issues"
-  },
-  "homepage": "https://gno.sh",
-  "type": "module",
-  "module": "src/index.ts",
   "bin": {
     "gno": "src/index.ts"
   },
   "files": [
-    "src",
     "assets",
+    "src",
+    "THIRD_PARTY_NOTICES.md",
     "vendor"
   ],
-  "engines": {
-    "bun": ">=1.3.0"
-  },
+  "type": "module",
+  "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -42,15 +40,13 @@
     "dev": "bun run --hot src/index.ts",
     "build": "bun build src/index.ts",
     "start": "bun run src/index.ts",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
+    "lint": "oxlint --fix --type-aware --type-check && oxfmt .",
+    "lint:check": "oxlint --type-aware --type-check && oxfmt --check .",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
     "test:coverage:html": "bun test --coverage --html",
     "test:fixtures": "bun scripts/generate-test-fixtures.ts",
-    "typecheck": "tsgo --noEmit",
-    "lint:typeaware": "bun x oxlint --type-aware",
     "reset": "bun run src/index.ts reset --confirm",
     "docs:verify": "bun run scripts/docs-verify.ts",
     "website:install": "cd website && bundle install",
@@ -62,11 +58,14 @@
     "version:patch": "npm version patch --no-git-tag-version",
     "version:minor": "npm version minor --no-git-tag-version",
     "version:major": "npm version major --no-git-tag-version",
-    "prerelease": "bun run lint && bun run typecheck && bun test",
+    "prerelease": "bun run lint:check && bun test",
     "release:dry-run": "gh workflow run publish.yml -f publish=false",
-    "release:trigger": "gh workflow run publish.yml -f publish=true"
+    "release:trigger": "gh workflow run publish.yml -f publish=true",
+    "prepare": "lefthook install"
   },
   "dependencies": {
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/theme-one-dark": "^6.1.3",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-dialog": "^1.1.15",
@@ -83,6 +82,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
+    "codemirror": "^6.0.2",
     "commander": "^14.0.2",
     "embla-carousel-react": "^8.6.0",
     "franc": "^6.2.0",
@@ -94,6 +94,9 @@
     "picocolors": "^1.1.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
+    "react-markdown": "^10.1.0",
+    "rehype-highlight": "^7.0.2",
+    "rehype-sanitize": "^6.0.0",
     "shiki": "^3.20.0",
     "sqlite-vec": "^0.1.7-alpha.2",
     "streamdown": "^1.6.10",
@@ -106,13 +109,14 @@
     "@types/bun": "latest",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "@typescript/native-preview": "^7.0.0-dev.20251215.1",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "docx": "^9.5.1",
     "evalite": "^1.0.0-beta.15",
     "exceljs": "^4.4.0",
     "lefthook": "^2.0.13",
+    "oxfmt": "^0.21.0",
+    "oxlint": "^1.36.0",
     "oxlint-tsgolint": "^0.10.1",
     "pdf-lib": "^1.17.1",
     "pptxgenjs": "^4.0.1",
@@ -121,5 +125,8 @@
   },
   "peerDependencies": {
     "typescript": "^5"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
   }
 }

package/src/app/constants.ts

@@ -5,26 +5,27 @@
  * @module src/app/constants
  */
 
-import { homedir, platform } from 'node:os';
-import { join } from 'node:path';
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+
 // Bun supports JSON imports natively - version single source of truth
-import pkg from '../../package.json';
+import pkg from "../../package.json";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Brand / Product Identity
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** Product name (display) */
-export const PRODUCT_NAME = 'GNO';
+export const PRODUCT_NAME = "GNO";
 
 /** CLI binary name */
-export const CLI_NAME = 'gno';
+export const CLI_NAME = "gno";
 
 /** Version from package.json (single source of truth) */
 export const VERSION = pkg.version;
 
 /** Virtual URI scheme for document references */
-export const URI_SCHEME = 'gno';
+export const URI_SCHEME = "gno";
 
 /** Full URI prefix including :// */
 export const URI_PREFIX = `${URI_SCHEME}://`;
@@ -34,56 +35,56 @@ export const URI_PREFIX = `${URI_SCHEME}://`;
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** MCP server name */
-export const MCP_SERVER_NAME = 'gno';
+export const MCP_SERVER_NAME = "gno";
 
 /** MCP tool namespace prefix (tools are gno.search, gno.query, etc.) */
-export const MCP_TOOL_PREFIX = 'gno';
+export const MCP_TOOL_PREFIX = "gno";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Documentation & Support
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** Documentation URL */
-export const DOCS_URL = 'https://github.com/gmickel/gno#readme';
+export const DOCS_URL = "https://github.com/gmickel/gno#readme";
 
 /** Issue tracker URL */
-export const ISSUES_URL = 'https://github.com/gmickel/gno/issues';
+export const ISSUES_URL = "https://github.com/gmickel/gno/issues";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Environment Variable Names (for directory overrides)
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** Env var to override config directory */
-export const ENV_CONFIG_DIR = 'GNO_CONFIG_DIR';
+export const ENV_CONFIG_DIR = "GNO_CONFIG_DIR";
 
 /** Env var to override data directory */
-export const ENV_DATA_DIR = 'GNO_DATA_DIR';
+export const ENV_DATA_DIR = "GNO_DATA_DIR";
 
 /** Env var to override cache directory */
-export const ENV_CACHE_DIR = 'GNO_CACHE_DIR';
+export const ENV_CACHE_DIR = "GNO_CACHE_DIR";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Directory Names
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** Directory name used within platform-specific locations */
-export const DIR_NAME = 'gno';
+export const DIR_NAME = "gno";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Index Defaults
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** Default index name when not specified via --index */
-export const DEFAULT_INDEX_NAME = 'default';
+export const DEFAULT_INDEX_NAME = "default";
 
 /** Config filename */
-export const CONFIG_FILENAME = 'index.yml';
+export const CONFIG_FILENAME = "index.yml";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Platform Detection
 // ─────────────────────────────────────────────────────────────────────────────
 
-export type Platform = 'darwin' | 'win32' | 'linux';
+export type Platform = "darwin" | "win32" | "linux";
 
 /**
  * Get current platform, normalized to supported types.
@@ -91,13 +92,13 @@ export type Platform = 'darwin' | 'win32' | 'linux';
  */
 export function getPlatform(): Platform {
   const p = platform();
-  if (p === 'darwin') {
-    return 'darwin';
+  if (p === "darwin") {
+    return "darwin";
   }
-  if (p === 'win32') {
-    return 'win32';
+  if (p === "win32") {
+    return "win32";
   }
-  return 'linux';
+  return "linux";
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -132,9 +133,9 @@ interface PlatformPaths {
 
 function getLinuxPaths(): PlatformPaths {
   const home = homedir();
-  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, '.config');
-  const xdgData = process.env.XDG_DATA_HOME ?? join(home, '.local', 'share');
-  const xdgCache = process.env.XDG_CACHE_HOME ?? join(home, '.cache');
+  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, ".config");
+  const xdgData = process.env.XDG_DATA_HOME ?? join(home, ".local", "share");
+  const xdgCache = process.env.XDG_CACHE_HOME ?? join(home, ".cache");
 
   return {
     config: join(xdgConfig, DIR_NAME),
@@ -145,24 +146,24 @@ function getLinuxPaths(): PlatformPaths {
 
 function getDarwinPaths(): PlatformPaths {
   const home = homedir();
-  const appSupport = join(home, 'Library', 'Application Support', DIR_NAME);
+  const appSupport = join(home, "Library", "Application Support", DIR_NAME);
 
   return {
-    config: join(appSupport, 'config'),
-    data: join(appSupport, 'data'),
-    cache: join(home, 'Library', 'Caches', DIR_NAME),
+    config: join(appSupport, "config"),
+    data: join(appSupport, "data"),
+    cache: join(home, "Library", "Caches", DIR_NAME),
   };
 }
 
 function getWin32Paths(): PlatformPaths {
-  const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+  const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
   const localAppData =
-    process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local');
+    process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
 
   return {
-    config: join(appData, DIR_NAME, 'config'),
-    data: join(localAppData, DIR_NAME, 'data'),
-    cache: join(localAppData, DIR_NAME, 'cache'),
+    config: join(appData, DIR_NAME, "config"),
+    data: join(localAppData, DIR_NAME, "data"),
+    cache: join(localAppData, DIR_NAME, "cache"),
   };
 }
 
@@ -171,9 +172,9 @@ function getWin32Paths(): PlatformPaths {
  */
 export function getPlatformPaths(p: Platform = getPlatform()): PlatformPaths {
   switch (p) {
-    case 'darwin':
+    case "darwin":
       return getDarwinPaths();
-    case 'win32':
+    case "win32":
       return getWin32Paths();
     default:
       return getLinuxPaths();
@@ -231,7 +232,7 @@ export function getConfigPath(dirs: ResolvedDirs = resolveDirs()): string {
  * Get path to models cache directory.
  */
 export function getModelsCachePath(dirs: ResolvedDirs = resolveDirs()): string {
-  return join(dirs.cache, 'models');
+  return join(dirs.cache, "models");
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -244,9 +245,9 @@ export function getModelsCachePath(dirs: ResolvedDirs = resolveDirs()): string {
 export function buildUri(collection: string, relativePath: string): string {
   // URL-encode special chars in path segments but preserve slashes
   const encodedPath = relativePath
-    .split('/')
+    .split("/")
     .map((segment) => encodeURIComponent(segment))
-    .join('/');
+    .join("/");
   return `${URI_PREFIX}${collection}/${encodedPath}`;
 }
 
@@ -262,11 +263,11 @@ export function parseUri(
   }
 
   const rest = uri.slice(URI_PREFIX.length);
-  const slashIndex = rest.indexOf('/');
+  const slashIndex = rest.indexOf("/");
 
   if (slashIndex === -1) {
     // gno://collection (no path)
-    return { collection: rest, path: '' };
+    return { collection: rest, path: "" };
   }
 
   const collection = rest.slice(0, slashIndex);
@@ -285,7 +286,7 @@ export function parseUri(
 // ─────────────────────────────────────────────────────────────────────────────
 
 /** docid prefix */
-export const DOCID_PREFIX = '#';
+export const DOCID_PREFIX = "#";
 
 /** docid hex length (8 chars = 32 bits, ~4B unique values) */
 export const DOCID_LENGTH = 8;

package/src/cli/colors.ts

@@ -4,7 +4,7 @@
  * @module src/cli/colors
  */
 
-import pc from 'picocolors';
+import pc from "picocolors";
 
 // Track whether colors are enabled (global state for CLI lifetime)
 let colorsEnabled = true;

package/src/cli/commands/ask.ts

@@ -5,30 +5,31 @@
  * @module src/cli/commands/ask
  */
 
-import { LlmAdapter } from '../../llm/nodeLlamaCpp/adapter';
-import { resolveDownloadPolicy } from '../../llm/policy';
-import { getActivePreset } from '../../llm/registry';
 import type {
   EmbeddingPort,
   GenerationPort,
   RerankPort,
-} from '../../llm/types';
+} from "../../llm/types";
+import type { AskOptions, AskResult, Citation } from "../../pipeline/types";
+
+import { LlmAdapter } from "../../llm/nodeLlamaCpp/adapter";
+import { resolveDownloadPolicy } from "../../llm/policy";
+import { getActivePreset } from "../../llm/registry";
 import {
   generateGroundedAnswer,
   processAnswerResult,
-} from '../../pipeline/answer';
-import { type HybridSearchDeps, searchHybrid } from '../../pipeline/hybrid';
-import type { AskOptions, AskResult, Citation } from '../../pipeline/types';
+} from "../../pipeline/answer";
+import { type HybridSearchDeps, searchHybrid } from "../../pipeline/hybrid";
 import {
   createVectorIndexPort,
   type VectorIndexPort,
-} from '../../store/vector';
-import { getGlobals } from '../program';
+} from "../../store/vector";
+import { getGlobals } from "../program";
 import {
   createProgressRenderer,
   createThrottledProgressRenderer,
-} from '../progress';
-import { initStore } from './shared';
+} from "../progress";
+import { initStore } from "./shared";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -62,7 +63,7 @@ export type AskCommandResult =
 /**
  * Execute gno ask command.
  */
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: CLI orchestration with multiple output formats
+// oxlint-disable-next-line max-lines-per-function -- CLI orchestration with multiple output formats
 export async function ask(
   query: string,
   options: AskCommandOptions = {}
@@ -105,7 +106,7 @@ export async function ask(
     const embedResult = await llm.createEmbeddingPort(embedUri, {
       policy,
       onProgress: downloadProgress
-        ? (progress) => downloadProgress('embed', progress)
+        ? (progress) => downloadProgress("embed", progress)
         : undefined,
     });
     if (embedResult.ok) {
@@ -120,7 +121,7 @@ export async function ask(
       const genResult = await llm.createGenerationPort(genUri, {
         policy,
         onProgress: downloadProgress
-          ? (progress) => downloadProgress('gen', progress)
+          ? (progress) => downloadProgress("gen", progress)
           : undefined,
       });
       if (genResult.ok) {
@@ -134,7 +135,7 @@ export async function ask(
       const rerankResult = await llm.createRerankPort(rerankUri, {
         policy,
         onProgress: downloadProgress
-          ? (progress) => downloadProgress('rerank', progress)
+          ? (progress) => downloadProgress("rerank", progress)
           : undefined,
       });
       if (rerankResult.ok) {
@@ -144,7 +145,7 @@ export async function ask(
 
     // Clear progress line if shown
     if (showProgress && downloadProgress) {
-      process.stderr.write('\n');
+      process.stderr.write("\n");
     }
 
     // Create vector index
@@ -181,8 +182,8 @@ export async function ask(
       return {
         success: false,
         error:
-          'Answer generation requested but no generation model available. ' +
-          'Run `gno models pull --gen` to download a model, or configure a preset.',
+          "Answer generation requested but no generation model available. " +
+          "Run `gno models pull --gen` to download a model, or configure a preset.",
       };
     }
 
@@ -227,7 +228,7 @@ export async function ask(
         return {
           success: false,
           error:
-            'Answer generation failed. The generation model may have encountered an error.',
+            "Answer generation failed. The generation model may have encountered an error.",
         };
       }
 
@@ -240,8 +241,8 @@ export async function ask(
 
     const askResult: AskResult = {
       query,
-      mode: searchResult.value.meta.vectorsUsed ? 'hybrid' : 'bm25_only',
-      queryLanguage: searchResult.value.meta.queryLanguage ?? 'und',
+      mode: searchResult.value.meta.vectorsUsed ? "hybrid" : "bm25_only",
+      queryLanguage: searchResult.value.meta.queryLanguage ?? "und",
       answer,
       citations,
       results,
@@ -277,28 +278,28 @@ interface FormatOptions {
   showSources?: boolean;
 }
 
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: terminal formatting with conditional sections
+// oxlint-disable-next-line max-lines-per-function -- terminal formatting with conditional sections
 function formatTerminal(data: AskResult, opts: FormatOptions = {}): string {
   const lines: string[] = [];
   const hasAnswer = Boolean(data.answer);
 
   // Show answer if present
   if (data.answer) {
-    lines.push('Answer:');
+    lines.push("Answer:");
     lines.push(data.answer);
-    lines.push('');
+    lines.push("");
   }
 
   // Show cited sources (only sources actually referenced in answer)
   if (data.citations && data.citations.length > 0) {
-    lines.push('Cited Sources:');
+    lines.push("Cited Sources:");
     for (let i = 0; i < data.citations.length; i++) {
       const c = data.citations[i];
       if (c) {
         lines.push(`  [${i + 1}] ${c.uri}`);
       }
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Show all retrieved sources if:
@@ -306,7 +307,7 @@ function formatTerminal(data: AskResult, opts: FormatOptions = {}): string {
   // - User explicitly requested with --show-sources
   const showAllSources = !hasAnswer || opts.showSources;
   if (showAllSources && data.results.length > 0) {
-    lines.push(hasAnswer ? 'All Retrieved Sources:' : 'Sources:');
+    lines.push(hasAnswer ? "All Retrieved Sources:" : "Sources:");
     for (const r of data.results) {
       lines.push(`  [${r.docid}] ${r.uri}`);
       if (r.title) {
@@ -324,10 +325,10 @@ function formatTerminal(data: AskResult, opts: FormatOptions = {}): string {
   }
 
   if (!data.answer && data.results.length === 0) {
-    lines.push('No relevant sources found.');
+    lines.push("No relevant sources found.");
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function formatMarkdown(data: AskResult, opts: FormatOptions = {}): string {
@@ -335,33 +336,33 @@ function formatMarkdown(data: AskResult, opts: FormatOptions = {}): string {
   const hasAnswer = Boolean(data.answer);
 
   lines.push(`# Question: ${data.query}`);
-  lines.push('');
+  lines.push("");
 
   if (data.answer) {
-    lines.push('## Answer');
-    lines.push('');
+    lines.push("## Answer");
+    lines.push("");
     lines.push(data.answer);
-    lines.push('');
+    lines.push("");
   }
 
   // Show cited sources (only sources actually referenced in answer)
   if (data.citations && data.citations.length > 0) {
-    lines.push('## Cited Sources');
-    lines.push('');
+    lines.push("## Cited Sources");
+    lines.push("");
     for (let i = 0; i < data.citations.length; i++) {
       const c = data.citations[i];
       if (c) {
         lines.push(`**[${i + 1}]** \`${c.uri}\``);
       }
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Show all retrieved sources if no answer or --show-sources
   const showAllSources = !hasAnswer || opts.showSources;
   if (showAllSources) {
-    lines.push(hasAnswer ? '## All Retrieved Sources' : '## Sources');
-    lines.push('');
+    lines.push(hasAnswer ? "## All Retrieved Sources" : "## Sources");
+    lines.push("");
 
     for (let i = 0; i < data.results.length; i++) {
       const r = data.results[i];
@@ -374,17 +375,17 @@ function formatMarkdown(data: AskResult, opts: FormatOptions = {}): string {
     }
 
     if (data.results.length === 0) {
-      lines.push('*No relevant sources found.*');
+      lines.push("*No relevant sources found.*");
     }
   }
 
-  lines.push('');
-  lines.push('---');
+  lines.push("");
+  lines.push("---");
   lines.push(
     `*Mode: ${data.mode} | Expanded: ${data.meta.expanded} | Reranked: ${data.meta.reranked}*`
   );
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 /**
@@ -397,7 +398,7 @@ export function formatAsk(
   if (!result.success) {
     return options.json
       ? JSON.stringify({
-          error: { code: 'ASK_FAILED', message: result.error },
+          error: { code: "ASK_FAILED", message: result.error },
         })
       : `Error: ${result.error}`;
   }

package/src/cli/commands/cleanup.ts

@@ -5,10 +5,11 @@
  * @module src/cli/commands/cleanup
  */
 
-import { getIndexDbPath } from '../../app/constants';
-import { isInitialized, loadConfig } from '../../config';
-import { SqliteAdapter } from '../../store/sqlite/adapter';
-import type { CleanupStats } from '../../store/types';
+import type { CleanupStats } from "../../store/types";
+
+import { getIndexDbPath } from "../../app/constants";
+import { isInitialized, loadConfig } from "../../config";
+import { SqliteAdapter } from "../../store/sqlite/adapter";
 
 /**
  * Options for cleanup command.
@@ -34,7 +35,7 @@ export async function cleanup(
   // Check if initialized
   const initialized = await isInitialized(options.configPath);
   if (!initialized) {
-    return { success: false, error: 'GNO not initialized. Run: gno init' };
+    return { success: false, error: "GNO not initialized. Run: gno init" };
   }
 
   // Load config
@@ -81,10 +82,10 @@ export function formatCleanup(result: CleanupResult): string {
     stats.expiredCache;
 
   if (total === 0) {
-    return 'No orphans found. Index is clean.';
+    return "No orphans found. Index is clean.";
   }
 
-  const lines: string[] = ['Cleanup complete:'];
+  const lines: string[] = ["Cleanup complete:"];
 
   if (stats.orphanedContent > 0) {
     lines.push(`  Orphaned content: ${stats.orphanedContent}`);
@@ -101,5 +102,5 @@ export function formatCleanup(result: CleanupResult): string {
 
   lines.push(`Total removed: ${total}`);
 
-  return lines.join('\n');
+  return lines.join("\n");
 }