@gmickel/gno 1.8.0 → 1.10.0

package/src/pipeline/types.ts

@@ -43,6 +43,8 @@ export interface SearchResult {
   score: number;
   uri: string;
   title?: string;
+  contentType?: string;
+  categories?: string[];
   /** Best source line for editor/agent anchors (1-indexed) */
   line?: number;
   snippet: string;
@@ -102,6 +104,8 @@ export interface SearchMeta {
     lines: ExplainLine[];
     results: ExplainResult[];
   };
+  /** Internal diagnose trace, only populated when diagnoseTrace is enabled */
+  trace?: QueryDiagnoseTrace;
 }
 
 /** Complete search results wrapper */
@@ -180,6 +184,8 @@ export type HybridSearchOptions = SearchOptions & {
   noGraph?: boolean;
   /** Language hint for prompt selection (does NOT filter retrieval, only affects expansion prompts) */
   queryLanguageHint?: string;
+  /** Internal: capture per-stage candidates for query diagnose */
+  diagnoseTrace?: boolean;
 };
 
 /** Options for ask command */
@@ -256,6 +262,34 @@ export interface FusionCandidate {
   sources: FusionSource[];
 }
 
+export type QueryDiagnoseStageId =
+  | "bm25"
+  | "vector"
+  | "fusion"
+  | "graph"
+  | "rerank";
+
+export type QueryDiagnoseStageStatus = "active" | "skipped";
+
+export interface QueryDiagnoseTraceCandidate {
+  mirrorHash: string;
+  seq: number;
+  rank: number;
+  score: number;
+}
+
+export interface QueryDiagnoseTraceStage {
+  id: QueryDiagnoseStageId;
+  status: QueryDiagnoseStageStatus;
+  reason?: string;
+  sourceCount: number;
+  candidates: QueryDiagnoseTraceCandidate[];
+}
+
+export interface QueryDiagnoseTrace {
+  stages: QueryDiagnoseTraceStage[];
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Rerank & Blending Types
 // ─────────────────────────────────────────────────────────────────────────────

package/src/pipeline/vsearch.ts

@@ -227,6 +227,8 @@ export async function searchVectorWithEmbedding(
       score,
       uri: doc.uri,
       title: doc.title ?? undefined,
+      contentType: doc.contentType ?? undefined,
+      categories: doc.categories ?? undefined,
       line: chunk.startLine,
       snippet: chunk.text,
       snippetLanguage: chunk.language ?? undefined,
@@ -281,6 +283,8 @@ export async function searchVectorWithEmbedding(
         score,
         uri: doc.uri,
         title: doc.title ?? undefined,
+        contentType: doc.contentType ?? undefined,
+        categories: doc.categories ?? undefined,
         line: chunk.startLine,
         snippet: fullContent ?? chunk.text,
         snippetLanguage: chunk.language ?? undefined,

package/src/publish/export-service.ts

@@ -7,7 +7,7 @@
 import type { Collection } from "../config/types";
 import type { DocumentRow, StorePort, TagRow } from "../store/types";
 
-import { parseRef } from "../cli/commands/ref-parser";
+import { parseRef } from "../core/ref-parser";
 import { parseFrontmatter } from "../ingestion/frontmatter";
 import { getContentBatch } from "../store/content-batch";
 import {

package/src/sdk/client.ts

@@ -44,7 +44,11 @@ import {
   getIndexDbPath,
   parseUri,
 } from "../app/constants";
-import { ConfigSchema, loadConfig } from "../config";
+import {
+  ConfigSchema,
+  loadConfig,
+  normalizeConfigContentTypes,
+} from "../config";
 import {
   buildCaptureReceipt,
   type CapturePlan,
@@ -70,7 +74,11 @@ import { resolveNotePreset } from "../core/note-presets";
 import { extractSections } from "../core/sections";
 import { normalizeStructuredQueryInput } from "../core/structured-query";
 import { parseAndValidateTagFilter } from "../core/tags";
-import { defaultSyncService, type SyncResult } from "../ingestion";
+import {
+  defaultSyncService,
+  type SyncResult,
+  withContentTypeRules,
+} from "../ingestion";
 import { updateFrontmatterTags } from "../ingestion/frontmatter";
 import { LlmAdapter } from "../llm/nodeLlamaCpp/adapter";
 import { resolveDownloadPolicy } from "../llm/policy";
@@ -141,7 +149,7 @@ async function resolveClientState(
         parsed.error.issues[0]?.message ?? "Invalid config"
       );
     }
-    config = parsed.data;
+    config = normalizeConfigContentTypes(parsed.data).config;
     configPath = null;
     configSource = "inline";
   } else {
@@ -695,10 +703,17 @@ class GnoClientImpl implements GnoClient {
   async update(options: GnoUpdateOptions = {}): Promise<SyncResult> {
     this.assertOpen();
     const collections = this.getCollections(options.collection);
-    return defaultSyncService.syncAll(collections, this.store, {
-      gitPull: options.gitPull,
-      runUpdateCmd: true,
-    });
+    return defaultSyncService.syncAll(
+      collections,
+      this.store,
+      withContentTypeRules(
+        {
+          gitPull: options.gitPull,
+          runUpdateCmd: true,
+        },
+        this.config
+      )
+    );
   }
 
   async embed(options: GnoEmbedOptions = {}): Promise<GnoEmbedResult> {
@@ -808,10 +823,13 @@ class GnoClientImpl implements GnoClient {
       collection,
       this.store,
       [plan.relPath],
-      {
-        runUpdateCmd: false,
-        gitPull: false,
-      }
+      withContentTypeRules(
+        {
+          runUpdateCmd: false,
+          gitPull: false,
+        },
+        this.config
+      )
     );
     const syncResult = syncResults[0];
     if (!syncResult || syncResult.status === "error") {
@@ -903,10 +921,13 @@ class GnoClientImpl implements GnoClient {
       collection,
       this.store,
       [plan.relPath],
-      {
-        runUpdateCmd: false,
-        gitPull: false,
-      }
+      withContentTypeRules(
+        {
+          runUpdateCmd: false,
+          gitPull: false,
+        },
+        this.config
+      )
     );
     const syncResult = syncResults[0];
     const docResult = await this.store.getDocument(
@@ -987,9 +1008,11 @@ class GnoClientImpl implements GnoClient {
     const currentPath = `${collection.path}/${storedDoc.relPath}`;
     const nextPath = `${collection.path}/${plan.nextRelPath}`;
     await renameFilePath(currentPath, nextPath);
-    await defaultSyncService.syncCollection(collection, this.store, {
-      runUpdateCmd: false,
-    });
+    await defaultSyncService.syncCollection(
+      collection,
+      this.store,
+      withContentTypeRules({ runUpdateCmd: false }, this.config)
+    );
     const linksResult = await this.store.getLinksForDoc(storedDoc.id);
     const backlinksResult = await this.store.getBacklinksForDoc(storedDoc.id);
     if (!linksResult.ok || !backlinksResult.ok) {
@@ -1044,9 +1067,11 @@ class GnoClientImpl implements GnoClient {
     const nextPath = `${collection.path}/${plan.nextRelPath}`;
     await mkdir(dirname(nextPath), { recursive: true });
     await renameFilePath(currentPath, nextPath);
-    await defaultSyncService.syncCollection(collection, this.store, {
-      runUpdateCmd: false,
-    });
+    await defaultSyncService.syncCollection(
+      collection,
+      this.store,
+      withContentTypeRules({ runUpdateCmd: false }, this.config)
+    );
     const linksResult = await this.store.getLinksForDoc(storedDoc.id);
     const backlinksResult = await this.store.getBacklinksForDoc(storedDoc.id);
     if (!linksResult.ok || !backlinksResult.ok) {
@@ -1113,9 +1138,11 @@ class GnoClientImpl implements GnoClient {
     const nextPath = `${collection.path}/${plan.nextRelPath}`;
     await mkdir(dirname(nextPath), { recursive: true });
     await copyFilePath(currentPath, nextPath);
-    await defaultSyncService.syncCollection(collection, this.store, {
-      runUpdateCmd: false,
-    });
+    await defaultSyncService.syncCollection(
+      collection,
+      this.store,
+      withContentTypeRules({ runUpdateCmd: false }, this.config)
+    );
     const linksResult = await this.store.getLinksForDoc(storedDoc.id);
     const backlinksResult = await this.store.getBacklinksForDoc(storedDoc.id);
     if (!linksResult.ok || !backlinksResult.ok) {

package/src/sdk/documents.ts

@@ -13,8 +13,8 @@ import type {
   MultiGetResponse,
   SkippedDoc,
 } from "../cli/commands/multi-get";
-import type { ParsedRef } from "../cli/commands/ref-parser";
 import type { Config } from "../config/types";
+import type { ParsedRef } from "../core/ref-parser";
 import type { DocumentRow, StorePort } from "../store/types";
 import type {
   GnoGetOptions,
@@ -22,8 +22,8 @@ import type {
   GnoMultiGetOptions,
 } from "./types";
 
-import { isGlobPattern, parseRef, splitRefs } from "../cli/commands/ref-parser";
 import { getDocumentCapabilities } from "../core/document-capabilities";
+import { isGlobPattern, parseRef, splitRefs } from "../core/ref-parser";
 import { sdkError } from "./errors";
 
 const URI_PREFIX_PATTERN = /^gno:\/\/[^/]+\//;

package/src/serve/background-runtime.ts

@@ -11,11 +11,13 @@ import type {
 import { getIndexDbPath } from "../app/constants";
 import {
   ensureDirectories,
+  formatConfigWarnings,
   getConfigPaths,
   isInitialized,
   loadConfig,
 } from "../config";
 import { defaultSyncService } from "../ingestion";
+import { withContentTypeRules } from "../ingestion";
 import { getActivePreset } from "../llm/registry";
 import { SqliteAdapter } from "../store/sqlite/adapter";
 import {
@@ -79,6 +81,7 @@ type BackgroundRuntimeDeps = {
     scheduler: EmbedScheduler | null;
     eventBus?: DocumentEventBus | null;
     callbacks?: CollectionWatchCallbacks;
+    syncOptions?: Parameters<typeof withContentTypeRules>[0];
   }) => CollectionWatchService;
 };
 
@@ -103,6 +106,9 @@ export async function startBackgroundRuntime(
   if (!configResult.ok) {
     return { success: false, error: configResult.error.message };
   }
+  for (const warning of formatConfigWarnings(configResult.warnings)) {
+    console.warn(warning);
+  }
   const config = configResult.value;
 
   if (options.requireCollections && config.collections.length === 0) {
@@ -171,6 +177,7 @@ export async function startBackgroundRuntime(
     scheduler,
     eventBus: options.eventBus ?? null,
     callbacks: options.watchCallbacks,
+    syncOptions: withContentTypeRules({}, config),
   });
   watchService.start();
   ctxHolder.watchService = watchService;
@@ -189,10 +196,17 @@ export async function startBackgroundRuntime(
       eventBus: options.eventBus ?? null,
       watchService,
       async syncAll(syncOptions = {}) {
-        const syncResult = await syncAllService(config.collections, store, {
-          gitPull: syncOptions.gitPull,
-          runUpdateCmd: syncOptions.runUpdateCmd,
-        });
+        const syncResult = await syncAllService(
+          config.collections,
+          store,
+          withContentTypeRules(
+            {
+              gitPull: syncOptions.gitPull,
+              runUpdateCmd: syncOptions.runUpdateCmd,
+            },
+            config
+          )
+        );
 
         let embedResult: EmbedResult | null = null;
         if (syncOptions.triggerEmbed !== false) {

package/src/serve/config-sync.ts

@@ -14,6 +14,7 @@ import {
   type ApplyConfigResult,
   type MutationResult,
 } from "../core/config-mutation";
+import { withContentTypeRules } from "../ingestion";
 
 /**
  * Apply a config mutation atomically with serialization.
@@ -53,7 +54,10 @@ export async function applyConfigChange(
   );
 
   if (result.ok) {
-    ctxHolder.watchService?.updateCollections(ctxHolder.config.collections);
+    ctxHolder.watchService?.updateCollections(
+      ctxHolder.config.collections,
+      withContentTypeRules({}, ctxHolder.config)
+    );
   }
 
   return result;
@@ -78,7 +82,10 @@ export async function applyConfigChangeTyped<T>(
   );
 
   if (result.ok) {
-    ctxHolder.watchService?.updateCollections(ctxHolder.config.collections);
+    ctxHolder.watchService?.updateCollections(
+      ctxHolder.config.collections,
+      withContentTypeRules({}, ctxHolder.config)
+    );
   }
 
   return result;