@kb-labs/mind-entry 2.93.0 → 2.96.0

package/README.md

@@ -1,218 +1,29 @@
-# @kb-labs/mind-cli
+# @kb-labs/mind-entry
 
-CLI commands for KB Labs Mind.
+Plugin entry point for KB Labs **Mind** (RAG) — the manifest that wires the
+engine (`@kb-labs/mind-core`) to the platform: CLI commands, REST routes, and
+permissions. Imports only `@kb-labs/sdk`.
 
-## Vision & Purpose
-
-**@kb-labs/mind-cli** provides CLI commands for KB Labs Mind. It includes commands for indexing, querying, packing, and verifying Mind indexes, plus REST handlers and Studio widgets.
-
-### Core Goals
-
-- **Indexing Commands**: Index codebase and update indexes
-- **Query Commands**: Query Mind indexes
-- **Pack Commands**: Build context packs
-- **Verify Commands**: Verify Mind indexes
-- **REST Handlers**: REST API handlers
-- **Studio Widgets**: Studio widget implementations
-
-## Package Status
-
-- **Version**: 0.1.0
-- **Stage**: Stable
-- **Status**: Production Ready ✅
-
-## Architecture
-
-### High-Level Overview
-
-```
-Mind CLI
-    │
-    ├──► CLI Commands
-    ├──► Application Layer
-    ├──► Domain Layer
-    ├──► Infrastructure Layer
-    ├──► REST Handlers
-    └──► Studio Widgets
-```
-
-### Key Components
-
-1. **CLI Commands** (`cli/`): CLI command implementations
-2. **Application Layer** (`application/`): Use cases and services
-3. **Domain Layer** (`domain/`): Domain logic
-4. **Infrastructure Layer** (`infra/`): Adapters and infrastructure
-5. **REST Handlers** (`rest/`): REST API handlers
-6. **Studio Widgets** (`studio/`): Studio widget implementations
-
-## ✨ Features
-
-- **Indexing Commands**: Index codebase and update indexes
-- **Query Commands**: Query Mind indexes
-- **Pack Commands**: Build context packs
-- **Verify Commands**: Verify Mind indexes
-- **REST Handlers**: REST API handlers
-- **Studio Widgets**: Query and verify widgets for Studio
-
-## 📦 API Reference
-
-### Main Exports
-
-#### CLI Commands
-
-- `index`: Index codebase command
-- `query`: Query Mind index command
-- `pack`: Build context pack command
-- `verify`: Verify Mind index command
-
-#### Manifest
-
-- `manifest`: Plugin manifest V2
-
-## 🔧 Configuration
-
-### Configuration Options
-
-All configuration via CLI flags and kb-labs.config.json.
-
-### CLI Flags
-
-- `--json`: Output JSON format
-- `--quiet`: Quiet mode
-- `--verbose`: Verbose output
-
-## 🔗 Dependencies
-
-### Runtime Dependencies
-
-- `@byjohann/toon` (`0.4.0`): Terminal UI library
-- `@kb-labs/analytics-sdk-node` (`link:../../../kb-labs-analytics/packages/analytics-sdk-node`): Analytics SDK
-- `@kb-labs/core` (`link:../../../kb-labs-core`): Core package
-- `@kb-labs/plugin-manifest` (`link:../../../kb-labs-plugin/packages/manifest`): Plugin manifest
-- `@kb-labs/plugin-adapter-studio` (`link:../../../kb-labs-plugin/packages/adapters/studio`): Studio adapter
-- `@kb-labs/mind-contracts` (`link:../contracts`): Mind contracts
-- `@kb-labs/mind-gateway` (`link:../mind-gateway`): Mind gateway
-- `@kb-labs/mind-core` (`link:../mind-core`): Mind core
-- `@kb-labs/mind-indexer` (`link:../mind-indexer`): Mind indexer
-- `@kb-labs/mind-pack` (`link:../mind-pack`): Mind pack
-- `@kb-labs/mind-query` (`link:../mind-query`): Mind query
-- `@kb-labs/mind-types` (`link:../mind-types`): Mind types
-- `@kb-labs/shared-cli-ui` (`link:../../../kb-labs-shared/packages/cli-ui`): Shared CLI UI
-- `@tanstack/react-query` (`^5.0.0`): React Query
-- `@aws-sdk/client-s3` (`^3.929.0`): AWS S3 client
-- `ajv` (`^8.17.1`): JSON schema validation
-- `ajv-formats` (`^3.0.1`): AJV formats
-- `glob` (`^11.0.0`): File globbing
-- `react` (`^18.0.0`): React
-- `uuidv7` (`^1.0.0`): UUID v7 generation
-- `yaml` (`^2.8.0`): YAML parsing
-- `zod` (`^3.23.8`): Schema validation
-
-### Development Dependencies
-
-- `@kb-labs/devkit` (`link:../../../kb-labs-devkit`): DevKit presets
-- `@types/node` (`^24.7.0`): Node.js types
-- `@types/react` (`^18.3.18`): React types
-- `tsup` (`^8.5.0`): TypeScript bundler
-- `typescript` (`^5.6.3`): TypeScript compiler
-- `vitest` (`^3.2.4`): Test runner
-
-## 🧪 Testing
-
-### Test Structure
-
-```
-src/__tests__/
-└── (13 test files)
-```
-
-### Test Coverage
-
-- **Current Coverage**: ~75%
-- **Target Coverage**: 90%
-
-## 📈 Performance
-
-### Performance Characteristics
-
-- **Time Complexity**: O(1) for command registration, O(n) for command execution
-- **Space Complexity**: O(1)
-- **Bottlenecks**: Indexing and query operations
-
-## 🔒 Security
-
-### Security Considerations
-
-- **Input Validation**: Command input validation
-- **Path Validation**: Path validation for file operations
-
-### Known Vulnerabilities
-
-- None
-
-## 🐛 Known Issues & Limitations
-
-### Known Issues
-
-- None currently
-
-### Limitations
-
-## Breaking changes (no legacy compatibility)
-
-- `runRagQuery` response field `knowledge` renamed to `result`.
-- Runtime wrappers `createKnowledgeService/createKnowledgeEngineRegistry` removed from `mind-cli`.
-- Config resolution now supports only `.kb/kb.config.json` and `kb.config.json` with `profiles[].products.mind` (or root `mind`).
-- Legacy `knowledge.json` and top-level `knowledge` config are rejected.
-
-- **Command Types**: Fixed command types
-- **Output Formats**: Fixed output formats
-
-### Future Improvements
-
-- **More Commands**: Additional commands
-- **Custom Output Formats**: Custom output format support
-
-## 🔄 Migration & Breaking Changes
-
-### Migration from Previous Versions
-
-No breaking changes in current version (0.1.0).
-
-### Breaking Changes in Future Versions
-
-- None planned
-
-## 📚 Examples
-
-### Example 1: Index Codebase
-
-```bash
-kb mind:index
-```
-
-### Example 2: Query Mind Index
+## CLI
 
 ```bash
-kb mind:query --query impact --params '{"symbol":"MyFunction"}'
+kb mind index   [--index <id>] [--scope <glob>] [--root <path>] [--full]
+kb mind search  --text "<query>" [--index <id>] [--snippet none|line|full] [--format json]
+kb mind ask     --text "<question>" [--index <id>] [--mode instant|auto|thinking] [--agent]
+kb mind explore --task "<task>" [--index <id>]        # task-orientation file map
+kb mind sync add|update|delete <paths…> [--index <id>]
+kb mind status [--index <id>]
 ```
 
-### Example 3: Build Context Pack
-
-```bash
-kb mind:pack --intent "Review this code change"
-```
-
-### Example 4: Verify Index
-
-```bash
-kb mind:verify
-```
+Agent contract: `… --format json | grep "^{"` emits a single-line JSON response
+(pointers + provenance/freshness, not payloads).
 
-## 🤝 Contributing
+## REST
 
-See [CONTRIBUTING.md](../../CONTRIBUTING.md) for development guidelines.
+Mounted under `MIND_BASE_PATH` (`/api/v1/plugins/mind`): `POST /index`,
+`/search`, `/query`, `/explore`, `/reindex`, `/sync/*`; `GET /status`, `/health`.
 
-## 📄 License
+## Tests
 
-MIT © KB Labs
+- Unit/integration — `pnpm --filter @kb-labs/mind-entry test`
+- CLI handler (CLI↔REST parity) — `pnpm --filter @kb-labs/mind-entry test:cli`

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

@@ -0,0 +1,31 @@
+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;
+    answer: string;
+    abstained: boolean;
+    sources: {
+        file: string;
+        lines: [number, number];
+        kind: "code" | "file" | "doc" | "adr" | "repo" | "config" | "external";
+        matchedBy: "lexical" | "semantic" | "both";
+        stale: boolean;
+        snippet?: string | undefined;
+    }[];
+    meta: {
+        requestId: string;
+        mode: "instant" | "auto" | "thinking";
+        timingMs: number;
+        indexId: string;
+    } & {
+        [k: string]: unknown;
+    };
+    warnings?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+
+export { _default as default };

package/dist/cli/commands/ask.js

@@ -0,0 +1,88 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { QueryRequestSchema, resolveMindConfig } from '@kb-labs/mind-contracts';
+import { createMind } from '@kb-labs/mind-core';
+
+// src/cli/commands/ask.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/ask.ts
+var ask_default = defineCommand({
+  id: "mind:ask",
+  description: "Ask a question and get a grounded answer with citations",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const json = flags.agent || flags.format === "json" || flags.json;
+      try {
+        const req = QueryRequestSchema.parse({
+          text: flags.text,
+          indexId: flags.index,
+          mode: flags.mode,
+          snippet: flags.snippet
+        });
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.ask(req);
+        if (json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        const head = res.abstained ? `\u26A0 low confidence (${res.confidence.toFixed(2)}) \u2014 answer may be unreliable` : `answer (confidence ${res.confidence.toFixed(2)})`;
+        ctx.ui?.success?.(head, {
+          sections: [
+            { header: "Answer", items: [res.answer] },
+            {
+              header: "Sources",
+              items: res.sources.map(
+                (s) => `${s.file}:${s.lines[0]}-${s.lines[1]} [${s.matchedBy}${s.stale ? ", stale" : ""}]`
+              )
+            }
+          ]
+        });
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { ask_default as default };
+//# sourceMappingURL=ask.js.map
+//# sourceMappingURL=ask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/ask.ts"],"names":[],"mappings":"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","file":"ask.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 { QueryRequestSchema, type AskFlags, type AgentResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\ntype AskResult = { exitCode: number; result?: AgentResponse };\n\nexport default defineCommand<unknown, CLIInput<AskFlags>, AgentResponse>({\n  id: 'mind:ask',\n  description: 'Ask a question and get a grounded answer with citations',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<AskFlags>): Promise<AskResult> {\n      const { flags } = input;\n      // `--agent` == `--format json`: the machine-readable agent contract.\n      const json = flags.agent || flags.format === 'json' || flags.json;\n      try {\n        const req = QueryRequestSchema.parse({\n          text: flags.text,\n          indexId: flags.index,\n          mode: flags.mode,\n          snippet: flags.snippet,\n        });\n        const mind = await buildMind(ctx.cwd);\n        const res = await mind.ask(req);\n\n        if (json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n\n        const head = res.abstained\n          ? `⚠ low confidence (${res.confidence.toFixed(2)}) — answer may be unreliable`\n          : `answer (confidence ${res.confidence.toFixed(2)})`;\n        ctx.ui?.success?.(head, {\n          sections: [\n            { header: 'Answer', items: [res.answer] },\n            {\n              header: 'Sources',\n              items: res.sources.map(\n                (s) => `${s.file}:${s.lines[0]}-${s.lines[1]} [${s.matchedBy}${s.stale ? ', stale' : ''}]`,\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/drop.d.ts

@@ -0,0 +1,10 @@
+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;
+    droppedChunks: number;
+    droppedFiles: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/drop.js

@@ -0,0 +1,90 @@
+import { defineCommand, confirmDestructive, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { DropRequestSchema, resolveMindConfig } from '@kb-labs/mind-contracts';
+import { createMind } from '@kb-labs/mind-core';
+
+// src/cli/commands/drop.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/drop.ts
+var drop_default = defineCommand({
+  id: "mind:drop",
+  description: "Drop an entire index \u2014 remove all its vectors and its manifest",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const json = flags.json;
+      try {
+        const blocked = confirmDestructive(ctx, {
+          confirmed: flags.yes,
+          isJson: json,
+          action: {
+            action: "mind drop",
+            resource: `index "${flags.index}"`,
+            effect: "deletes all vectors and the manifest",
+            severity: "high",
+            reversible: true,
+            recovery: "rebuild with `kb mind index --index <id> --full`",
+            blastRadius: { scope: "whole index" }
+          }
+        });
+        if (blocked) {
+          return blocked;
+        }
+        const req = DropRequestSchema.parse({ indexId: flags.index });
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.drop(req);
+        if (json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        ctx.ui?.success?.(
+          `Dropped "${res.indexId}" \u2014 removed ${res.droppedChunks} vector(s), ${res.droppedFiles} doc(s)`
+        );
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { drop_default as default };
+//# sourceMappingURL=drop.js.map
+//# sourceMappingURL=drop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/drop.ts"],"names":[],"mappings":"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","file":"drop.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, confirmDestructive, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { DropRequestSchema, type DropFlags, type DropResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\ntype DropResult = { exitCode: number; result?: DropResponse };\n\nexport default defineCommand<unknown, CLIInput<DropFlags>, DropResponse>({\n  id: 'mind:drop',\n  description: 'Drop an entire index — remove all its vectors and its manifest',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<DropFlags>): Promise<DropResult> {\n      const { flags } = input;\n      const json = flags.json;\n      try {\n        // Destructive: blocks in EVERY mode until --yes (agents get a structured\n        // confirmationRequired signal with severity/recovery, not a silent drop).\n        const blocked = confirmDestructive(ctx, {\n          confirmed: flags.yes,\n          isJson: json,\n          action: {\n            action: 'mind drop',\n            resource: `index \"${flags.index}\"`,\n            effect: 'deletes all vectors and the manifest',\n            severity: 'high',\n            reversible: true,\n            recovery: 'rebuild with `kb mind index --index <id> --full`',\n            blastRadius: { scope: 'whole index' },\n          },\n        });\n        if (blocked) {\n          return blocked;\n        }\n        const req = DropRequestSchema.parse({ indexId: flags.index });\n        const mind = await buildMind(ctx.cwd);\n        const res = await mind.drop(req);\n\n        if (json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n        ctx.ui?.success?.(\n          `Dropped \"${res.indexId}\" — removed ${res.droppedChunks} vector(s), ${res.droppedFiles} doc(s)`,\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/explore.d.ts

@@ -0,0 +1,26 @@
+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;
+    task: string;
+    indexId: string;
+    meta: {
+        requestId: string;
+        timingMs: number;
+        filesTouched: number;
+        spread: number;
+    } & {
+        [k: string]: unknown;
+    };
+    summary: string;
+    files: {
+        file: string;
+        lines: [number, number];
+        matchedBy: "lexical" | "semantic" | "both";
+        stale: boolean;
+        why: string;
+    }[];
+}>;
+
+export { _default as default };

package/dist/cli/commands/explore.js

@@ -0,0 +1,96 @@
+import { defineCommand, handleError, useVectorStore, useEmbeddings, useStorage, useCache, useLLM, useLogger, useConfig } from '@kb-labs/sdk';
+import { ExploreRequestSchema, resolveMindConfig } from '@kb-labs/mind-contracts';
+import { createMind } from '@kb-labs/mind-core';
+
+// src/cli/commands/explore.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/explore.ts
+var explore_default = defineCommand({
+  id: "mind:explore",
+  description: "Task-orientation map \u2014 where to start and how involved a task looks",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const json = flags.format === "json" || flags.json;
+      try {
+        const req = ExploreRequestSchema.parse({
+          task: flags.task,
+          indexId: flags.index,
+          limit: flags.limit
+        });
+        const mind = await buildMind(ctx.cwd);
+        const res = await mind.explore(req);
+        if (json) {
+          ctx.ui?.json?.(res);
+          return { exitCode: 0, result: res };
+        }
+        if (res.files.length === 0) {
+          ctx.ui?.warn?.(`No relevant files in index "${res.indexId}"`);
+        } else {
+          ctx.ui?.success?.(
+            `${res.files.length} file(s) across ${res.meta.spread} dir(s) \u2014 confidence ${res.confidence.toFixed(2)}`,
+            {
+              sections: [
+                ...res.summary ? [{ header: "Orientation", items: [res.summary] }] : [],
+                {
+                  header: `Index "${res.indexId}"`,
+                  items: res.files.map((f) => {
+                    const loc = `${f.file}:${f.lines[0]}-${f.lines[1]}`;
+                    const tags = `[${f.matchedBy}${f.stale ? ", stale" : ""}]`;
+                    return `${loc} ${tags}
+    ${f.why}`;
+                  })
+                }
+              ]
+            }
+          );
+        }
+        return { exitCode: 0, result: res };
+      } catch (err) {
+        handleError(ctx, err, json);
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { explore_default as default };
+//# sourceMappingURL=explore.js.map
+//# sourceMappingURL=explore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/platform.ts","../../../src/cli/commands/explore.ts"],"names":[],"mappings":"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","file":"explore.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 { ExploreRequestSchema, type ExploreFlags, type ExploreResponse } from '@kb-labs/mind-contracts';\nimport { buildMind } from '../../platform';\n\ntype ExploreResult = { exitCode: number; result?: ExploreResponse };\n\nexport default defineCommand<unknown, CLIInput<ExploreFlags>, ExploreResponse>({\n  id: 'mind:explore',\n  description: 'Task-orientation map — where to start and how involved a task looks',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<ExploreFlags>): Promise<ExploreResult> {\n      const { flags } = input;\n      const json = flags.format === 'json' || flags.json;\n      try {\n        const req = ExploreRequestSchema.parse({\n          task: flags.task,\n          indexId: flags.index,\n          limit: flags.limit,\n        });\n\n        const mind = await buildMind(ctx.cwd);\n        const res = await mind.explore(req);\n\n        if (json) {\n          ctx.ui?.json?.(res);\n          return { exitCode: 0, result: res };\n        }\n        if (res.files.length === 0) {\n          ctx.ui?.warn?.(`No relevant files in index \"${res.indexId}\"`);\n        } else {\n          ctx.ui?.success?.(\n            `${res.files.length} file(s) across ${res.meta.spread} dir(s) — confidence ${res.confidence.toFixed(2)}`,\n            {\n              sections: [\n                ...(res.summary ? [{ header: 'Orientation', items: [res.summary] }] : []),\n                {\n                  header: `Index \"${res.indexId}\"`,\n                  items: res.files.map((f) => {\n                    const loc = `${f.file}:${f.lines[0]}-${f.lines[1]}`;\n                    const tags = `[${f.matchedBy}${f.stale ? ', stale' : ''}]`;\n                    return `${loc} ${tags}\\n    ${f.why}`;\n                  }),\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/index.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 };