@gmickel/gno 0.7.0 → 0.8.1

package/src/cli/commands/get.ts

@@ -5,10 +5,11 @@
  * @module src/cli/commands/get
  */
 
-import type { DocumentRow, StorePort, StoreResult } from '../../store/types';
-import type { ParsedRef } from './ref-parser';
-import { parseRef } from './ref-parser';
-import { initStore } from './shared';
+import type { DocumentRow, StorePort, StoreResult } from "../../store/types";
+import type { ParsedRef } from "./ref-parser";
+
+import { parseRef } from "./ref-parser";
+import { initStore } from "./shared";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -68,11 +69,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 });
       }
@@ -100,7 +101,7 @@ export async function get(
   }
 
   const parsed = parseRef(ref);
-  if ('error' in parsed) {
+  if ("error" in parsed) {
     return { success: false, error: parsed.error, isValidation: true };
   }
 
@@ -121,14 +122,14 @@ function validateOptions(options: GetCommandOptions): GetResult | null {
   if (options.from !== undefined && options.from <= 0) {
     return {
       success: false,
-      error: '--from must be a positive integer',
+      error: "--from must be a positive integer",
       isValidation: true,
     };
   }
   if (options.limit !== undefined && options.limit < 0) {
     return {
       success: false,
-      error: '-l/--limit cannot be negative',
+      error: "-l/--limit cannot be negative",
       isValidation: true,
     };
   }
@@ -152,19 +153,19 @@ async function fetchDocument(
 
   const doc = docResult.value;
   if (!doc?.active) {
-    return { success: false, error: 'Document not found' };
+    return { success: false, error: "Document not found" };
   }
 
   if (!doc.mirrorHash) {
     return {
       success: false,
-      error: 'Mirror content unavailable (conversion error)',
+      error: "Mirror content unavailable (conversion error)",
     };
   }
 
   const contentResult = await store.getContent(doc.mirrorHash);
   if (!contentResult.ok || contentResult.value === null) {
-    return { success: false, error: 'Mirror content unavailable' };
+    return { success: false, error: "Mirror content unavailable" };
   }
 
   return buildResponse({
@@ -186,7 +187,7 @@ interface BuildResponseContext {
 
 function buildResponse(ctx: BuildResponseContext): GetResult {
   const { doc, fullContent, parsed, options, config } = ctx;
-  const lines = fullContent.split('\n');
+  const lines = fullContent.split("\n");
   const totalLines = lines.length;
 
   // Handle -l 0 case - return empty content
@@ -197,7 +198,7 @@ function buildResponse(ctx: BuildResponseContext): GetResult {
         docid: doc.docid,
         uri: doc.uri,
         title: doc.title ?? undefined,
-        content: '',
+        content: "",
         totalLines,
         language: doc.languageHint ?? undefined,
         source: buildSourceMeta(doc, config),
@@ -215,7 +216,7 @@ function buildResponse(ctx: BuildResponseContext): GetResult {
   const clampedEnd = Math.min(clampedStart + limit - 1, totalLines);
 
   const selectedLines = lines.slice(clampedStart - 1, clampedEnd);
-  const content = selectedLines.join('\n');
+  const content = selectedLines.join("\n");
   const isPartial = clampedStart > 1 || clampedEnd < totalLines;
 
   return {
@@ -252,7 +253,7 @@ interface DocRow {
 function buildSourceMeta(
   doc: DocRow,
   config: ConfigLike
-): GetResponse['source'] {
+): GetResponse["source"] {
   const coll = config.collections.find((c) => c.name === doc.collection);
   const absPath = coll ? `${coll.path}/${doc.relPath}` : undefined;
 
@@ -274,7 +275,7 @@ interface ConversionDoc {
 
 function buildConversionMeta(
   doc: ConversionDoc
-): GetResponse['conversion'] | undefined {
+): GetResponse["conversion"] | undefined {
   if (!doc.converterId) {
     return;
   }
@@ -291,9 +292,9 @@ function buildConversionMeta(
 
 function addLineNumbers(text: string, startLine: number): string {
   return text
-    .split('\n')
+    .split("\n")
     .map((line, i) => `${startLine + i}: ${line}`)
-    .join('\n');
+    .join("\n");
 }
 
 function getContentWithLineNumbers(
@@ -317,7 +318,7 @@ export function formatGet(
   if (!result.success) {
     if (options.json) {
       return JSON.stringify({
-        error: { code: 'GET_FAILED', message: result.error },
+        error: { code: "GET_FAILED", message: result.error },
       });
     }
     return `Error: ${result.error}`;
@@ -340,7 +341,7 @@ export function formatGet(
 function formatMarkdown(data: GetResponse, options: GetCommandOptions): string {
   const lines: string[] = [];
   lines.push(`# ${data.title || data.source.relPath}`);
-  lines.push('');
+  lines.push("");
   lines.push(`- **URI**: \`${data.uri}\``);
   lines.push(`- **DocID**: \`${data.docid}\``);
   if (data.returnedLines) {
@@ -348,9 +349,9 @@ function formatMarkdown(data: GetResponse, options: GetCommandOptions): string {
       `- **Lines**: ${data.returnedLines.start}-${data.returnedLines.end} of ${data.totalLines}`
     );
   }
-  lines.push('');
-  lines.push('```');
+  lines.push("");
+  lines.push("```");
   lines.push(getContentWithLineNumbers(data, options));
-  lines.push('```');
-  return lines.join('\n');
+  lines.push("```");
+  return lines.join("\n");
 }

package/src/cli/commands/index-cmd.ts

@@ -5,8 +5,8 @@
  * @module src/cli/commands/indexCmd
  */
 
-import { defaultSyncService, type SyncResult } from '../../ingestion';
-import { formatSyncResultLines, initStore } from './shared';
+import { defaultSyncService, type SyncResult } from "../../ingestion";
+import { formatSyncResultLines, initStore } from "./shared";
 
 /**
  * Options for index command.
@@ -68,7 +68,7 @@ export async function index(options: IndexOptions = {}): Promise<IndexResult> {
       | undefined;
 
     if (!embedSkipped) {
-      const { embed } = await import('./embed');
+      const { embed } = await import("./embed");
       const result = await embed({
         configPath: options.configPath,
       });
@@ -99,21 +99,21 @@ export function formatIndex(
   }
 
   const { syncResult, embedSkipped } = result;
-  const lines: string[] = ['Indexing complete.', ''];
+  const lines: string[] = ["Indexing complete.", ""];
 
   lines.push(...formatSyncResultLines(syncResult, options));
 
   if (embedSkipped) {
-    lines.push('');
-    lines.push('Embedding skipped (--no-embed)');
+    lines.push("");
+    lines.push("Embedding skipped (--no-embed)");
   } else if (result.embedResult) {
-    lines.push('');
+    lines.push("");
     const { embedded, errors, duration } = result.embedResult;
-    const errPart = errors > 0 ? ` (${errors} errors)` : '';
+    const errPart = errors > 0 ? ` (${errors} errors)` : "";
     lines.push(
       `Embedded ${embedded} chunks in ${(duration / 1000).toFixed(1)}s${errPart}`
     );
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }

package/src/cli/commands/index.ts

@@ -9,13 +9,13 @@ export {
   type AskCommandResult,
   ask,
   formatAsk,
-} from './ask';
+} from "./ask";
 export {
   type CleanupOptions,
   type CleanupResult,
   cleanup,
   formatCleanup,
-} from './cleanup';
+} from "./cleanup";
 export {
   type DoctorCheck,
   type DoctorCheckStatus,
@@ -23,27 +23,27 @@ export {
   type DoctorResult,
   doctor,
   formatDoctor,
-} from './doctor';
+} from "./doctor";
 export {
   type EmbedOptions,
   type EmbedResult,
   embed,
   formatEmbed,
-} from './embed';
+} from "./embed";
 export {
   formatGet,
   type GetCommandOptions,
   type GetResponse,
   type GetResult,
   get,
-} from './get';
+} from "./get";
 export {
   formatIndex,
   type IndexOptions,
   type IndexResult,
   index,
-} from './index-cmd';
-export { type InitOptions, type InitResult, init } from './init';
+} from "./index-cmd";
+export { type InitOptions, type InitResult, init } from "./init";
 export {
   formatLs,
   type LsCommandOptions,
@@ -51,8 +51,8 @@ export {
   type LsResponse,
   type LsResult,
   ls,
-} from './ls';
-export * from './models';
+} from "./ls";
+export * from "./models";
 export {
   formatMultiGet,
   type MultiGetCommandOptions,
@@ -61,13 +61,13 @@ export {
   type MultiGetResult,
   multiGet,
   type SkippedDoc,
-} from './multi-get';
+} from "./multi-get";
 export {
   formatQuery,
   type QueryCommandOptions,
   type QueryResult,
   query,
-} from './query';
+} from "./query";
 export {
   isGlobPattern,
   type ParsedRef,
@@ -75,28 +75,28 @@ export {
   parseRef,
   type RefType,
   splitRefs,
-} from './ref-parser';
+} from "./ref-parser";
 export {
   formatSearch,
   type SearchCommandOptions,
   type SearchResult,
   search,
-} from './search';
+} from "./search";
 export {
   formatStatus,
   type StatusOptions,
   type StatusResult,
   status,
-} from './status';
+} from "./status";
 export {
   formatUpdate,
   type UpdateOptions,
   type UpdateResult,
   update,
-} from './update';
+} from "./update";
 export {
   formatVsearch,
   type VsearchCommandOptions,
   type VsearchResult,
   vsearch,
-} from './vsearch';
+} from "./vsearch";

package/src/cli/commands/init.ts

@@ -5,8 +5,9 @@
  * @module src/cli/commands/init
  */
 
-import { basename } from 'node:path';
-import { getIndexDbPath } from '../../app/constants';
+import { basename } from "node:path";
+
+import { getIndexDbPath } from "../../app/constants";
 import {
   type Collection,
   createDefaultConfig,
@@ -22,7 +23,7 @@ import {
   pathExists,
   saveConfig,
   toAbsolutePath,
-} from '../../config';
+} from "../../config";
 
 /** Pattern to replace invalid chars in collection names with hyphens */
 const INVALID_NAME_CHARS = /[^a-z0-9_-]/g;
@@ -98,7 +99,7 @@ async function handleAlreadyInitialized(
       configPath: paths.configFile,
       dataDir: paths.dataDir,
       dbPath,
-      error: 'Config exists but could not be loaded',
+      error: "Config exists but could not be loaded",
     };
   }
 
@@ -165,7 +166,7 @@ export async function init(options: InitOptions = {}): Promise<InitResult> {
       configPath: paths.configFile,
       dataDir: paths.dataDir,
       dbPath: getIndexDbPath(),
-      error: `Invalid tokenizer: ${options.tokenizer}. Valid: ${FTS_TOKENIZERS.join(', ')}`,
+      error: `Invalid tokenizer: ${options.tokenizer}. Valid: ${FTS_TOKENIZERS.join(", ")}`,
     };
   }
 
@@ -211,7 +212,7 @@ export async function init(options: InitOptions = {}): Promise<InitResult> {
   const dbExists = await dbFile.exists();
   if (!dbExists) {
     try {
-      await Bun.write(dbPath, '');
+      await Bun.write(dbPath, "");
     } catch (error) {
       return {
         success: false,
@@ -242,7 +243,7 @@ async function addCollectionToConfig(
   { success: true; collectionName: string } | { success: false; error: string }
 > {
   if (!options.path) {
-    return { success: false, error: 'Path is required' };
+    return { success: false, error: "Path is required" };
   }
 
   // Convert to absolute path
@@ -260,17 +261,17 @@ async function addCollectionToConfig(
   // Determine collection name
   let collectionName =
     options.name ??
-    basename(absolutePath).toLowerCase().replace(INVALID_NAME_CHARS, '-');
+    basename(absolutePath).toLowerCase().replace(INVALID_NAME_CHARS, "-");
 
   // Ensure name starts with alphanumeric (strip leading non-alphanumeric)
-  collectionName = collectionName.replace(LEADING_NON_ALPHANUMERIC, '');
+  collectionName = collectionName.replace(LEADING_NON_ALPHANUMERIC, "");
 
   // Validate derived name
   if (!collectionName || collectionName.length > 64) {
     return {
       success: false,
       error:
-        'Cannot derive valid collection name from path. Please specify --name explicitly.',
+        "Cannot derive valid collection name from path. Please specify --name explicitly.",
     };
   }
 
@@ -285,14 +286,14 @@ async function addCollectionToConfig(
   // Parse include/exclude CSV if provided (filter empty entries)
   const include = options.include
     ? options.include
-        .split(',')
+        .split(",")
         .map((ext) => ext.trim())
         .filter(Boolean)
     : [];
 
   const exclude = options.exclude
     ? options.exclude
-        .split(',')
+        .split(",")
         .map((pattern) => pattern.trim())
         .filter(Boolean)
     : [...DEFAULT_EXCLUDES];

package/src/cli/commands/ls.ts

@@ -5,8 +5,9 @@
  * @module src/cli/commands/ls
  */
 
-import type { DocumentRow, StorePort, StoreResult } from '../../store/types';
-import { initStore } from './shared';
+import type { DocumentRow, StorePort, StoreResult } from "../../store/types";
+
+import { initStore } from "./shared";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -65,7 +66,7 @@ async function fetchDocuments(
     return store.listDocuments();
   }
 
-  if (scope.startsWith('gno://')) {
+  if (scope.startsWith("gno://")) {
     const allDocs = await store.listDocuments();
     if (!allDocs.ok) {
       return allDocs;
@@ -91,18 +92,18 @@ export async function ls(
   options: LsCommandOptions = {}
 ): Promise<LsResult> {
   // Validate scope if it's a gno:// URI
-  if (scope?.startsWith('gno://')) {
-    if (scope === 'gno://') {
+  if (scope?.startsWith("gno://")) {
+    if (scope === "gno://") {
       return {
         success: false,
-        error: 'Invalid scope: missing collection',
+        error: "Invalid scope: missing collection",
         isValidation: true,
       };
     }
     if (!URI_PREFIX_PATTERN.test(scope)) {
       return {
         success: false,
-        error: 'Invalid scope: missing trailing path (use gno://collection/)',
+        error: "Invalid scope: missing trailing path (use gno://collection/)",
         isValidation: true,
       };
     }
@@ -167,7 +168,7 @@ export function formatLs(result: LsResult, options: LsCommandOptions): string {
   if (!result.success) {
     if (options.json) {
       return JSON.stringify({
-        error: { code: 'LS_FAILED', message: result.error },
+        error: { code: "LS_FAILED", message: result.error },
       });
     }
     return `Error: ${result.error}`;
@@ -181,31 +182,31 @@ export function formatLs(result: LsResult, options: LsCommandOptions): string {
   }
 
   if (options.files) {
-    return docs.map((d) => `${d.docid},${d.uri}`).join('\n');
+    return docs.map((d) => `${d.docid},${d.uri}`).join("\n");
   }
 
   if (options.md) {
     if (docs.length === 0) {
-      return '# Documents\n\nNo documents found.';
+      return "# Documents\n\nNo documents found.";
     }
     const lines: string[] = [];
-    lines.push('# Documents');
-    lines.push('');
+    lines.push("# Documents");
+    lines.push("");
     lines.push(
       `*Showing ${data.meta.returned} of ${data.meta.total} documents*`
     );
-    lines.push('');
-    lines.push('| DocID | URI | Title |');
-    lines.push('|-------|-----|-------|');
+    lines.push("");
+    lines.push("| DocID | URI | Title |");
+    lines.push("|-------|-----|-------|");
     for (const d of docs) {
-      lines.push(`| \`${d.docid}\` | \`${d.uri}\` | ${d.title || '-'} |`);
+      lines.push(`| \`${d.docid}\` | \`${d.uri}\` | ${d.title || "-"} |`);
     }
-    return lines.join('\n');
+    return lines.join("\n");
   }
 
   // Terminal format
   if (docs.length === 0) {
-    return 'No documents found.';
+    return "No documents found.";
   }
   const lines = docs.map((d) => `${d.docid}\t${d.uri}`);
   if (data.meta.returned < data.meta.total) {
@@ -213,5 +214,5 @@ export function formatLs(result: LsResult, options: LsCommandOptions): string {
       `\n(${data.meta.returned} of ${data.meta.total} documents shown)`
     );
   }
-  return lines.join('\n');
+  return lines.join("\n");
 }

package/src/cli/commands/mcp/config.ts

@@ -5,10 +5,12 @@
  * @module src/cli/commands/mcp/config
  */
 
-import { copyFile, mkdir, rename, stat, unlink } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import { CliError } from '../../errors.js';
-import type { McpConfigFormat } from './paths.js';
+import { copyFile, mkdir, rename, stat, unlink } from "node:fs/promises";
+import { dirname } from "node:path";
+
+import type { McpConfigFormat } from "./paths.js";
+
+import { CliError } from "../../errors.js";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -22,7 +24,7 @@ export interface StandardMcpEntry {
 
 /** OpenCode mcp entry (command is array, has type and enabled) */
 export interface OpenCodeMcpEntry {
-  type: 'local';
+  type: "local";
   command: string[];
   enabled: boolean;
 }
@@ -47,7 +49,7 @@ export interface OpenCodeConfig {
 
 /** Amp config with amp.mcpServers key */
 export interface AmpConfig {
-  'amp.mcpServers'?: Record<string, StandardMcpEntry>;
+  "amp.mcpServers"?: Record<string, StandardMcpEntry>;
   [key: string]: unknown;
 }
 
@@ -64,19 +66,19 @@ export type AnyMcpConfig = McpConfig | ZedConfig | OpenCodeConfig | AmpConfig;
  */
 async function checkConfigPath(
   configPath: string
-): Promise<'file' | 'missing'> {
+): Promise<"file" | "missing"> {
   try {
     const stats = await stat(configPath);
     if (!stats.isFile()) {
       throw new CliError(
-        'RUNTIME',
+        "RUNTIME",
         `Config path exists but is not a file: ${configPath}`
       );
     }
-    return 'file';
+    return "file";
   } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
-      return 'missing';
+    if ((err as NodeJS.ErrnoException).code === "ENOENT") {
+      return "missing";
     }
     throw err;
   }
@@ -94,7 +96,7 @@ export async function readMcpConfig(
 ): Promise<McpConfig | null> {
   const pathStatus = await checkConfigPath(configPath);
 
-  if (pathStatus === 'missing') {
+  if (pathStatus === "missing") {
     return options?.returnNullOnMissing ? null : {};
   }
 
@@ -112,9 +114,9 @@ export async function readMcpConfig(
     }
     return JSON.parse(content) as McpConfig;
   } catch {
-    const format = options?.yaml ? 'YAML' : 'JSON';
+    const format = options?.yaml ? "YAML" : "JSON";
     throw new CliError(
-      'RUNTIME',
+      "RUNTIME",
       `Malformed ${format} in ${configPath}. Please fix or backup and delete the file.`
     );
   }
@@ -175,20 +177,20 @@ export async function writeMcpConfig(
  */
 export function getServersKey(
   format: McpConfigFormat
-): 'mcpServers' | 'context_servers' | 'mcp' | 'amp.mcpServers' {
+): "mcpServers" | "context_servers" | "mcp" | "amp.mcpServers" {
   switch (format) {
-    case 'standard':
-    case 'yaml_standard':
-      return 'mcpServers';
-    case 'context_servers':
-      return 'context_servers';
-    case 'mcp':
-      return 'mcp';
-    case 'amp_mcp':
-      return 'amp.mcpServers';
+    case "standard":
+    case "yaml_standard":
+      return "mcpServers";
+    case "context_servers":
+      return "context_servers";
+    case "mcp":
+      return "mcp";
+    case "amp_mcp":
+      return "amp.mcpServers";
     default: {
       const _exhaustive: never = format;
-      throw new Error(`Unknown format: ${_exhaustive}`);
+      throw new Error(`Unknown format: ${String(_exhaustive)}`);
     }
   }
 }
@@ -197,7 +199,7 @@ export function getServersKey(
  * Check if format uses YAML.
  */
 export function isYamlFormat(format: McpConfigFormat): boolean {
-  return format === 'yaml_standard';
+  return format === "yaml_standard";
 }
 
 /**
@@ -236,10 +238,10 @@ export function buildEntry(
   args: string[],
   format: McpConfigFormat
 ): StandardMcpEntry | OpenCodeMcpEntry {
-  if (format === 'mcp') {
+  if (format === "mcp") {
     // OpenCode: command is array [command, ...args]
     return {
-      type: 'local',
+      type: "local",
       command: [command, ...args],
       enabled: true,
     };

package/src/cli/commands/mcp/index.ts

@@ -4,7 +4,7 @@
  * @module src/cli/commands/mcp
  */
 
-export { type InstallOptions, installMcp } from './install.js';
+export { type InstallOptions, installMcp } from "./install.js";
 export {
   buildMcpServerEntry,
   findBunPath,
@@ -19,6 +19,6 @@ export {
   resolveAllMcpPaths,
   resolveMcpConfigPath,
   TARGETS_WITH_PROJECT_SCOPE,
-} from './paths.js';
-export { type StatusOptions, statusMcp } from './status.js';
-export { type UninstallOptions, uninstallMcp } from './uninstall.js';
+} from "./paths.js";
+export { type StatusOptions, statusMcp } from "./status.js";
+export { type UninstallOptions, uninstallMcp } from "./uninstall.js";