@kb-labs/mind-entry 2.94.0 → 2.98.0

package/dist/cli/commands/index.js

@@ -0,0 +1,96 @@
+import { defineCommand, useLoader, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { createMind } from '@kb-labs/mind-core';
+import { resolveMindConfig } from '@kb-labs/mind-contracts';
+
+// src/cli/commands/index.ts
+function buildServices() {
+  const vectorStore = useVectorStore();
+  const embeddings = useEmbeddings();
+  const storage = useStorage();
+  const cache = useCache();
+  const llm = useLLM();
+  const logger = useLogger();
+  const missing = [];
+  if (!vectorStore) {
+    missing.push("vectorStore");
+  }
+  if (!embeddings) {
+    missing.push("embeddings");
+  }
+  if (!storage) {
+    missing.push("storage");
+  }
+  if (!cache) {
+    missing.push("cache");
+  }
+  if (!llm) {
+    missing.push("llm");
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `mind: required platform adapters not configured: ${missing.join(", ")}. Configure them in .kb/kb.config.json under "adapters".`
+    );
+  }
+  return { vectorStore, embeddings, storage, cache, llm, logger };
+}
+async function loadConfig() {
+  const raw = await useConfig();
+  return resolveMindConfig(raw ?? {});
+}
+async function buildMind(cwd) {
+  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });
+}
+
+// src/cli/commands/index.ts
+function stageText(e) {
+  switch (e.stage) {
+    case "discover":
+      return `Discovered ${e.files} file(s)`;
+    case "delta":
+      return `Delta: ${e.toIndex} to (re)index \xB7 ${e.unchanged} unchanged \xB7 ${e.removed} removed`;
+    case "chunk":
+      return `Chunked \u2192 ${e.chunks} chunk(s)`;
+    case "embed":
+      return `Embedding ${e.done}/${e.total} chunk(s)`;
+    case "upsert":
+      return `Upserting ${e.count} vector(s)`;
+    case "save":
+      return "Saving index manifest";
+  }
+}
+var commands_default = defineCommand({
+  id: "mind:index",
+  description: "Build or refresh a Mind index from source files",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      try {
+        const mind = await buildMind(flags.root ?? ctx.cwd);
+        const loader = flags.json ? void 0 : useLoader(`Indexing "${flags.index ?? "default"}"\u2026`);
+        loader?.start();
+        const res = await mind.index(
+          { indexId: flags.index, scope: flags.scope, full: flags.full },
+          flags.json ? void 0 : (e) => loader?.update({ text: stageText(e) })
+        );
+        if (flags.json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        const summary = `Indexed ${res.filesIndexed} file(s), ${res.chunks} chunk(s) into "${res.indexId}" (${res.durationMs}ms)`;
+        if (loader) {
+          loader.succeed(summary);
+        } else {
+          ctx.ui?.success?.(summary);
+        }
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, flags.json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { commands_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The single place the plugin touches platform hooks.\n *\n * Assembles `MindServices` from `@kb-labs/sdk` hooks and resolves the plugin\n * config. CLI commands and REST handlers both call `buildMind(...)` so they\n * drive the exact same engine.\n */\n\nimport {\n  useVectorStore,\n  useEmbeddings,\n  useStorage,\n  useCache,\n  useLLM,\n  useLogger,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { createMind, type Mind, type MindServices } from '@kb-labs/mind-core';\nimport { resolveMindConfig, type MindConfigInput } from '@kb-labs/mind-contracts';\n\n/** Build MindServices from platform hooks, failing fast on missing required adapters. */\nexport function buildServices(): MindServices {\n  const vectorStore = useVectorStore();\n  const embeddings = useEmbeddings();\n  const storage = useStorage();\n  const cache = useCache();\n  const llm = useLLM();\n  const logger = useLogger();\n\n  const missing: string[] = [];\n  if (!vectorStore) {\n    missing.push('vectorStore');\n  }\n  if (!embeddings) {\n    missing.push('embeddings');\n  }\n  if (!storage) {\n    missing.push('storage');\n  }\n  if (!cache) {\n    missing.push('cache');\n  }\n  if (!llm) {\n    missing.push('llm');\n  }\n  if (missing.length > 0) {\n    throw new Error(\n      `mind: required platform adapters not configured: ${missing.join(', ')}. ` +\n        `Configure them in .kb/kb.config.json under \"adapters\".`,\n    );\n  }\n\n  return { vectorStore: vectorStore!, embeddings: embeddings!, storage: storage!, cache: cache!, llm: llm!, logger };\n}\n\n/** Resolve the plugin config from the `mind` config section. */\nexport async function loadConfig() {\n  const raw = await useConfig<MindConfigInput>();\n  return resolveMindConfig(raw ?? {});\n}\n\n/**\n * Convenience: build the Mind facade (services + config) in one call.\n * `cwd` is the workspace root source paths resolve against (from `ctx.cwd`).\n */\nexport async function buildMind(cwd?: string): Promise<Mind> {\n  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });\n}\n","import { defineCommand, handleError, useLoader, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { type IndexFlags, type IndexResponse } from '@kb-labs/mind-contracts';\nimport { type IngestProgress } from '@kb-labs/mind-core';\nimport { buildMind } from '../../platform';\n\ntype IndexCmdResult = { exitCode: number; result?: IndexResponse };\n\n/** Map an ingest stage to a one-line loader label. */\nfunction stageText(e: IngestProgress): string {\n  switch (e.stage) {\n    case 'discover':\n      return `Discovered ${e.files} file(s)`;\n    case 'delta':\n      return `Delta: ${e.toIndex} to (re)index · ${e.unchanged} unchanged · ${e.removed} removed`;\n    case 'chunk':\n      return `Chunked → ${e.chunks} chunk(s)`;\n    case 'embed':\n      return `Embedding ${e.done}/${e.total} chunk(s)`;\n    case 'upsert':\n      return `Upserting ${e.count} vector(s)`;\n    case 'save':\n      return 'Saving index manifest';\n  }\n}\n\nexport default defineCommand<unknown, CLIInput<IndexFlags>, IndexResponse>({\n  id: 'mind:index',\n  description: 'Build or refresh a Mind index from source files',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<IndexFlags>): Promise<IndexCmdResult> {\n      const { flags } = input;\n      try {\n        // `--root` lets one kb-labs install index an arbitrary project root\n        // (paths + freshness resolve against it); defaults to the invocation cwd.\n        const mind = await buildMind(flags.root ?? ctx.cwd);\n\n        // Built-in SDK loader: an animated spinner whose text we drive per stage\n        // (writes to stdout directly, so it renders even though the CLI presenter\n        // has no spinner). It self-suppresses in JSON mode, keeping stdout clean.\n        const loader = flags.json ? undefined : useLoader(`Indexing \"${flags.index ?? 'default'}\"…`);\n        loader?.start();\n\n        const res = await mind.index(\n          { indexId: flags.index, scope: flags.scope, full: flags.full },\n          flags.json ? undefined : (e) => loader?.update({ text: stageText(e) }),\n        );\n\n        if (flags.json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n        const summary = `Indexed ${res.filesIndexed} file(s), ${res.chunks} chunk(s) into \"${res.indexId}\" (${res.durationMs}ms)`;\n        if (loader) {\n          loader.succeed(summary);\n        } else {\n          ctx.ui?.success?.(summary);\n        }\n        return { exitCode: 0, result: res };\n      } catch (err) {\n        handleError(ctx, err, flags.json);\n        return { exitCode: 1 };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/reindex.d.ts

@@ -0,0 +1,11 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<any>, {
+    durationMs: number;
+    indexId: string;
+    filesIndexed: number;
+    chunks: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/reindex.js

@@ -0,0 +1,71 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { createMind } from '@kb-labs/mind-core';
+import { resolveMindConfig } from '@kb-labs/mind-contracts';
+
+// src/cli/commands/reindex.ts
+function buildServices() {
+  const vectorStore = useVectorStore();
+  const embeddings = useEmbeddings();
+  const storage = useStorage();
+  const cache = useCache();
+  const llm = useLLM();
+  const logger = useLogger();
+  const missing = [];
+  if (!vectorStore) {
+    missing.push("vectorStore");
+  }
+  if (!embeddings) {
+    missing.push("embeddings");
+  }
+  if (!storage) {
+    missing.push("storage");
+  }
+  if (!cache) {
+    missing.push("cache");
+  }
+  if (!llm) {
+    missing.push("llm");
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `mind: required platform adapters not configured: ${missing.join(", ")}. Configure them in .kb/kb.config.json under "adapters".`
+    );
+  }
+  return { vectorStore, embeddings, storage, cache, llm, logger };
+}
+async function loadConfig() {
+  const raw = await useConfig();
+  return resolveMindConfig(raw ?? {});
+}
+async function buildMind(cwd) {
+  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });
+}
+
+// src/cli/commands/reindex.ts
+var reindex_default = defineCommand({
+  id: "mind:reindex",
+  description: "Rebuild an index from source files",
+  handler: {
+    async execute(ctx, input) {
+      try {
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.reindex({ indexId: input.flags.index, full: input.flags.full });
+        if (input.flags.json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        ctx.ui?.success?.(
+          `Reindexed "${res.indexId}": ${res.filesIndexed} file(s), ${res.chunks} chunk(s) (${res.durationMs}ms)`
+        );
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { reindex_default as default };
+//# sourceMappingURL=reindex.js.map
+//# sourceMappingURL=reindex.js.map

package/dist/cli/commands/reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/reindex.ts"],"names":[],"mappings":"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","file":"reindex.js","sourcesContent":["/**\n * The single place the plugin touches platform hooks.\n *\n * Assembles `MindServices` from `@kb-labs/sdk` hooks and resolves the plugin\n * config. CLI commands and REST handlers both call `buildMind(...)` so they\n * drive the exact same engine.\n */\n\nimport {\n  useVectorStore,\n  useEmbeddings,\n  useStorage,\n  useCache,\n  useLLM,\n  useLogger,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { createMind, type Mind, type MindServices } from '@kb-labs/mind-core';\nimport { resolveMindConfig, type MindConfigInput } from '@kb-labs/mind-contracts';\n\n/** Build MindServices from platform hooks, failing fast on missing required adapters. */\nexport function buildServices(): MindServices {\n  const vectorStore = useVectorStore();\n  const embeddings = useEmbeddings();\n  const storage = useStorage();\n  const cache = useCache();\n  const llm = useLLM();\n  const logger = useLogger();\n\n  const missing: string[] = [];\n  if (!vectorStore) {\n    missing.push('vectorStore');\n  }\n  if (!embeddings) {\n    missing.push('embeddings');\n  }\n  if (!storage) {\n    missing.push('storage');\n  }\n  if (!cache) {\n    missing.push('cache');\n  }\n  if (!llm) {\n    missing.push('llm');\n  }\n  if (missing.length > 0) {\n    throw new Error(\n      `mind: required platform adapters not configured: ${missing.join(', ')}. ` +\n        `Configure them in .kb/kb.config.json under \"adapters\".`,\n    );\n  }\n\n  return { vectorStore: vectorStore!, embeddings: embeddings!, storage: storage!, cache: cache!, llm: llm!, logger };\n}\n\n/** Resolve the plugin config from the `mind` config section. */\nexport async function loadConfig() {\n  const raw = await useConfig<MindConfigInput>();\n  return resolveMindConfig(raw ?? {});\n}\n\n/**\n * Convenience: build the Mind facade (services + config) in one call.\n * `cwd` is the workspace root source paths resolve against (from `ctx.cwd`).\n */\nexport async function buildMind(cwd?: string): Promise<Mind> {\n  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });\n}\n","import { defineCommand, handleError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { type ReindexFlags, type IndexResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\nexport default defineCommand<unknown, CLIInput<ReindexFlags>, IndexResponse>({\n  id: 'mind:reindex',\n  description: 'Rebuild an index from source files',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<ReindexFlags>): Promise<{ exitCode: number; result?: IndexResponse }> {\n      try {\n      const mind = await buildMind(ctx.cwd);\n      const res = await mind.reindex({ indexId: input.flags.index, full: input.flags.full });\n      if (input.flags.json) {\n        ctx.ui?.json?.(res);\n        return { exitCode: 0, result: res };\n      }\n      ctx.ui?.success?.(\n        `Reindexed \"${res.indexId}\": ${res.filesIndexed} file(s), ${res.chunks} chunk(s) (${res.durationMs}ms)`,\n      );\n      return { exitCode: 0, result: res };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1 };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,25 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<any>, {
+    confidence: number;
+    indexId: string;
+    meta: {
+        requestId: string;
+        timingMs: number;
+        semanticWinRate: number;
+        staleCount: number;
+    } & {
+        [k: string]: unknown;
+    };
+    results: {
+        file: string;
+        lines: [number, number];
+        kind: "code" | "file" | "doc" | "adr" | "repo" | "config" | "external";
+        matchedBy: "lexical" | "semantic" | "both";
+        stale: boolean;
+        snippet?: string | undefined;
+    }[];
+}>;
+
+export { _default as default };

package/dist/cli/commands/search.js

@@ -0,0 +1,94 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { SearchRequestSchema, resolveMindConfig } from '@kb-labs/mind-contracts';
+import { createMind } from '@kb-labs/mind-core';
+
+// src/cli/commands/search.ts
+function buildServices() {
+  const vectorStore = useVectorStore();
+  const embeddings = useEmbeddings();
+  const storage = useStorage();
+  const cache = useCache();
+  const llm = useLLM();
+  const logger = useLogger();
+  const missing = [];
+  if (!vectorStore) {
+    missing.push("vectorStore");
+  }
+  if (!embeddings) {
+    missing.push("embeddings");
+  }
+  if (!storage) {
+    missing.push("storage");
+  }
+  if (!cache) {
+    missing.push("cache");
+  }
+  if (!llm) {
+    missing.push("llm");
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `mind: required platform adapters not configured: ${missing.join(", ")}. Configure them in .kb/kb.config.json under "adapters".`
+    );
+  }
+  return { vectorStore, embeddings, storage, cache, llm, logger };
+}
+async function loadConfig() {
+  const raw = await useConfig();
+  return resolveMindConfig(raw ?? {});
+}
+async function buildMind(cwd) {
+  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });
+}
+
+// src/cli/commands/search.ts
+var search_default = defineCommand({
+  id: "mind:search",
+  description: "Locate sources \u2014 fast retrieval over a Mind index (no LLM)",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const json = flags.format === "json" || flags.json;
+      try {
+        const req = SearchRequestSchema.parse({
+          text: flags.text,
+          indexId: flags.index,
+          intent: flags.intent,
+          limit: flags.limit,
+          snippet: flags.snippet
+        });
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.search(req);
+        if (json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        if (res.results.length === 0) {
+          ctx.ui?.warn?.(`No results in index "${res.indexId}"`);
+        } else {
+          ctx.ui?.success?.(`${res.results.length} result(s) \u2014 confidence ${res.confidence.toFixed(2)}`, {
+            sections: [
+              {
+                header: `Index "${res.indexId}"`,
+                items: res.results.map((r) => {
+                  const loc = `${r.file}:${r.lines[0]}-${r.lines[1]}`;
+                  const tags = `[${r.matchedBy}${r.stale ? ", stale" : ""}]`;
+                  return r.snippet ? `${loc} ${tags}
+    ${r.snippet}` : `${loc} ${tags}`;
+                })
+              }
+            ]
+          });
+        }
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { search_default as default };
+//# sourceMappingURL=search.js.map
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/search.ts"],"names":[],"mappings":"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","file":"search.js","sourcesContent":["/**\n * The single place the plugin touches platform hooks.\n *\n * Assembles `MindServices` from `@kb-labs/sdk` hooks and resolves the plugin\n * config. CLI commands and REST handlers both call `buildMind(...)` so they\n * drive the exact same engine.\n */\n\nimport {\n  useVectorStore,\n  useEmbeddings,\n  useStorage,\n  useCache,\n  useLLM,\n  useLogger,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { createMind, type Mind, type MindServices } from '@kb-labs/mind-core';\nimport { resolveMindConfig, type MindConfigInput } from '@kb-labs/mind-contracts';\n\n/** Build MindServices from platform hooks, failing fast on missing required adapters. */\nexport function buildServices(): MindServices {\n  const vectorStore = useVectorStore();\n  const embeddings = useEmbeddings();\n  const storage = useStorage();\n  const cache = useCache();\n  const llm = useLLM();\n  const logger = useLogger();\n\n  const missing: string[] = [];\n  if (!vectorStore) {\n    missing.push('vectorStore');\n  }\n  if (!embeddings) {\n    missing.push('embeddings');\n  }\n  if (!storage) {\n    missing.push('storage');\n  }\n  if (!cache) {\n    missing.push('cache');\n  }\n  if (!llm) {\n    missing.push('llm');\n  }\n  if (missing.length > 0) {\n    throw new Error(\n      `mind: required platform adapters not configured: ${missing.join(', ')}. ` +\n        `Configure them in .kb/kb.config.json under \"adapters\".`,\n    );\n  }\n\n  return { vectorStore: vectorStore!, embeddings: embeddings!, storage: storage!, cache: cache!, llm: llm!, logger };\n}\n\n/** Resolve the plugin config from the `mind` config section. */\nexport async function loadConfig() {\n  const raw = await useConfig<MindConfigInput>();\n  return resolveMindConfig(raw ?? {});\n}\n\n/**\n * Convenience: build the Mind facade (services + config) in one call.\n * `cwd` is the workspace root source paths resolve against (from `ctx.cwd`).\n */\nexport async function buildMind(cwd?: string): Promise<Mind> {\n  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });\n}\n","import { defineCommand, handleError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SearchRequestSchema, type SearchFlags, type SearchResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\ntype SearchResult = { exitCode: number; result?: SearchResponse };\n\nexport default defineCommand<unknown, CLIInput<SearchFlags>, SearchResponse>({\n  id: 'mind:search',\n  description: 'Locate sources — fast retrieval over a Mind index (no LLM)',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<SearchFlags>): Promise<SearchResult> {\n      const { flags } = input;\n      const json = flags.format === 'json' || flags.json;\n      try {\n        // Validate/normalize CLI flags into the wire request (narrows enums).\n        const req = SearchRequestSchema.parse({\n          text: flags.text,\n          indexId: flags.index,\n          intent: flags.intent,\n          limit: flags.limit,\n          snippet: flags.snippet,\n        });\n\n        const mind = await buildMind(ctx.cwd);\n        const res = await mind.search(req);\n\n        if (json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n        if (res.results.length === 0) {\n          ctx.ui?.warn?.(`No results in index \"${res.indexId}\"`);\n        } else {\n          ctx.ui?.success?.(`${res.results.length} result(s) — confidence ${res.confidence.toFixed(2)}`, {\n            sections: [\n              {\n                header: `Index \"${res.indexId}\"`,\n                items: res.results.map((r) => {\n                  const loc = `${r.file}:${r.lines[0]}-${r.lines[1]}`;\n                  const tags = `[${r.matchedBy}${r.stale ? ', stale' : ''}]`;\n                  return r.snippet ? `${loc} ${tags}\\n    ${r.snippet}` : `${loc} ${tags}`;\n                }),\n              },\n            ],\n          });\n        }\n        return { exitCode: 0, result: res };\n      } catch (err) {\n        handleError(ctx, err, json);\n        return { exitCode: 1 };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<any>, {
+    indexes: {
+        indexId: string;
+        staleCount: number;
+        chunks: number;
+        documents: number;
+        lastIndexedAt: string | null;
+        label?: string | undefined;
+        coverage?: string | undefined;
+    }[];
+    healthy: boolean;
+}>;
+
+export { _default as default };

package/dist/cli/commands/status.js

@@ -0,0 +1,89 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { createMind } from '@kb-labs/mind-core';
+import { resolveMindConfig } from '@kb-labs/mind-contracts';
+
+// src/cli/commands/status.ts
+function buildServices() {
+  const vectorStore = useVectorStore();
+  const embeddings = useEmbeddings();
+  const storage = useStorage();
+  const cache = useCache();
+  const llm = useLLM();
+  const logger = useLogger();
+  const missing = [];
+  if (!vectorStore) {
+    missing.push("vectorStore");
+  }
+  if (!embeddings) {
+    missing.push("embeddings");
+  }
+  if (!storage) {
+    missing.push("storage");
+  }
+  if (!cache) {
+    missing.push("cache");
+  }
+  if (!llm) {
+    missing.push("llm");
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `mind: required platform adapters not configured: ${missing.join(", ")}. Configure them in .kb/kb.config.json under "adapters".`
+    );
+  }
+  return { vectorStore, embeddings, storage, cache, llm, logger };
+}
+async function loadConfig() {
+  const raw = await useConfig();
+  return resolveMindConfig(raw ?? {});
+}
+async function buildMind(cwd) {
+  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });
+}
+
+// src/cli/commands/status.ts
+var status_default = defineCommand({
+  id: "mind:status",
+  description: "Show Mind index status",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      try {
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.status(flags.index);
+        if (flags.json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        if (res.indexes.length === 0) {
+          ctx.ui?.warn?.("No indexes built yet. Run `kb mind index` first.");
+          return { exitCode: 0, result: res };
+        }
+        ctx.ui?.success?.("Mind indexes", {
+          sections: [
+            {
+              header: `${res.indexes.length} index(es)`,
+              items: res.indexes.map((i) => {
+                const head = `${i.indexId}${i.label ? ` \u2014 ${i.label}` : ""}`;
+                const counts = `${i.documents} doc(s), ${i.chunks} chunk(s)`;
+                const scope = i.coverage ? `
+    scope: ${i.coverage}` : "";
+                const stale = i.staleCount ? `, ${i.staleCount} stale` : "";
+                const updated = i.lastIndexedAt ? `, updated ${i.lastIndexedAt}` : " (not built)";
+                return `${head}: ${counts}${stale}${updated}${scope}`;
+              })
+            }
+          ]
+        });
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, flags.json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { status_default as default };
+//# sourceMappingURL=status.js.map
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/status.ts"],"names":[],"mappings":"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","file":"status.js","sourcesContent":["/**\n * The single place the plugin touches platform hooks.\n *\n * Assembles `MindServices` from `@kb-labs/sdk` hooks and resolves the plugin\n * config. CLI commands and REST handlers both call `buildMind(...)` so they\n * drive the exact same engine.\n */\n\nimport {\n  useVectorStore,\n  useEmbeddings,\n  useStorage,\n  useCache,\n  useLLM,\n  useLogger,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { createMind, type Mind, type MindServices } from '@kb-labs/mind-core';\nimport { resolveMindConfig, type MindConfigInput } from '@kb-labs/mind-contracts';\n\n/** Build MindServices from platform hooks, failing fast on missing required adapters. */\nexport function buildServices(): MindServices {\n  const vectorStore = useVectorStore();\n  const embeddings = useEmbeddings();\n  const storage = useStorage();\n  const cache = useCache();\n  const llm = useLLM();\n  const logger = useLogger();\n\n  const missing: string[] = [];\n  if (!vectorStore) {\n    missing.push('vectorStore');\n  }\n  if (!embeddings) {\n    missing.push('embeddings');\n  }\n  if (!storage) {\n    missing.push('storage');\n  }\n  if (!cache) {\n    missing.push('cache');\n  }\n  if (!llm) {\n    missing.push('llm');\n  }\n  if (missing.length > 0) {\n    throw new Error(\n      `mind: required platform adapters not configured: ${missing.join(', ')}. ` +\n        `Configure them in .kb/kb.config.json under \"adapters\".`,\n    );\n  }\n\n  return { vectorStore: vectorStore!, embeddings: embeddings!, storage: storage!, cache: cache!, llm: llm!, logger };\n}\n\n/** Resolve the plugin config from the `mind` config section. */\nexport async function loadConfig() {\n  const raw = await useConfig<MindConfigInput>();\n  return resolveMindConfig(raw ?? {});\n}\n\n/**\n * Convenience: build the Mind facade (services + config) in one call.\n * `cwd` is the workspace root source paths resolve against (from `ctx.cwd`).\n */\nexport async function buildMind(cwd?: string): Promise<Mind> {\n  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });\n}\n","import { defineCommand, handleError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { type StatusFlags, type IndexSummary, type StatusResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\nexport default defineCommand<unknown, CLIInput<StatusFlags>, StatusResponse>({\n  id: 'mind:status',\n  description: 'Show Mind index status',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<StatusFlags>): Promise<{ exitCode: number; result?: StatusResponse }> {\n      const { flags } = input;\n      try {\n        const mind = await buildMind(ctx.cwd);\n        const res = await mind.status(flags.index);\n\n        if (flags.json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n\n        if (res.indexes.length === 0) {\n          ctx.ui?.warn?.('No indexes built yet. Run `kb mind index` first.');\n          return { exitCode: 0, result: res };\n        }\n\n        ctx.ui?.success?.('Mind indexes', {\n          sections: [\n            {\n              header: `${res.indexes.length} index(es)`,\n              items: res.indexes.map((i: IndexSummary) => {\n                const head = `${i.indexId}${i.label ? ` — ${i.label}` : ''}`;\n                const counts = `${i.documents} doc(s), ${i.chunks} chunk(s)`;\n                const scope = i.coverage ? `\\n    scope: ${i.coverage}` : '';\n                const stale = i.staleCount ? `, ${i.staleCount} stale` : '';\n                const updated = i.lastIndexedAt ? `, updated ${i.lastIndexedAt}` : ' (not built)';\n                return `${head}: ${counts}${stale}${updated}${scope}`;\n              }),\n            },\n          ],\n        });\n        return { exitCode: 0, result: res };\n      } catch (err) {\n        handleError(ctx, err, flags.json);\n        return { exitCode: 1 };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/sync-add.d.ts

@@ -0,0 +1,11 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<any>, {
+    indexId: string;
+    added: number;
+    updated: number;
+    deleted: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/sync-add.js

@@ -0,0 +1,74 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { createMind } from '@kb-labs/mind-core';
+import { resolveMindConfig } from '@kb-labs/mind-contracts';
+
+// src/cli/commands/sync-add.ts
+function buildServices() {
+  const vectorStore = useVectorStore();
+  const embeddings = useEmbeddings();
+  const storage = useStorage();
+  const cache = useCache();
+  const llm = useLLM();
+  const logger = useLogger();
+  const missing = [];
+  if (!vectorStore) {
+    missing.push("vectorStore");
+  }
+  if (!embeddings) {
+    missing.push("embeddings");
+  }
+  if (!storage) {
+    missing.push("storage");
+  }
+  if (!cache) {
+    missing.push("cache");
+  }
+  if (!llm) {
+    missing.push("llm");
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `mind: required platform adapters not configured: ${missing.join(", ")}. Configure them in .kb/kb.config.json under "adapters".`
+    );
+  }
+  return { vectorStore, embeddings, storage, cache, llm, logger };
+}
+async function loadConfig() {
+  const raw = await useConfig();
+  return resolveMindConfig(raw ?? {});
+}
+async function buildMind(cwd) {
+  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });
+}
+
+// src/cli/commands/sync-add.ts
+var sync_add_default = defineCommand({
+  id: "mind:sync-add",
+  description: "Add documents to an index (incremental)",
+  handler: {
+    async execute(ctx, input) {
+      try {
+        const paths = input.argv ?? [];
+        if (paths.length === 0) {
+          ctx.ui?.error?.("Provide one or more paths: kb mind sync add <paths\u2026>");
+          return { exitCode: 1 };
+        }
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.syncAdd(paths, input.flags.index);
+        if (input.flags.json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        ctx.ui?.success?.(`Sync add \u2192 "${res.indexId}": +${res.added} added, ${res.updated} updated`);
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { sync_add_default as default };
+//# sourceMappingURL=sync-add.js.map
+//# sourceMappingURL=sync-add.js.map

package/dist/cli/commands/sync-add.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/sync-add.ts"],"names":[],"mappings":"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","file":"sync-add.js","sourcesContent":["/**\n * The single place the plugin touches platform hooks.\n *\n * Assembles `MindServices` from `@kb-labs/sdk` hooks and resolves the plugin\n * config. CLI commands and REST handlers both call `buildMind(...)` so they\n * drive the exact same engine.\n */\n\nimport {\n  useVectorStore,\n  useEmbeddings,\n  useStorage,\n  useCache,\n  useLLM,\n  useLogger,\n  useConfig,\n} from '@kb-labs/sdk';\nimport { createMind, type Mind, type MindServices } from '@kb-labs/mind-core';\nimport { resolveMindConfig, type MindConfigInput } from '@kb-labs/mind-contracts';\n\n/** Build MindServices from platform hooks, failing fast on missing required adapters. */\nexport function buildServices(): MindServices {\n  const vectorStore = useVectorStore();\n  const embeddings = useEmbeddings();\n  const storage = useStorage();\n  const cache = useCache();\n  const llm = useLLM();\n  const logger = useLogger();\n\n  const missing: string[] = [];\n  if (!vectorStore) {\n    missing.push('vectorStore');\n  }\n  if (!embeddings) {\n    missing.push('embeddings');\n  }\n  if (!storage) {\n    missing.push('storage');\n  }\n  if (!cache) {\n    missing.push('cache');\n  }\n  if (!llm) {\n    missing.push('llm');\n  }\n  if (missing.length > 0) {\n    throw new Error(\n      `mind: required platform adapters not configured: ${missing.join(', ')}. ` +\n        `Configure them in .kb/kb.config.json under \"adapters\".`,\n    );\n  }\n\n  return { vectorStore: vectorStore!, embeddings: embeddings!, storage: storage!, cache: cache!, llm: llm!, logger };\n}\n\n/** Resolve the plugin config from the `mind` config section. */\nexport async function loadConfig() {\n  const raw = await useConfig<MindConfigInput>();\n  return resolveMindConfig(raw ?? {});\n}\n\n/**\n * Convenience: build the Mind facade (services + config) in one call.\n * `cwd` is the workspace root source paths resolve against (from `ctx.cwd`).\n */\nexport async function buildMind(cwd?: string): Promise<Mind> {\n  return createMind(buildServices(), await loadConfig(), { cwd: cwd ?? process.cwd() });\n}\n","import { defineCommand, handleError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { type SyncPathsFlags, type SyncResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\nexport default defineCommand<unknown, CLIInput<SyncPathsFlags>, SyncResponse>({\n  id: 'mind:sync-add',\n  description: 'Add documents to an index (incremental)',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<SyncPathsFlags>): Promise<{ exitCode: number; result?: SyncResponse }> {\n      try {\n      const paths = input.argv ?? [];\n      if (paths.length === 0) {\n        ctx.ui?.error?.('Provide one or more paths: kb mind sync add <paths…>');\n        return { exitCode: 1 };\n      }\n      const mind = await buildMind(ctx.cwd);\n      const res = await mind.syncAdd(paths, input.flags.index);\n      if (input.flags.json) {\n        ctx.ui?.json?.(res);\n        return { exitCode: 0, result: res };\n      }\n      ctx.ui?.success?.(`Sync add → \"${res.indexId}\": +${res.added} added, ${res.updated} updated`);\n      return { exitCode: 0, result: res };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1 };\n      }\n    },\n  },\n});\n"]}

package/dist/cli/commands/sync-delete.d.ts

@@ -0,0 +1,11 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<any>, {
+    indexId: string;
+    added: number;
+    updated: number;
+    deleted: number;
+}>;
+
+export { _default as default };