@gmickel/gno 0.7.0 → 0.8.2

package/src/cli/commands/multi-get.ts

@@ -5,11 +5,13 @@
  * @module src/cli/commands/multi-get
  */
 
-import { minimatch } from 'minimatch';
-import type { DocumentRow, StorePort, StoreResult } from '../../store/types';
-import type { ParsedRef } from './ref-parser';
-import { isGlobPattern, parseRef, splitRefs } from './ref-parser';
-import { initStore } from './shared';
+import { minimatch } from "minimatch";
+
+import type { DocumentRow, StorePort, StoreResult } from "../../store/types";
+import type { ParsedRef } from "./ref-parser";
+
+import { isGlobPattern, parseRef, splitRefs } from "./ref-parser";
+import { initStore } from "./shared";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -46,7 +48,7 @@ export interface MultiGetDocument {
 
 export interface SkippedDoc {
   ref: string;
-  reason: 'not_found' | 'conversion_error' | 'invalid_ref';
+  reason: "not_found" | "conversion_error" | "invalid_ref";
 }
 
 export interface MultiGetResponse {
@@ -73,11 +75,11 @@ function lookupDocument(
   parsed: ParsedRef
 ): Promise<StoreResult<DocumentRow | null>> {
   switch (parsed.type) {
-    case 'docid':
+    case "docid":
       return store.getDocumentByDocid(parsed.value);
-    case 'uri':
+    case "uri":
       return store.getDocumentByUri(parsed.value);
-    case 'collPath':
+    case "collPath":
       if (!(parsed.collection && parsed.relPath)) {
         return Promise.resolve({ ok: true as const, value: null });
       }
@@ -109,7 +111,7 @@ async function expandGlobs(
       continue;
     }
 
-    const slashIdx = ref.indexOf('/');
+    const slashIdx = ref.indexOf("/");
     if (slashIdx === -1) {
       invalidRefs.push(ref);
       continue;
@@ -145,8 +147,8 @@ function truncateContent(
     return { content, truncated: false };
   }
 
-  const lines = content.split('\n');
-  let accumulated = '';
+  const lines = content.split("\n");
+  let accumulated = "";
   let byteLen = 0;
 
   for (const line of lines) {
@@ -184,31 +186,31 @@ async function fetchSingleDocument(
   ctx.seen.add(ref);
 
   const parsed = parseRef(ref);
-  if ('error' in parsed) {
-    ctx.skipped.push({ ref, reason: 'invalid_ref' });
+  if ("error" in parsed) {
+    ctx.skipped.push({ ref, reason: "invalid_ref" });
     return;
   }
 
   const docResult = await lookupDocument(ctx.store, parsed);
   if (!docResult.ok) {
-    ctx.skipped.push({ ref, reason: 'not_found' });
+    ctx.skipped.push({ ref, reason: "not_found" });
     return;
   }
 
   const doc = docResult.value;
   if (!doc?.active) {
-    ctx.skipped.push({ ref, reason: 'not_found' });
+    ctx.skipped.push({ ref, reason: "not_found" });
     return;
   }
 
   if (!doc.mirrorHash) {
-    ctx.skipped.push({ ref, reason: 'conversion_error' });
+    ctx.skipped.push({ ref, reason: "conversion_error" });
     return;
   }
 
   const contentResult = await ctx.store.getContent(doc.mirrorHash);
   if (!contentResult.ok || contentResult.value === null) {
-    ctx.skipped.push({ ref, reason: 'conversion_error' });
+    ctx.skipped.push({ ref, reason: "conversion_error" });
     return;
   }
 
@@ -224,7 +226,7 @@ async function fetchSingleDocument(
     title: doc.title ?? undefined,
     content,
     truncated: truncated || undefined,
-    totalLines: content.split('\n').length,
+    totalLines: content.split("\n").length,
     source: {
       absPath: coll ? `${coll.path}/${doc.relPath}` : undefined,
       relPath: doc.relPath,
@@ -270,7 +272,7 @@ export async function multiGet(
 
     // Track invalid refs as skipped
     for (const ref of invalidRefs) {
-      ctx.skipped.push({ ref, reason: 'invalid_ref' });
+      ctx.skipped.push({ ref, reason: "invalid_ref" });
     }
 
     for (const ref of expandedRefs) {
@@ -302,9 +304,9 @@ export async function multiGet(
 
 function addLineNumbers(text: string, startLine = 1): string {
   return text
-    .split('\n')
+    .split("\n")
     .map((line, i) => `${startLine + i}: ${line}`)
-    .join('\n');
+    .join("\n");
 }
 
 function formatContent(content: string, lineNumbers: boolean): string {
@@ -316,10 +318,10 @@ function formatMarkdown(
   options: MultiGetCommandOptions
 ): string {
   const lines: string[] = [];
-  lines.push('# Multi-Get Results');
-  lines.push('');
+  lines.push("# Multi-Get Results");
+  lines.push("");
   lines.push(`*${data.meta.returned} of ${data.meta.requested} documents*`);
-  lines.push('');
+  lines.push("");
 
   for (const doc of data.documents) {
     lines.push(`## ${doc.title || doc.source.relPath}`);
@@ -327,21 +329,21 @@ function formatMarkdown(
     if (doc.truncated) {
       lines.push(`- **Truncated**: yes (max ${data.meta.maxBytes} bytes)`);
     }
-    lines.push('');
-    lines.push('```');
+    lines.push("");
+    lines.push("```");
     lines.push(formatContent(doc.content, Boolean(options.lineNumbers)));
-    lines.push('```');
-    lines.push('');
+    lines.push("```");
+    lines.push("");
   }
 
   if (data.skipped.length > 0) {
-    lines.push('## Skipped');
+    lines.push("## Skipped");
     for (const s of data.skipped) {
       lines.push(`- ${s.ref}: ${s.reason}`);
     }
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function formatTerminal(
@@ -353,17 +355,17 @@ function formatTerminal(
   for (const doc of data.documents) {
     lines.push(`=== ${doc.uri} ===`);
     lines.push(formatContent(doc.content, Boolean(options.lineNumbers)));
-    lines.push('');
+    lines.push("");
   }
 
   if (data.skipped.length > 0) {
-    lines.push(`Skipped: ${data.skipped.map((s) => s.ref).join(', ')}`);
+    lines.push(`Skipped: ${data.skipped.map((s) => s.ref).join(", ")}`);
   }
 
   lines.push(
     `${data.meta.returned}/${data.meta.requested} documents retrieved`
   );
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 /**
@@ -376,7 +378,7 @@ export function formatMultiGet(
   if (!result.success) {
     if (options.json) {
       return JSON.stringify({
-        error: { code: 'MULTI_GET_FAILED', message: result.error },
+        error: { code: "MULTI_GET_FAILED", message: result.error },
       });
     }
     return `Error: ${result.error}`;
@@ -389,7 +391,7 @@ export function formatMultiGet(
   }
 
   if (options.files) {
-    return data.documents.map((d) => `${d.docid},${d.uri}`).join('\n');
+    return data.documents.map((d) => `${d.docid},${d.uri}`).join("\n");
   }
 
   if (options.md) {

package/src/cli/commands/query.ts

@@ -5,26 +5,27 @@
  * @module src/cli/commands/query
  */
 
-import { LlmAdapter } from '../../llm/nodeLlamaCpp/adapter';
-import { resolveDownloadPolicy } from '../../llm/policy';
-import { getActivePreset } from '../../llm/registry';
 import type {
   EmbeddingPort,
   GenerationPort,
   RerankPort,
-} from '../../llm/types';
-import { type HybridSearchDeps, searchHybrid } from '../../pipeline/hybrid';
-import type { HybridSearchOptions, SearchResults } from '../../pipeline/types';
+} from "../../llm/types";
+import type { HybridSearchOptions, SearchResults } from "../../pipeline/types";
+
+import { LlmAdapter } from "../../llm/nodeLlamaCpp/adapter";
+import { resolveDownloadPolicy } from "../../llm/policy";
+import { getActivePreset } from "../../llm/registry";
+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
@@ -52,7 +53,7 @@ export type QueryCommandOptions = HybridSearchOptions & {
 };
 
 export interface QueryFormatOptions {
-  format: 'terminal' | 'json' | 'files' | 'csv' | 'md' | 'xml';
+  format: "terminal" | "json" | "files" | "csv" | "md" | "xml";
   full?: boolean;
   lineNumbers?: boolean;
 }
@@ -68,7 +69,7 @@ export type QueryResult =
 /**
  * Execute gno query 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 query(
   queryText: string,
   options: QueryCommandOptions = {}
@@ -113,7 +114,7 @@ export async function query(
     const embedResult = await llm.createEmbeddingPort(embedUri, {
       policy,
       onProgress: downloadProgress
-        ? (progress) => downloadProgress('embed', progress)
+        ? (progress) => downloadProgress("embed", progress)
         : undefined,
     });
     if (embedResult.ok) {
@@ -126,7 +127,7 @@ export async function query(
       const genResult = await llm.createGenerationPort(genUri, {
         policy,
         onProgress: downloadProgress
-          ? (progress) => downloadProgress('gen', progress)
+          ? (progress) => downloadProgress("gen", progress)
           : undefined,
       });
       if (genResult.ok) {
@@ -140,7 +141,7 @@ export async function query(
       const rerankResult = await llm.createRerankPort(rerankUri, {
         policy,
         onProgress: downloadProgress
-          ? (progress) => downloadProgress('rerank', progress)
+          ? (progress) => downloadProgress("rerank", progress)
           : undefined,
       });
       if (rerankResult.ok) {
@@ -150,7 +151,7 @@ export async function query(
 
     // Clear progress line if shown
     if (showProgress && downloadProgress) {
-      process.stderr.write('\n');
+      process.stderr.write("\n");
     }
 
     // Create vector index (optional)
@@ -223,7 +224,7 @@ function outputExplainToStderr(data: SearchResults): void {
   const {
     formatExplain,
     formatResultExplain,
-  } = require('../../pipeline/explain');
+  } = require("../../pipeline/explain");
   process.stderr.write(`${formatExplain(explain.lines)}\n`);
   process.stderr.write(`${formatResultExplain(explain.results)}\n`);
 }
@@ -237,9 +238,9 @@ export function formatQuery(
   options: QueryFormatOptions
 ): string {
   if (!result.success) {
-    return options.format === 'json'
+    return options.format === "json"
       ? JSON.stringify({
-          error: { code: 'QUERY_FAILED', message: result.error },
+          error: { code: "QUERY_FAILED", message: result.error },
         })
       : `Error: ${result.error}`;
   }
@@ -249,7 +250,7 @@ export function formatQuery(
 
   // Use shared formatter for consistent output
   // Dynamic import to keep module loading fast
-  const { formatSearchResults } = require('../format/search-results');
+  const { formatSearchResults } = require("../format/search-results");
   return formatSearchResults(result.data, {
     format: options.format,
     full: options.full,

package/src/cli/commands/ref-parser.ts

@@ -9,7 +9,7 @@
 // Types
 // ─────────────────────────────────────────────────────────────────────────────
 
-export type RefType = 'docid' | 'uri' | 'collPath';
+export type RefType = "docid" | "uri" | "collPath";
 
 export interface ParsedRef {
   type: RefType;
@@ -45,14 +45,14 @@ const GLOB_PATTERN = /[*?[\]]/;
  */
 export function parseRef(ref: string): ParseRefResult {
   // 1. DocID: starts with #, validate pattern
-  if (ref.startsWith('#')) {
-    if (ref.includes(':')) {
-      return { error: 'Docid refs cannot have :line suffix' };
+  if (ref.startsWith("#")) {
+    if (ref.includes(":")) {
+      return { error: "Docid refs cannot have :line suffix" };
     }
     if (!DOCID_PATTERN.test(ref)) {
       return { error: `Invalid docid format: ${ref}` };
     }
-    return { type: 'docid', value: ref };
+    return { type: "docid", value: ref };
   }
 
   // 2. Parse optional :line suffix for URI and collPath
@@ -69,19 +69,19 @@ export function parseRef(ref: string): ParseRefResult {
   }
 
   // 3. URI: starts with gno://
-  if (baseRef.startsWith('gno://')) {
-    return { type: 'uri', value: baseRef, line };
+  if (baseRef.startsWith("gno://")) {
+    return { type: "uri", value: baseRef, line };
   }
 
   // 4. Collection/path: must contain /
-  const slashIdx = baseRef.indexOf('/');
+  const slashIdx = baseRef.indexOf("/");
   if (slashIdx === -1) {
     return { error: `Invalid ref format (missing /): ${ref}` };
   }
   const collection = baseRef.slice(0, slashIdx);
   const relPath = baseRef.slice(slashIdx + 1);
 
-  return { type: 'collPath', value: baseRef, collection, relPath, line };
+  return { type: "collPath", value: baseRef, collection, relPath, line };
 }
 
 /**
@@ -90,7 +90,7 @@ export function parseRef(ref: string): ParseRefResult {
 export function splitRefs(refs: string[]): string[] {
   const result: string[] = [];
   for (const r of refs) {
-    for (const part of r.split(',')) {
+    for (const part of r.split(",")) {
       const trimmed = part.trim();
       if (trimmed) {
         result.push(trimmed);

package/src/cli/commands/reset.ts

@@ -5,13 +5,14 @@
  */
 
 // node:fs/promises: rm and stat for recursive directory deletion (no Bun equivalent)
-import { rm, stat } from 'node:fs/promises';
+import { rm, stat } from "node:fs/promises";
 // node:os: homedir for platform-agnostic home directory (no Bun equivalent)
-import { homedir } from 'node:os';
+import { homedir } from "node:os";
 // node:path: path manipulation utilities (no Bun equivalent)
-import { isAbsolute, normalize, sep } from 'node:path';
-import { resolveDirs } from '../../app/constants';
-import { CliError } from '../errors';
+import { isAbsolute, normalize, sep } from "node:path";
+
+import { resolveDirs } from "../../app/constants";
+import { CliError } from "../errors";
 
 interface ResetOptions {
   confirm?: boolean;
@@ -21,7 +22,7 @@ interface ResetOptions {
 
 interface DirResult {
   path: string;
-  status: 'deleted' | 'missing' | 'kept';
+  status: "deleted" | "missing" | "kept";
   error?: string;
 }
 
@@ -32,12 +33,12 @@ interface ResetResult {
 
 // Forbidden paths that should never be deleted
 const FORBIDDEN_PATHS = new Set([
-  '/',
-  '/Users',
-  '/home',
-  '/var',
-  '/etc',
-  '/tmp',
+  "/",
+  "/Users",
+  "/home",
+  "/var",
+  "/etc",
+  "/tmp",
 ]);
 
 /**
@@ -49,7 +50,7 @@ function assertSafePath(path: string, label: string): void {
 
   // Must be absolute
   if (!isAbsolute(normalized)) {
-    throw new CliError('VALIDATION', `${label} path must be absolute: ${path}`);
+    throw new CliError("VALIDATION", `${label} path must be absolute: ${path}`);
   }
 
   // Must not be a forbidden system path
@@ -57,14 +58,14 @@ function assertSafePath(path: string, label: string): void {
     FORBIDDEN_PATHS.has(normalized) ||
     FORBIDDEN_PATHS.has(`${normalized}${sep}`)
   ) {
-    throw new CliError('VALIDATION', `Refusing to delete system path: ${path}`);
+    throw new CliError("VALIDATION", `Refusing to delete system path: ${path}`);
   }
 
   // Must be under home directory (for user safety)
   const home = homedir();
   if (!normalized.startsWith(home + sep) && normalized !== home) {
     throw new CliError(
-      'VALIDATION',
+      "VALIDATION",
       `${label} path must be under home directory: ${path}`
     );
   }
@@ -72,7 +73,7 @@ function assertSafePath(path: string, label: string): void {
   // Must not be home directory itself
   if (normalized === home || normalized === home + sep) {
     throw new CliError(
-      'VALIDATION',
+      "VALIDATION",
       `Refusing to delete home directory: ${path}`
     );
   }
@@ -84,8 +85,8 @@ function assertSafePath(path: string, label: string): void {
 export async function reset(options: ResetOptions): Promise<ResetResult> {
   if (!options.confirm) {
     throw new CliError(
-      'VALIDATION',
-      'Reset requires --confirm or --yes flag to prevent accidental data loss'
+      "VALIDATION",
+      "Reset requires --confirm or --yes flag to prevent accidental data loss"
     );
   }
 
@@ -94,12 +95,12 @@ export async function reset(options: ResetOptions): Promise<ResetResult> {
   const errors: string[] = [];
 
   // Validate all paths before deleting anything
-  assertSafePath(dirs.data, 'Data');
+  assertSafePath(dirs.data, "Data");
   if (!options.keepConfig) {
-    assertSafePath(dirs.config, 'Config');
+    assertSafePath(dirs.config, "Config");
   }
   if (!options.keepCache) {
-    assertSafePath(dirs.cache, 'Cache');
+    assertSafePath(dirs.cache, "Cache");
   }
 
   // Delete data directory (always, contains index DB)
@@ -107,14 +108,14 @@ export async function reset(options: ResetOptions): Promise<ResetResult> {
 
   // Delete config unless --keep-config
   if (options.keepConfig) {
-    results.push({ path: dirs.config, status: 'kept' });
+    results.push({ path: dirs.config, status: "kept" });
   } else {
     results.push(await rmDir(dirs.config));
   }
 
   // Delete cache unless --keep-cache
   if (options.keepCache) {
-    results.push({ path: dirs.cache, status: 'kept' });
+    results.push({ path: dirs.cache, status: "kept" });
   } else {
     results.push(await rmDir(dirs.cache));
   }
@@ -127,7 +128,7 @@ export async function reset(options: ResetOptions): Promise<ResetResult> {
   }
 
   if (errors.length > 0) {
-    throw new CliError('RUNTIME', `Reset failed:\n${errors.join('\n')}`);
+    throw new CliError("RUNTIME", `Reset failed:\n${errors.join("\n")}`);
   }
 
   return { results, errors };
@@ -139,18 +140,18 @@ async function rmDir(path: string): Promise<DirResult> {
     await stat(path);
   } catch (e) {
     const err = e as NodeJS.ErrnoException;
-    if (err.code === 'ENOENT') {
-      return { path, status: 'missing' };
+    if (err.code === "ENOENT") {
+      return { path, status: "missing" };
     }
-    return { path, status: 'missing', error: err.message };
+    return { path, status: "missing", error: err.message };
   }
 
   try {
     await rm(path, { recursive: true, force: true });
-    return { path, status: 'deleted' };
+    return { path, status: "deleted" };
   } catch (e) {
     const err = e as NodeJS.ErrnoException;
-    return { path, status: 'missing', error: err.message };
+    return { path, status: "missing", error: err.message };
   }
 }
 
@@ -158,34 +159,34 @@ async function rmDir(path: string): Promise<DirResult> {
  * Format reset result for terminal output.
  */
 export function formatReset(result: ResetResult): string {
-  const deleted = result.results.filter((r) => r.status === 'deleted');
-  const missing = result.results.filter((r) => r.status === 'missing');
-  const kept = result.results.filter((r) => r.status === 'kept');
+  const deleted = result.results.filter((r) => r.status === "deleted");
+  const missing = result.results.filter((r) => r.status === "missing");
+  const kept = result.results.filter((r) => r.status === "kept");
 
-  const lines: string[] = ['GNO reset complete.', ''];
+  const lines: string[] = ["GNO reset complete.", ""];
 
   if (deleted.length > 0) {
-    lines.push('Deleted:');
+    lines.push("Deleted:");
     for (const r of deleted) {
       lines.push(`  ${r.path}`);
     }
   }
 
   if (missing.length > 0) {
-    lines.push('');
-    lines.push('Already missing:');
+    lines.push("");
+    lines.push("Already missing:");
     for (const r of missing) {
       lines.push(`  ${r.path}`);
     }
   }
 
   if (kept.length > 0) {
-    lines.push('');
-    lines.push('Kept:');
+    lines.push("");
+    lines.push("Kept:");
     for (const r of kept) {
       lines.push(`  ${r.path}`);
     }
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }

package/src/cli/commands/search.ts

@@ -5,13 +5,14 @@
  * @module src/cli/commands/search
  */
 
-import { searchBm25 } from '../../pipeline/search';
-import type { SearchOptions, SearchResults } from '../../pipeline/types';
+import type { SearchOptions, SearchResults } from "../../pipeline/types";
+
+import { searchBm25 } from "../../pipeline/search";
 import {
   type FormatOptions,
   formatSearchResults,
-} from '../format/search-results';
-import { initStore } from './shared';
+} from "../format/search-results";
+import { initStore } from "./shared";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -71,7 +72,7 @@ export async function search(
 
     if (!result.ok) {
       // Map INVALID_INPUT to validation error for proper exit code
-      const isValidation = result.error.code === 'INVALID_INPUT';
+      const isValidation = result.error.code === "INVALID_INPUT";
       return {
         success: false,
         error: result.error.message,
@@ -92,23 +93,23 @@ export async function search(
 /**
  * Get output format from options.
  */
-function getFormatType(options: SearchCommandOptions): FormatOptions['format'] {
+function getFormatType(options: SearchCommandOptions): FormatOptions["format"] {
   if (options.json) {
-    return 'json';
+    return "json";
   }
   if (options.files) {
-    return 'files';
+    return "files";
   }
   if (options.csv) {
-    return 'csv';
+    return "csv";
   }
   if (options.md) {
-    return 'md';
+    return "md";
   }
   if (options.xml) {
-    return 'xml';
+    return "xml";
   }
-  return 'terminal';
+  return "terminal";
 }
 
 /**
@@ -121,7 +122,7 @@ export function formatSearch(
   if (!result.success) {
     return options.json
       ? JSON.stringify({
-          error: { code: 'QUERY_FAILED', message: result.error },
+          error: { code: "QUERY_FAILED", message: result.error },
         })
       : `Error: ${result.error}`;
   }