@kb-labs/mind-entry 2.14.0

package/dist/cli/commands/rag-index.js

@@ -0,0 +1,363 @@
+import { defineCommand, useConfig, usePlatform, useLoader } from '@kb-labs/sdk';
+import 'crypto';
+import * as path from 'path';
+import { readFile } from 'fs/promises';
+import { MindEngine } from '@kb-labs/mind-engine';
+import '@kb-labs/mind-orchestrator';
+
+// src/cli/commands/rag-index.ts
+var MIND_PRODUCT_ID = "mind";
+async function createMindRuntime(options) {
+  const config = await resolveConfig(options.cwd, options.config);
+  const platform = options.platform ?? usePlatform();
+  const service = {
+    index: async (scopeId) => {
+      const scope = resolveScope(config, scopeId);
+      const engine = createEngine(config, scope, options.cwd, options.runtime, platform, options.onProgress);
+      await engine.init();
+      const stats = await engine.index(resolveSources(config, scope), {
+        scope,
+        workspaceRoot: options.cwd
+      });
+      return stats;
+    },
+    query: async (queryOptions) => {
+      if (queryOptions.productId && queryOptions.productId !== MIND_PRODUCT_ID) {
+        throw new Error(`Unsupported productId "${queryOptions.productId}". Expected "${MIND_PRODUCT_ID}".`);
+      }
+      const scope = resolveScope(config, queryOptions.scopeId);
+      const sources = resolveSources(config, scope);
+      const engine = createEngine(config, scope, options.cwd, options.runtime, platform, options.onProgress);
+      await engine.init();
+      const result = await engine.query(
+        {
+          text: queryOptions.text,
+          intent: queryOptions.intent ?? "summary",
+          limit: queryOptions.limit,
+          profileId: queryOptions.profileId,
+          metadata: queryOptions.metadata
+        },
+        {
+          scope,
+          sources,
+          workspaceRoot: options.cwd,
+          limit: queryOptions.limit,
+          profile: queryOptions.profileId ? { id: queryOptions.profileId } : void 0
+        }
+      );
+      return result;
+    }
+  };
+  return {
+    service,
+    config
+  };
+}
+function createEngine(config, scope, cwd, runtime, platform, onProgress) {
+  const engineConfig = resolveEngineConfig(config, scope);
+  return new MindEngine(
+    {
+      id: engineConfig.id,
+      type: engineConfig.type,
+      options: {
+        ...engineConfig.options ?? {},
+        _runtime: runtime,
+        platform: platform ?? void 0,
+        onProgress
+      }
+    },
+    {
+      workspaceRoot: cwd
+    }
+  );
+}
+function resolveSources(config, scope) {
+  if (!scope.sourceIds?.length) {
+    return config.sources;
+  }
+  const selected = config.sources.filter((source) => scope.sourceIds.includes(source.id));
+  if (!selected.length) {
+    throw new Error(`Scope "${scope.id}" does not reference existing sources.`);
+  }
+  return selected;
+}
+function resolveScope(config, scopeId) {
+  const scope = config.scopes.find((item) => item.id === scopeId);
+  if (!scope) {
+    throw new Error(`Scope "${scopeId}" is not defined in mind.scopes.`);
+  }
+  return scope;
+}
+function resolveEngineConfig(config, scope) {
+  const engineId = scope.defaultEngine ?? config.defaults?.fallbackEngineId ?? config.engines[0]?.id;
+  if (!engineId) {
+    throw new Error("No engines configured in mind config.");
+  }
+  const engine = config.engines.find((item) => item.id === engineId);
+  if (!engine) {
+    throw new Error(`Engine "${engineId}" referenced by scope "${scope.id}" does not exist.`);
+  }
+  return engine;
+}
+async function resolveConfig(cwd, provided) {
+  if (provided) {
+    return normalizeConfig(provided);
+  }
+  const configPath = await findConfigPath(cwd);
+  const raw = JSON.parse(await readFile(configPath, "utf8"));
+  return normalizeConfig(raw);
+}
+async function findConfigPath(cwd) {
+  const candidates = [
+    path.resolve(cwd, ".kb/kb.config.json"),
+    path.resolve(cwd, "kb.config.json")
+  ];
+  for (const candidate of candidates) {
+    try {
+      await readFile(candidate, "utf8");
+      return candidate;
+    } catch {
+    }
+  }
+  throw new Error("No kb.config.json found. Expected .kb/kb.config.json or kb.config.json.");
+}
+function normalizeConfig(raw) {
+  const data = raw;
+  if (Array.isArray(data.profiles) && data.profiles.length > 0) {
+    const profile = data.profiles.find((p) => p.id === "default") ?? data.profiles[0];
+    const products = profile?.products;
+    const mindConfig = products?.[MIND_PRODUCT_ID];
+    if (!mindConfig) {
+      throw new Error("Config does not contain profiles[].products.mind section.");
+    }
+    return validateConfig(mindConfig);
+  }
+  if (data.mind && typeof data.mind === "object") {
+    return validateConfig(data.mind);
+  }
+  return validateConfig(data);
+}
+function validateConfig(config) {
+  if (!Array.isArray(config.sources) || !Array.isArray(config.scopes) || !Array.isArray(config.engines)) {
+    throw new Error("Invalid mind config: required arrays sources/scopes/engines are missing.");
+  }
+  return config;
+}
+function getAdapterName(service, fallback) {
+  if (!service) {
+    return fallback;
+  }
+  const name = service.constructor?.name || service.name || service.id;
+  if (name && name !== "Object" && name !== "Function") {
+    return name;
+  }
+  return fallback;
+}
+async function runRagIndex(options) {
+  const platform = options.platform ?? usePlatform();
+  const adapters = {
+    vectorStore: getAdapterName(platform?.vectorStore, "LocalVectorStore (fallback)"),
+    embeddings: getAdapterName(platform?.embeddings, "DeterministicEmbeddings (fallback)"),
+    storage: getAdapterName(platform?.storage, "MemoryStorage (fallback)"),
+    llm: getAdapterName(platform?.llm, "LocalStubLLM (fallback)"),
+    cache: getAdapterName(platform?.cache, "MemoryCache (fallback)")
+  };
+  let effectiveConfig = options.config;
+  if (options.include || options.exclude) {
+    let mindConfig = effectiveConfig;
+    if (mindConfig?.sources && Array.isArray(mindConfig.sources)) {
+      mindConfig = { ...mindConfig };
+      mindConfig.sources = mindConfig.sources.map((source) => {
+        const overriddenSource = { ...source };
+        if (options.include) {
+          overriddenSource.paths = [options.include];
+        }
+        if (options.exclude) {
+          overriddenSource.exclude = options.exclude.split(",").map((s) => s.trim());
+        }
+        return overriddenSource;
+      });
+      effectiveConfig = mindConfig;
+    }
+  }
+  const runtime = await createMindRuntime({
+    cwd: options.cwd,
+    config: effectiveConfig,
+    runtime: "runtime" in options ? options.runtime : void 0,
+    platform: options.platform
+  });
+  const allScopeIds = runtime.config.scopes?.map((scope) => scope.id) ?? [];
+  if (!allScopeIds.length) {
+    throw new Error("No mind scopes found. Update kb.config.json first.");
+  }
+  const scopeIds = options.scopeId ? allScopeIds.filter((scopeId) => scopeId === options.scopeId) : allScopeIds;
+  if (!scopeIds.length) {
+    throw new Error(
+      `Scope "${options.scopeId}" is not defined in mind.scopes.`
+    );
+  }
+  const originalSkipDedup = process.env.KB_SKIP_DEDUPLICATION;
+  if (options.skipDeduplication) {
+    process.env.KB_SKIP_DEDUPLICATION = "true";
+  }
+  const aggregatedStats = {
+    filesDiscovered: 0,
+    filesProcessed: 0,
+    filesSkipped: 0,
+    chunksStored: 0,
+    chunksUpdated: 0,
+    chunksSkipped: 0,
+    errorCount: 0,
+    durationMs: 0,
+    deletedFiles: 0,
+    deletedChunks: 0,
+    invalidChunks: 0
+  };
+  try {
+    for (const scopeId of scopeIds) {
+      const scopeStats = await runtime.service.index(scopeId);
+      if (scopeStats) {
+        aggregatedStats.filesDiscovered += scopeStats.filesDiscovered;
+        aggregatedStats.filesProcessed += scopeStats.filesProcessed;
+        aggregatedStats.filesSkipped += scopeStats.filesSkipped;
+        aggregatedStats.chunksStored += scopeStats.chunksStored;
+        aggregatedStats.chunksUpdated += scopeStats.chunksUpdated;
+        aggregatedStats.chunksSkipped += scopeStats.chunksSkipped;
+        aggregatedStats.errorCount += scopeStats.errorCount;
+        aggregatedStats.durationMs += scopeStats.durationMs;
+        aggregatedStats.deletedFiles = (aggregatedStats.deletedFiles ?? 0) + (scopeStats.deletedFiles ?? 0);
+        aggregatedStats.deletedChunks = (aggregatedStats.deletedChunks ?? 0) + (scopeStats.deletedChunks ?? 0);
+        aggregatedStats.invalidChunks = (aggregatedStats.invalidChunks ?? 0) + (scopeStats.invalidChunks ?? 0);
+      }
+    }
+  } finally {
+    if (originalSkipDedup === void 0) {
+      delete process.env.KB_SKIP_DEDUPLICATION;
+    } else {
+      process.env.KB_SKIP_DEDUPLICATION = originalSkipDedup;
+    }
+  }
+  return { scopeIds, adapters, stats: aggregatedStats };
+}
+
+// src/cli/commands/rag-index.ts
+var rag_index_default = defineCommand({
+  id: "mind:rag-index",
+  description: "Build Mind indexes",
+  handler: {
+    async execute(ctx, input) {
+      const startTime = Date.now();
+      const { flags } = input;
+      const mindConfig = await useConfig();
+      const cwd = flags.cwd || ctx.cwd;
+      const scopeId = flags.scope;
+      const include = flags.include;
+      const exclude = flags.exclude;
+      const skipDeduplication = flags.skipDeduplication;
+      const platform = usePlatform();
+      const loader = !flags.quiet && !flags.json ? useLoader("Building Mind RAG index...") : null;
+      loader?.start();
+      try {
+        const result = await runRagIndex({
+          cwd,
+          scopeId,
+          include,
+          exclude,
+          skipDeduplication,
+          config: mindConfig,
+          platform
+        });
+        const timing = Date.now() - startTime;
+        loader?.succeed(`Index built in ${(timing / 1e3).toFixed(1)}s`);
+        platform?.analytics?.track?.("mind.rag-index", {
+          scopeIds: result.scopeIds,
+          stats: result.stats
+        }).catch(() => {
+        });
+        if (flags.json) {
+          ctx.ui.json({
+            ok: true,
+            scopes: result.scopeIds,
+            stats: result.stats,
+            adapters: result.adapters,
+            timingMs: timing
+          });
+        } else if (!flags.quiet) {
+          const { stats } = result;
+          const percentage = stats.filesDiscovered > 0 ? (stats.filesProcessed / stats.filesDiscovered * 100).toFixed(1) : "0.0";
+          const chunksPerFile = stats.filesProcessed > 0 ? (stats.chunksStored / stats.filesProcessed).toFixed(2) : "0.00";
+          ctx.ui.success(
+            `Indexed ${stats.filesProcessed} files, ${stats.filesSkipped} skipped, ${stats.chunksStored} chunks, deleted ${stats.deletedFiles ?? 0} files/${stats.deletedChunks ?? 0} chunks`,
+            {
+              title: "Mind RAG Index",
+              sections: [
+                {
+                  header: "Files",
+                  items: [
+                    `Discovered: ${stats.filesDiscovered}`,
+                    `Processed:  ${stats.filesProcessed} (${percentage}%)`,
+                    `Skipped:    ${stats.filesSkipped}`
+                  ]
+                },
+                {
+                  header: "Chunks",
+                  items: [
+                    `Stored: ${stats.chunksStored}`,
+                    `Updated: ${stats.chunksUpdated}`,
+                    `Skipped: ${stats.chunksSkipped}`,
+                    `Rate:   ${chunksPerFile}/file`
+                  ]
+                },
+                {
+                  header: "Cleanup",
+                  items: [
+                    `Deleted files:  ${stats.deletedFiles ?? 0}`,
+                    `Deleted chunks: ${stats.deletedChunks ?? 0}`,
+                    `Invalid chunks: ${stats.invalidChunks ?? 0}`
+                  ]
+                },
+                {
+                  header: "Health",
+                  items: [
+                    `Errors: ${stats.errorCount}`
+                  ]
+                }
+              ],
+              timing
+            }
+          );
+        }
+        return {
+          exitCode: 0,
+          ok: true,
+          scopes: result.scopeIds,
+          adapters: result.adapters
+        };
+      } catch (error) {
+        const timing = Date.now() - startTime;
+        const message = error instanceof Error ? error.message : String(error);
+        loader?.fail(`Index build failed: ${message}`);
+        if (flags.json) {
+          ctx.ui.info(JSON.stringify({
+            ok: false,
+            error: message,
+            timingMs: timing
+          }));
+        } else if (!flags.quiet) {
+          ctx.ui.error(`Index build failed: ${message}`);
+        }
+        platform?.analytics?.track?.("mind.rag-index", {
+          error: true,
+          errorMessage: message,
+          timingMs: timing
+        }).catch(() => {
+        });
+        return { exitCode: 1, ok: false };
+      }
+    }
+  }
+});
+
+export { rag_index_default as default };
+//# sourceMappingURL=rag-index.js.map
+//# sourceMappingURL=rag-index.js.map

package/dist/cli/commands/rag-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/mind-runtime.ts","../../../src/features/rag/service.ts","../../../src/cli/commands/rag-index.ts"],"names":["usePlatform"],"mappings":"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","file":"rag-index.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { usePlatform, type PlatformServices } from '@kb-labs/sdk';\nimport { MindEngine } from '@kb-labs/mind-engine';\nimport type {\n  MindConfigInput,\n  MindEngineConfig,\n  MindScopeConfig,\n  MindSourceConfig,\n} from '@kb-labs/mind-contracts';\nimport type {\n  MindIndexStats,\n  MindIntent,\n  MindQueryResult,\n} from '@kb-labs/mind-types';\n\nexport const MIND_PRODUCT_ID = 'mind';\n\nexport interface MindRuntimeService {\n  index(scopeId: string): Promise<MindIndexStats>;\n  query(options: {\n    productId?: string;\n    scopeId: string;\n    text: string;\n    intent?: MindIntent;\n    limit?: number;\n    profileId?: string;\n    metadata?: Record<string, unknown>;\n  }): Promise<MindQueryResult>;\n}\n\nexport interface MindRuntime {\n  service: MindRuntimeService;\n  config: MindConfigInput;\n}\n\nexport interface MindRuntimeOptions {\n  cwd: string;\n  config?: MindConfigInput | Record<string, unknown>;\n  runtime?: {\n    fetch?: typeof fetch;\n    fs?: unknown;\n    env?: (key: string) => string | undefined;\n    log?: (\n      level: 'debug' | 'info' | 'warn' | 'error',\n      msg: string,\n      meta?: Record<string, unknown>,\n    ) => void;\n    analytics?: {\n      track(event: string, properties?: Record<string, unknown>): void;\n      metric(name: string, value: number, tags?: Record<string, string>): void;\n    };\n  };\n  platform?: PlatformServices;\n  onProgress?: (event: { stage: string; details?: string; metadata?: Record<string, unknown>; timestamp: number }) => void;\n}\n\nexport async function createMindRuntime(options: MindRuntimeOptions): Promise<MindRuntime> {\n  const config = await resolveConfig(options.cwd, options.config);\n  const platform = options.platform ?? usePlatform();\n\n  const service: MindRuntimeService = {\n    index: async (scopeId: string) => {\n      const scope = resolveScope(config, scopeId);\n      const engine = createEngine(config, scope, options.cwd, options.runtime, platform, options.onProgress);\n      await engine.init();\n      const stats = await engine.index(resolveSources(config, scope), {\n        scope,\n        workspaceRoot: options.cwd,\n      } as any);\n      return stats as unknown as MindIndexStats;\n    },\n    query: async (queryOptions) => {\n      if (queryOptions.productId && queryOptions.productId !== MIND_PRODUCT_ID) {\n        throw new Error(`Unsupported productId \"${queryOptions.productId}\". Expected \"${MIND_PRODUCT_ID}\".`);\n      }\n      const scope = resolveScope(config, queryOptions.scopeId);\n      const sources = resolveSources(config, scope);\n      const engine = createEngine(config, scope, options.cwd, options.runtime, platform, options.onProgress);\n      await engine.init();\n\n      const result = await engine.query(\n        {\n          text: queryOptions.text,\n          intent: queryOptions.intent ?? 'summary',\n          limit: queryOptions.limit,\n          profileId: queryOptions.profileId,\n          metadata: queryOptions.metadata,\n        } as any,\n        {\n          scope,\n          sources,\n          workspaceRoot: options.cwd,\n          limit: queryOptions.limit,\n          profile: queryOptions.profileId ? { id: queryOptions.profileId } : undefined,\n        } as any,\n      );\n\n      return result as unknown as MindQueryResult;\n    },\n  };\n\n  return {\n    service,\n    config,\n  };\n}\n\nfunction createEngine(\n  config: MindConfigInput,\n  scope: MindScopeConfig,\n  cwd: string,\n  runtime: MindRuntimeOptions['runtime'],\n  platform: PlatformServices | null | undefined,\n  onProgress: MindRuntimeOptions['onProgress'],\n): any {\n  const engineConfig = resolveEngineConfig(config, scope);\n  return new MindEngine(\n    {\n      id: engineConfig.id,\n      type: engineConfig.type,\n      options: {\n        ...(engineConfig.options ?? {}),\n        _runtime: runtime,\n        platform: platform ?? undefined,\n        onProgress,\n      },\n    } as any,\n    {\n      workspaceRoot: cwd,\n    } as any,\n  );\n}\n\nfunction resolveSources(config: MindConfigInput, scope: MindScopeConfig): MindSourceConfig[] {\n  if (!scope.sourceIds?.length) {\n    return config.sources;\n  }\n  const selected = config.sources.filter((source: MindSourceConfig) => scope.sourceIds!.includes(source.id));\n  if (!selected.length) {\n    throw new Error(`Scope \"${scope.id}\" does not reference existing sources.`);\n  }\n  return selected;\n}\n\nfunction resolveScope(config: MindConfigInput, scopeId: string): MindScopeConfig {\n  const scope = config.scopes.find((item: MindScopeConfig) => item.id === scopeId);\n  if (!scope) {\n    throw new Error(`Scope \"${scopeId}\" is not defined in mind.scopes.`);\n  }\n  return scope;\n}\n\nfunction resolveEngineConfig(config: MindConfigInput, scope: MindScopeConfig): MindEngineConfig {\n  const engineId = scope.defaultEngine ?? config.defaults?.fallbackEngineId ?? config.engines[0]?.id;\n  if (!engineId) {\n    throw new Error('No engines configured in mind config.');\n  }\n  const engine = config.engines.find((item: MindEngineConfig) => item.id === engineId);\n  if (!engine) {\n    throw new Error(`Engine \"${engineId}\" referenced by scope \"${scope.id}\" does not exist.`);\n  }\n  return engine;\n}\n\nasync function resolveConfig(cwd: string, provided?: MindRuntimeOptions['config']): Promise<MindConfigInput> {\n  if (provided) {\n    return normalizeConfig(provided);\n  }\n  const configPath = await findConfigPath(cwd);\n  const raw = JSON.parse(await readFile(configPath, 'utf8')) as Record<string, unknown>;\n  return normalizeConfig(raw);\n}\n\nasync function findConfigPath(cwd: string): Promise<string> {\n  const candidates = [\n    path.resolve(cwd, '.kb/kb.config.json'),\n    path.resolve(cwd, 'kb.config.json'),\n  ];\n\n  for (const candidate of candidates) {\n    try {\n      await readFile(candidate, 'utf8');\n      return candidate;\n    } catch {\n      // continue\n    }\n  }\n\n  throw new Error('No kb.config.json found. Expected .kb/kb.config.json or kb.config.json.');\n}\n\nfunction normalizeConfig(raw: MindRuntimeOptions['config']): MindConfigInput {\n  const data = raw as Record<string, unknown>;\n\n  // Canonical format: profiles[].products.mind\n  if (Array.isArray(data.profiles) && data.profiles.length > 0) {\n    const profile = (data.profiles as Array<Record<string, unknown>>).find((p) => p.id === 'default')\n      ?? (data.profiles as Array<Record<string, unknown>>)[0];\n    const products = profile?.products as Record<string, unknown> | undefined;\n    const mindConfig = products?.[MIND_PRODUCT_ID] as MindConfigInput | undefined;\n    if (!mindConfig) {\n      throw new Error('Config does not contain profiles[].products.mind section.');\n    }\n    return validateConfig(mindConfig);\n  }\n\n  // Optional root-level format: { mind: {...} }\n  if (data.mind && typeof data.mind === 'object') {\n    return validateConfig(data.mind as MindConfigInput);\n  }\n\n  return validateConfig(data as unknown as MindConfigInput);\n}\n\nfunction validateConfig(config: MindConfigInput): MindConfigInput {\n  if (!Array.isArray(config.sources) || !Array.isArray(config.scopes) || !Array.isArray(config.engines)) {\n    throw new Error('Invalid mind config: required arrays sources/scopes/engines are missing.');\n  }\n  return config;\n}\n","import {\n  usePlatform,\n  useLLM,\n  type PlatformServices,\n} from '@kb-labs/sdk';\nimport type {\n  MindIntent,\n  MindQueryResult,\n  MindIndexStats,\n} from '@kb-labs/mind-types';\nimport { createHash } from 'node:crypto';\nimport * as path from 'node:path';\nimport {\n  MIND_PRODUCT_ID,\n  createMindRuntime,\n} from '../../runtime/mind-runtime';\nimport { loadManifest } from '@kb-labs/mind-engine';\nimport type {\n  AgentQueryOrchestrator} from '@kb-labs/mind-orchestrator';\nimport {\n  createAgentQueryOrchestrator\n} from '@kb-labs/mind-orchestrator';\n\ntype AgentQueryMode = 'instant' | 'auto' | 'thinking';\ntype AgentResponse = Record<string, unknown>;\ntype AgentErrorResponse = {\n  error: { code: string; message: string; recoverable: boolean };\n  meta: Record<string, unknown>;\n};\n\n/**\n * Global orchestrator instance for cache persistence across queries\n */\nlet globalOrchestrator: InstanceType<typeof AgentQueryOrchestrator> | null = null;\n\nexport interface RagIndexOptions {\n  cwd: string;\n  scopeId?: string;\n  include?: string;\n  exclude?: string;\n  skipDeduplication?: boolean;\n  platform?: PlatformServices;\n  /**\n   * Mind configuration (from ctx.config)\n   * If provided, will be used instead of reading from file\n   */\n  config?: any;\n}\n\n/**\n * Information about which adapters were used during indexing\n */\nexport interface AdapterInfo {\n  vectorStore: string;\n  embeddings: string;\n  storage: string;\n  llm: string;\n  cache: string;\n}\n\nexport interface RagIndexStats extends MindIndexStats {\n  deletedFiles?: number;\n  deletedChunks?: number;\n  invalidChunks?: number;\n}\n\nexport interface RagIndexResult {\n  scopeIds: string[];\n  adapters: AdapterInfo;\n  stats: RagIndexStats;\n}\n\nexport interface RagIndexOptionsWithRuntime extends RagIndexOptions {\n  runtime?: Parameters<typeof createMindRuntime>[0]['runtime'];\n}\n\n/**\n * Get adapter name from platform service or fallback\n */\nfunction getAdapterName(service: any, fallback: string): string {\n  if (!service) {return fallback;}\n  // Try to get constructor name or class name\n  const name = service.constructor?.name || service.name || service.id;\n  if (name && name !== 'Object' && name !== 'Function') {\n    return name;\n  }\n  return fallback;\n}\n\nexport async function runRagIndex(\n  options: RagIndexOptions | RagIndexOptionsWithRuntime,\n): Promise<RagIndexResult> {\n  // Use SDK's usePlatform() to get global platform singleton\n  const platform = options.platform ?? usePlatform();\n\n  // Collect adapter info - shows actual adapters being used\n  const adapters: AdapterInfo = {\n    vectorStore: getAdapterName(platform?.vectorStore, 'LocalVectorStore (fallback)'),\n    embeddings: getAdapterName(platform?.embeddings, 'DeterministicEmbeddings (fallback)'),\n    storage: getAdapterName(platform?.storage, 'MemoryStorage (fallback)'),\n    llm: getAdapterName(platform?.llm, 'LocalStubLLM (fallback)'),\n    cache: getAdapterName(platform?.cache, 'MemoryCache (fallback)'),\n  };\n\n  // If include/exclude provided, override paths in all sources (ESLint-style)\n  let effectiveConfig = options.config;\n  if (options.include || options.exclude) {\n    // If config already provided (from useConfig), clone and modify it\n    // If not provided, will be loaded by createMindRuntime\n    let mindConfig = effectiveConfig;\n\n    // Override paths/exclude in ALL sources (ESLint-style override)\n    if (mindConfig?.sources && Array.isArray(mindConfig.sources)) {\n      mindConfig = { ...mindConfig };\n      mindConfig.sources = mindConfig.sources.map((source: any) => {\n        const overriddenSource = { ...source };\n\n        // --include overrides paths\n        if (options.include) {\n          overriddenSource.paths = [options.include];\n        }\n\n        // --exclude overrides exclude\n        if (options.exclude) {\n          overriddenSource.exclude = options.exclude.split(',').map(s => s.trim());\n        }\n\n        return overriddenSource;\n      });\n      effectiveConfig = mindConfig;\n    }\n  }\n\n  const runtime = await createMindRuntime({\n    cwd: options.cwd,\n    config: effectiveConfig,\n    runtime: 'runtime' in options ? options.runtime : undefined,\n    platform: options.platform,\n  });\n  const allScopeIds = runtime.config.scopes?.map((scope: any) => scope.id) ?? [];\n  if (!allScopeIds.length) {\n    throw new Error('No mind scopes found. Update kb.config.json first.');\n  }\n\n  const scopeIds = options.scopeId\n    ? allScopeIds.filter((scopeId: string) => scopeId === options.scopeId)\n    : allScopeIds;\n\n  if (!scopeIds.length) {\n    throw new Error(\n      `Scope \"${options.scopeId}\" is not defined in mind.scopes.`,\n    );\n  }\n\n  // Set skip deduplication env var if requested\n  const originalSkipDedup = process.env.KB_SKIP_DEDUPLICATION;\n  if (options.skipDeduplication) {\n    process.env.KB_SKIP_DEDUPLICATION = 'true';\n  }\n\n  // Aggregate stats across all scopes\n  const aggregatedStats = {\n    filesDiscovered: 0,\n    filesProcessed: 0,\n    filesSkipped: 0,\n    chunksStored: 0,\n    chunksUpdated: 0,\n    chunksSkipped: 0,\n    errorCount: 0,\n    durationMs: 0,\n    deletedFiles: 0,\n    deletedChunks: 0,\n    invalidChunks: 0,\n  } satisfies RagIndexStats;\n\n  try {\n    for (const scopeId of scopeIds) {\n      const scopeStats = await runtime.service.index(scopeId) as RagIndexStats;\n      if (scopeStats) {\n        aggregatedStats.filesDiscovered += scopeStats.filesDiscovered;\n        aggregatedStats.filesProcessed += scopeStats.filesProcessed;\n        aggregatedStats.filesSkipped += scopeStats.filesSkipped;\n        aggregatedStats.chunksStored += scopeStats.chunksStored;\n        aggregatedStats.chunksUpdated += scopeStats.chunksUpdated;\n        aggregatedStats.chunksSkipped += scopeStats.chunksSkipped;\n        aggregatedStats.errorCount += scopeStats.errorCount;\n        aggregatedStats.durationMs += scopeStats.durationMs;\n        aggregatedStats.deletedFiles = (aggregatedStats.deletedFiles ?? 0) + (scopeStats.deletedFiles ?? 0);\n        aggregatedStats.deletedChunks = (aggregatedStats.deletedChunks ?? 0) + (scopeStats.deletedChunks ?? 0);\n        aggregatedStats.invalidChunks = (aggregatedStats.invalidChunks ?? 0) + (scopeStats.invalidChunks ?? 0);\n      }\n    }\n  } finally {\n    // Restore original env var value\n    if (originalSkipDedup === undefined) {\n      delete process.env.KB_SKIP_DEDUPLICATION;\n    } else {\n      process.env.KB_SKIP_DEDUPLICATION = originalSkipDedup;\n    }\n  }\n\n  // Invalidate query cache after re-indexing\n  // This ensures fresh results after index update\n  if (globalOrchestrator) {\n    await globalOrchestrator.invalidateCache(scopeIds);\n  }\n\n  return { scopeIds, adapters, stats: aggregatedStats };\n}\n\nexport interface RagQueryOptions {\n  cwd: string;\n  scopeId?: string;\n  text: string;\n  intent?: MindIntent;\n  limit?: number;\n  profileId?: string;\n  runtime?: Parameters<typeof createMindRuntime>[0]['runtime'];\n  onProgress?: (stage: string, details?: string) => void;\n  platform?: PlatformServices;\n  /**\n   * Mind configuration (from ctx.config)\n   * If provided, will be used instead of reading from file\n   */\n  config?: any;\n}\n\nexport interface RagQueryResult {\n  scopeId: string;\n  result: MindQueryResult;\n}\n\nexport async function runRagQuery(\n  options: RagQueryOptions,\n): Promise<RagQueryResult> {\n  // Convert onProgress from (stage, details) to ProgressEvent format\n  const onProgressEvent = options.onProgress\n    ? (event: { stage: string; details?: string; metadata?: Record<string, unknown>; timestamp: number }) => {\n        try {\n          // Map engine stage names to human-readable messages\n          const stageMap: Record<string, string> = {\n            'using_reasoning_engine': 'Using reasoning engine',\n            'reasoning_completed': 'Reasoning completed',\n            'analyzing_query_complexity': 'Analyzing query complexity',\n            'query_is_simple': 'Query is simple',\n            'planning_query': 'Planning query',\n            'query_plan_generated': 'Query plan generated',\n            'executing_subqueries': 'Executing subqueries',\n            'subqueries_completed': 'Subqueries completed',\n            'synthesizing_context': 'Synthesizing context',\n            'context_synthesis_completed': 'Context synthesis completed',\n            'generating_embedding': 'Generating embeddings',\n            'performing_hybrid_search': 'Performing hybrid search',\n            'searching_vector_store': 'Searching vector store',\n            'search_completed': 'Search completed',\n            'applying_popularity_boost': 'Applying popularity boost',\n            'applying_query_pattern_boost': 'Applying query pattern boost',\n            're_ranking_results': 'Re-ranking results',\n            're_ranking_completed': 'Re-ranking completed',\n            'compression_applied': 'Compression applied',\n            'saving_query_history': 'Saving query history',\n          };\n          \n          const humanReadableStage = stageMap[event.stage] || event.stage;\n\n          // Extract interesting details from metadata\n          let enhancedDetails = event.details;\n          if (event.metadata) {\n            // Show subqueries if available\n            if (event.metadata.subqueries && Array.isArray(event.metadata.subqueries)) {\n              const subqueryList = event.metadata.subqueries.slice(0, 3).join(', ');\n              const count = event.metadata.subqueries.length;\n              enhancedDetails = `${count} subqueries: ${subqueryList}${count > 3 ? '...' : ''}`;\n            }\n            // Show result count if available\n            else if (typeof event.metadata.resultCount === 'number') {\n              enhancedDetails = `${event.metadata.resultCount} results`;\n            }\n            // Show chunk count if available\n            else if (typeof event.metadata.chunkCount === 'number') {\n              enhancedDetails = `${event.metadata.chunkCount} chunks`;\n            }\n          }\n\n          if (options.onProgress) {\n            options.onProgress(humanReadableStage, enhancedDetails);\n          }\n        } catch (error) {\n          // Don't break query if progress callback fails\n          // Error is silently ignored\n        }\n      }\n    : undefined;\n\n  // Wrap runtime to suppress INFO logs but allow WARN/ERROR\n  const originalRuntime = options.runtime;\n  \n  const wrappedRuntime = originalRuntime ? {\n    ...originalRuntime,\n    log: (level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: any) => {\n      // Suppress INFO and DEBUG logs - progress comes from explicit API now\n      if (level === 'info' || level === 'debug') {\n        return; // Don't output INFO/DEBUG logs\n      }\n      \n      // Call original logger for warnings and errors only\n      if (originalRuntime.log && (level === 'warn' || level === 'error')) {\n        originalRuntime.log(level, message, meta);\n      }\n    },\n  } : undefined;\n\n  const runtime = await createMindRuntime({\n    cwd: options.cwd,\n    config: options.config,\n    runtime: wrappedRuntime,\n    onProgress: onProgressEvent,\n    platform: options.platform,\n  });\n  \n  options.onProgress?.('Initializing Mind runtime');\n\n  const defaultScopeId = runtime.config.scopes?.[0]?.id;\n  const scopeId = options.scopeId ?? defaultScopeId;\n  if (!scopeId) {\n    throw new Error(\n      'No mind scopes configured. Provide at least one scope in kb.config.json.',\n    );\n  }\n\n  options.onProgress?.('Preparing query', `scope: ${scopeId}`);\n\n  options.onProgress?.('Searching Mind index');\n\n  const result = await runtime.service.query({\n    productId: MIND_PRODUCT_ID,\n    intent: options.intent ?? 'summary',\n    scopeId,\n    text: options.text,\n    limit: options.limit,\n    profileId: options.profileId,\n  });\n\n  options.onProgress?.('Processing results', `${result.chunks.length} chunks found`);\n\n  return {\n    scopeId,\n    result,\n  };\n}\n\n// === Agent-optimized RAG Query ===\n\nexport interface AgentRagQueryOptions {\n  cwd: string;\n  scopeId?: string;\n  text: string;\n  mode?: AgentQueryMode;\n  indexRevision?: string;\n  engineConfigHash?: string;\n  sourcesDigest?: string;\n  debug?: boolean;\n  runtime?: Parameters<typeof createMindRuntime>[0]['runtime'];\n  broker?: any; // StateBroker-like interface (duck typing to avoid circular deps)\n  platform?: PlatformServices;\n  /**\n   * Mind configuration (from ctx.config)\n   * If provided, will be used instead of reading from file\n   */\n  config?: any;\n}\n\nexport type AgentRagQueryResult = AgentResponse | AgentErrorResponse;\n\ninterface CacheContext {\n  indexRevision?: string;\n  engineConfigHash?: string;\n  sourcesDigest?: string;\n}\n\ninterface ManifestCacheContext {\n  found: boolean;\n  indexRevision?: string;\n  engineConfigHash?: string;\n  sourcesDigest?: string;\n}\n\n/**\n * Run agent-optimized RAG query with orchestration.\n *\n * This function uses the orchestrator pipeline:\n * 1. Detect query complexity\n * 2. Decompose into sub-queries (auto/thinking modes)\n * 3. Gather chunks from mind-engine\n * 4. Check completeness (with retry in thinking mode)\n * 5. Synthesize agent-friendly response\n * 6. Compress if needed\n *\n * @returns AgentResponse | AgentErrorResponse - clean JSON for agents\n */\nexport async function runAgentRagQuery(\n  options: AgentRagQueryOptions,\n): Promise<AgentRagQueryResult> {\n  const platformBroker = options.platform?.cache\n    ? {\n        get: <T>(key: string) => options.platform!.cache!.get<T>(key),\n        set: <T>(key: string, value: T, ttl?: number) => options.platform!.cache!.set(key, value, ttl),\n        delete: (key: string) => options.platform!.cache!.delete(key),\n      }\n    : undefined;\n\n  const ragLlm = useLLM({\n    execution: {\n      cache: {\n        mode: 'prefer',\n        scope: 'segments',\n      },\n      stream: {\n        mode: 'prefer',\n        fallbackToComplete: true,\n      },\n    },\n  });\n\n  // Always recreate orchestrator to use fresh LLM from useLLM()\n  // This ensures analytics wrappers are always applied\n  globalOrchestrator = createAgentQueryOrchestrator({\n    llm: ragLlm, // Fresh LLM with analytics wrapper + cache/stream policy\n    broker: options.broker ?? platformBroker, // Pass broker for persistent caching\n    analyticsAdapter: options.platform?.analytics ?? null,\n    config: {\n      mode: options.mode ?? 'auto',\n      autoDetectComplexity: true,\n    },\n  });\n\n  const orchestrator = globalOrchestrator;\n\n  // Create runtime\n  const runtime = await createMindRuntime({\n    cwd: options.cwd,\n    config: options.config,\n    runtime: options.runtime,\n    platform: options.platform,\n  });\n\n  // Get scope ID\n  const defaultScopeId = runtime.config.scopes?.[0]?.id;\n  const scopeId = options.scopeId ?? defaultScopeId;\n\n  if (!scopeId) {\n    return {\n      error: {\n        code: 'KNOWLEDGE_SCOPE_NOT_FOUND',\n        message: 'No mind scopes configured. Provide at least one scope in kb.config.json.',\n        recoverable: false,\n      },\n      meta: {\n        schemaVersion: 'agent-response-v1',\n        requestId: `rq-${Date.now()}`,\n        mode: options.mode ?? 'auto',\n        timingMs: 0,\n        cached: false,\n      },\n    };\n  }\n\n  const cacheContext = await resolveCacheContext({\n    cwd: options.cwd,\n    scopeId,\n    config: runtime.config,\n    providedIndexRevision: options.indexRevision,\n    providedEngineConfigHash: options.engineConfigHash,\n    providedSourcesDigest: options.sourcesDigest,\n  });\n\n  // Create query function for orchestrator with adaptive weights support\n  const queryFn = async (queryOptions: {\n    text: string;\n    intent?: MindIntent;\n    limit?: number;\n    vectorWeight?: number;\n    keywordWeight?: number;\n  }) => {\n    const result = await runtime.service.query({\n      productId: MIND_PRODUCT_ID,\n      intent: queryOptions.intent ?? 'search',\n      scopeId,\n      text: queryOptions.text,\n      limit: queryOptions.limit,\n      // Pass adaptive weights via metadata for mind-engine to use\n      metadata: {\n        agentMode: true,\n        consumer: 'agent',\n        mode: options.mode ?? 'auto',\n        ...(queryOptions.vectorWeight !== undefined && queryOptions.keywordWeight !== undefined\n          ? {\n              vectorWeight: queryOptions.vectorWeight,\n              keywordWeight: queryOptions.keywordWeight,\n            }\n          : {}),\n      },\n    });\n\n    return {\n      chunks: result.chunks,\n      metadata: result.metadata ?? {},\n    };\n  };\n\n  // Execute orchestrated query\n  return orchestrator.query(\n    {\n      cwd: options.cwd,\n      scopeId,\n      text: options.text,\n      mode: options.mode,\n      indexRevision: cacheContext.indexRevision,\n      engineConfigHash: cacheContext.engineConfigHash,\n      sourcesDigest: cacheContext.sourcesDigest,\n      debug: options.debug,\n    },\n    queryFn,\n  );\n}\n\nasync function resolveCacheContext(options: {\n  cwd: string;\n  scopeId: string;\n  config: any;\n  providedIndexRevision?: string;\n  providedEngineConfigHash?: string;\n  providedSourcesDigest?: string;\n}): Promise<CacheContext> {\n  const manifestContext = await readCacheContextFromManifest(options.cwd, options.config, options.scopeId);\n\n  const indexRevision = options.providedIndexRevision\n    ?? manifestContext.indexRevision;\n  const engineConfigHash = options.providedEngineConfigHash\n    ?? manifestContext.engineConfigHash\n    ?? computeEngineConfigHash(options.config, options.scopeId);\n  const sourcesDigest = options.providedSourcesDigest\n    ?? manifestContext.sourcesDigest;\n\n  return {\n    indexRevision,\n    engineConfigHash,\n    sourcesDigest,\n  };\n}\n\nfunction computeEngineConfigHash(config: any, scopeId: string): string | undefined {\n  const scope = Array.isArray(config?.scopes)\n    ? config.scopes.find((item: any) => item?.id === scopeId)\n    : undefined;\n  const engineId = scope?.defaultEngine\n    ?? config?.defaults?.fallbackEngineId\n    ?? config?.engines?.[0]?.id;\n  const engine = Array.isArray(config?.engines)\n    ? config.engines.find((item: any) => item?.id === engineId)\n    : undefined;\n\n  if (!engine) {\n    return undefined;\n  }\n\n  const sanitized = {\n    id: engine.id,\n    type: engine.type,\n    options: sanitizeEngineOptionsForHash(engine.options ?? {}),\n  };\n\n  return createHash('sha256').update(stableStringify(sanitized)).digest('hex');\n}\n\nasync function readCacheContextFromManifest(\n  cwd: string,\n  config: any,\n  scopeId: string,\n): Promise<ManifestCacheContext> {\n  const scope = Array.isArray(config?.scopes)\n    ? config.scopes.find((item: any) => item?.id === scopeId)\n    : undefined;\n  const engineId = scope?.defaultEngine\n    ?? config?.defaults?.fallbackEngineId\n    ?? config?.engines?.[0]?.id;\n  const engine = Array.isArray(config?.engines)\n    ? config.engines.find((item: any) => item?.id === engineId)\n    : undefined;\n  const configuredIndexDir = typeof engine?.options?.indexDir === 'string'\n    ? engine.options.indexDir\n    : '.kb/mind/rag';\n\n  const candidatePaths = [\n    path.resolve(cwd, configuredIndexDir, scopeId, 'manifest.json'),\n    path.resolve(cwd, configuredIndexDir, 'manifest.json'),\n    path.resolve(cwd, '.kb/mind/indexes', scopeId, 'manifest.json'),\n    path.resolve(cwd, '.kb/mind/rag', scopeId, 'manifest.json'),\n  ];\n\n  for (const manifestPath of candidatePaths) {\n    try {\n      const manifest = await loadManifest(manifestPath);\n      const indexRevision = (manifest as { indexRevision?: unknown }).indexRevision;\n      const engineConfigHash = (manifest as { engineConfigHash?: unknown }).engineConfigHash;\n      const sourcesDigest = (manifest as { sourcesDigest?: unknown }).sourcesDigest;\n\n      if (typeof indexRevision !== 'string' || indexRevision.length === 0) {\n        throw new Error('missing indexRevision');\n      }\n\n      if (typeof engineConfigHash !== 'string' || engineConfigHash.length === 0) {\n        throw new Error('missing engineConfigHash');\n      }\n      if (typeof sourcesDigest !== 'string' || sourcesDigest.length === 0) {\n        throw new Error('missing sourcesDigest');\n      }\n\n      return {\n        found: true,\n        indexRevision,\n        engineConfigHash,\n        sourcesDigest,\n      };\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException | undefined)?.code;\n      if (code === 'ENOENT') {\n        continue;\n      }\n\n      const message = error instanceof Error ? error.message : String(error);\n      throw new Error(`Invalid index manifest at ${manifestPath}: ${message}`);\n    }\n  }\n\n  return { found: false };\n}\n\nfunction sanitizeEngineOptionsForHash(options: Record<string, unknown>): Record<string, unknown> {\n  const {\n    _runtime: _runtimeIgnored,\n    onProgress: _onProgressIgnored,\n    platform: _platformIgnored,\n    ...rest\n  } = options as Record<string, unknown>;\n  return rest;\n}\n\nfunction stableStringify(value: unknown): string {\n  return JSON.stringify(sortObjectDeep(value));\n}\n\nfunction sortObjectDeep(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortObjectDeep);\n  }\n  if (value && typeof value === 'object') {\n    const entries = Object.entries(value as Record<string, unknown>)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([key, val]) => [key, sortObjectDeep(val)] as const);\n    return Object.fromEntries(entries);\n  }\n  return value;\n}\n","/**\n * Mind rag-index command - build Mind indexes (V3)\n */\n\nimport { defineCommand, useConfig, usePlatform, useLoader, type PluginContextV3 } from '@kb-labs/sdk';\nimport { runRagIndex } from '../../features/rag';\n\ninterface RagIndexInput {\n  argv: string[];\n  flags: {\n    cwd?: string;\n    scope?: string;\n    include?: string;\n    exclude?: string;\n    skipDeduplication?: boolean;\n    json?: boolean;\n    quiet?: boolean;\n  };\n}\n\ninterface RagIndexResult {\n  exitCode: number;\n  ok: boolean;\n  scopes?: string[];\n  adapters?: {\n    vectorStore: string;\n    embeddings: string;\n    storage: string;\n    llm: string;\n    cache: string;\n  };\n}\n\nexport default defineCommand({\n  id: 'mind:rag-index',\n  description: 'Build Mind indexes',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: RagIndexInput): Promise<RagIndexResult> {\n      const startTime = Date.now();\n      const { flags } = input;\n\n      // Get Mind config using useConfig() helper\n      const mindConfig = await useConfig();\n\n      const cwd = flags.cwd || ctx.cwd;\n      const scopeId = flags.scope;\n      const include = flags.include;\n      const exclude = flags.exclude;\n      const skipDeduplication = flags.skipDeduplication;\n\n      // Get platform for analytics (not passed to Mind - child process uses usePlatform())\n      const platform = usePlatform();\n\n      // Use loader for visual feedback (unless quiet/json mode)\n      const loader = !flags.quiet && !flags.json ? useLoader('Building Mind RAG index...') : null;\n      loader?.start();\n\n      try {\n        // Pass mindConfig from useConfig() - avoids reloading config in child process\n        // IMPORTANT: Pass platform so Mind engine uses wrapped adapters with analytics tracking\n        const result = await runRagIndex({\n          cwd,\n          scopeId,\n          include,\n          exclude,\n          skipDeduplication,\n          config: mindConfig,\n          platform,\n        });\n\n        const timing = Date.now() - startTime;\n        loader?.succeed(`Index built in ${(timing / 1000).toFixed(1)}s`);\n\n        // Track analytics if available (runs in parent process)\n        platform?.analytics?.track?.('mind.rag-index', {\n          scopeIds: result.scopeIds,\n          stats: result.stats,\n        }).catch(() => {});\n\n        if (flags.json) {\n          ctx.ui.json({\n            ok: true,\n            scopes: result.scopeIds,\n            stats: result.stats,\n            adapters: result.adapters,\n            timingMs: timing,\n          });\n        } else if (!flags.quiet) {\n          const { stats } = result;\n          const percentage = stats.filesDiscovered > 0\n            ? ((stats.filesProcessed / stats.filesDiscovered) * 100).toFixed(1)\n            : '0.0';\n          const chunksPerFile = stats.filesProcessed > 0\n            ? (stats.chunksStored / stats.filesProcessed).toFixed(2)\n            : '0.00';\n\n          ctx.ui.success(\n            `Indexed ${stats.filesProcessed} files, ${stats.filesSkipped} skipped, ${stats.chunksStored} chunks, deleted ${stats.deletedFiles ?? 0} files/${stats.deletedChunks ?? 0} chunks`,\n            {\n              title: 'Mind RAG Index',\n              sections: [\n                {\n                  header: 'Files',\n                  items: [\n                    `Discovered: ${stats.filesDiscovered}`,\n                    `Processed:  ${stats.filesProcessed} (${percentage}%)`,\n                    `Skipped:    ${stats.filesSkipped}`,\n                  ],\n                },\n                {\n                  header: 'Chunks',\n                  items: [\n                    `Stored: ${stats.chunksStored}`,\n                    `Updated: ${stats.chunksUpdated}`,\n                    `Skipped: ${stats.chunksSkipped}`,\n                    `Rate:   ${chunksPerFile}/file`,\n                  ],\n                },\n                {\n                  header: 'Cleanup',\n                  items: [\n                    `Deleted files:  ${stats.deletedFiles ?? 0}`,\n                    `Deleted chunks: ${stats.deletedChunks ?? 0}`,\n                    `Invalid chunks: ${stats.invalidChunks ?? 0}`,\n                  ],\n                },\n                {\n                  header: 'Health',\n                  items: [\n                    `Errors: ${stats.errorCount}`,\n                  ],\n                },\n              ],\n              timing,\n            }\n          );\n        }\n\n        return {\n          exitCode: 0,\n          ok: true,\n          scopes: result.scopeIds,\n          adapters: result.adapters,\n        };\n      } catch (error) {\n        const timing = Date.now() - startTime;\n        const message = error instanceof Error ? error.message : String(error);\n        loader?.fail(`Index build failed: ${message}`);\n\n        if (flags.json) {\n          ctx.ui.info(JSON.stringify({\n            ok: false,\n            error: message,\n            timingMs: timing,\n          }));\n        } else if (!flags.quiet) {\n          ctx.ui.error(`Index build failed: ${message}`);\n        }\n\n        // Track analytics\n        platform?.analytics?.track?.('mind.rag-index', {\n          error: true,\n          errorMessage: message,\n          timingMs: timing,\n        }).catch(() => {});\n\n        return { exitCode: 1, ok: false };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/rag-query.d.ts

@@ -0,0 +1,25 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * Mind rag-query command - semantic RAG search (V3)
+ */
+interface RagQueryInput {
+    argv: string[];
+    flags: {
+        cwd?: string;
+        scope?: string;
+        text?: string;
+        intent?: string;
+        limit?: number;
+        profile?: string;
+        mode?: string;
+        format?: string;
+        json?: boolean;
+        quiet?: boolean;
+        agent?: boolean;
+        debug?: boolean;
+    };
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, RagQueryInput, any>;
+
+export { _default as default };