ownsearch 0.1.2 → 0.1.3

package/README.md

@@ -2,9 +2,9 @@
 
 **ownsearch** is a local search layer for agents.
 
-It indexes approved folders into a local Qdrant store, exposes retrieval through an MCP server, and lets your agents search private knowledge without a hosted search service.
+It indexes approved folders into a local Qdrant vector store, exposes retrieval through an MCP server, and gives agents grounded access to private knowledge without requiring a hosted search service.
 
-V1 is intentionally text-first: simple, reliable local retrieval for docs, code, and PDFs. Over time, **ownsearch** will expand to support multimodal files and data, including images, audio, video, and richer cross-modal search workflows.
+V1 is intentionally text-first: reliable local retrieval for documentation, code, and extracted PDF text. Future versions are intended to expand into multimodal indexing and search for images, audio, video, and richer document workflows.
 
 ## What it does
 
@@ -12,7 +12,7 @@ V1 is intentionally text-first: simple, reliable local retrieval for docs, code,
 - Chunks and embeds supported files with Gemini
 - Supports incremental reindexing for changed and deleted files
 - Exposes search and context retrieval through MCP
-- Lets agents retrieve ranked hits, exact chunks, or grounded context bundles
+- Lets agents retrieve ranked hits, exact chunks, or bundled grounded context
 
 ## V1 scope
 
@@ -28,9 +28,11 @@ Install `ownsearch` globally:
 
 ```bash
 npm install -g ownsearch
+```
 
 Set it up, index a folder, and start searching:
 
+```bash
 ownsearch setup
 ownsearch doctor
 ownsearch index ./docs --name docs
@@ -38,48 +40,95 @@ ownsearch list-roots
 ownsearch search "what is this repo about?" --limit 5
 ownsearch search-context "what is this repo about?" --limit 8 --max-chars 12000
 ownsearch serve-mcp
+```
+
+On first run, `ownsearch setup` can prompt for `GEMINI_API_KEY` and save it to `~/.ownsearch/.env`, which is then reused automatically by later CLI and MCP runs.
 
-To connect ownsearch to a supported agent, print a config snippet for your client:
+To connect `ownsearch` to a supported agent, print a config snippet for your client:
 
+```bash
 ownsearch print-agent-config codex
 ownsearch print-agent-config claude-desktop
 ownsearch print-agent-config cursor
-Local development
+```
+
+## Local development
 
-If you want to run ownsearch from source while developing locally:
+If you want to run `ownsearch` from source while developing locally:
 
+```bash
 npm install
 npm run build
 node dist/cli.js setup
 node dist/cli.js index ./docs --name docs
 node dist/cli.js search "what is this repo about?" --limit 5
 node dist/cli.js serve-mcp
+```
+
+## CLI commands
+
+- `ownsearch setup`
+  Starts or reconnects to the local Qdrant Docker container, creates local config, and can save `GEMINI_API_KEY` into `~/.ownsearch/.env`.
+- `ownsearch doctor`
+  Checks config, Gemini key presence, Qdrant connectivity, and active collection settings.
+- `ownsearch index <folder> --name <name>`
+  Indexes a folder incrementally into the local vector collection.
+- `ownsearch list-roots`
+  Lists approved indexed roots.
+- `ownsearch search "<query>"`
+  Returns ranked search hits from the vector store.
+- `ownsearch search-context "<query>"`
+  Returns a compact grounded context bundle for agents.
+- `ownsearch delete-root <rootId>`
+  Removes a root from config and deletes its vectors from Qdrant.
+- `ownsearch store-status`
+  Shows collection status and vector configuration.
+- `ownsearch serve-mcp`
+  Starts the stdio MCP server.
+- `ownsearch print-agent-config <agent>`
+  Prints an MCP config snippet for supported agents.
 
 ## MCP tools
 
-* `index_path`
-* `search`
-* `search_context`
-* `get_chunks`
-* `list_roots`
-* `delete_root`
-* `store_status`
+The MCP server currently exposes:
+
+- `index_path`
+- `search`
+- `search_context`
+- `get_chunks`
+- `list_roots`
+- `delete_root`
+- `store_status`
+
+Recommended agent flow:
+
+1. Call `search_context` for fast grounded retrieval.
+2. If more precision is needed, call `search`.
+3. Use `get_chunks` on selected hit IDs for exact source text.
 
 ## Notes
 
-* Config is stored in `~/.ownsearch/config.json`
-* Qdrant runs locally in Docker as `ownsearch-qdrant`
-* `GEMINI_API_KEY` must be available in the environment or `.env`
+- Config is stored in `~/.ownsearch/config.json`
+- Shared CLI and MCP secrets can be stored in `~/.ownsearch/.env`
+- Qdrant runs locally in Docker as `ownsearch-qdrant`
+- `GEMINI_API_KEY` may come from the shell environment, the current working directory `.env`, or `~/.ownsearch/.env`
+- Node.js `20+` is required
 
 ## Roadmap
 
 Planned after the text-first v1:
 
-* richer document extraction
-* better reranking and deduplication
-* watch mode for automatic reindexing
-* HTTP MCP transport
-* multimodal indexing for images, audio, video, and richer document formats
+- richer document extraction
+- better reranking and deduplication
+- watch mode for automatic reindexing
+- HTTP MCP transport
+- multimodal indexing and search for:
+  - images
+  - audio
+  - video
+  - richer document formats
+
+The multimodal phase will require careful collection migration because Gemini text and multimodal embedding spaces are not interchangeable across model families.
 
 ## License
 

package/dist/{chunk-NLETDGQ5.js → chunk-LGXCBOO4.js}

@@ -25,9 +25,11 @@ function buildContextBundle(query, hits, maxChars = 12e3) {
 }
 
 // src/config.ts
+import fsSync from "fs";
 import fs from "fs/promises";
 import os from "os";
 import path2 from "path";
+import dotenv from "dotenv";
 
 // src/constants.ts
 var CONFIG_DIR_NAME = ".ownsearch";
@@ -141,9 +143,25 @@ function getConfigDir() {
 function getConfigPath() {
   return path2.join(getConfigDir(), CONFIG_FILE_NAME);
 }
+function getEnvPath() {
+  return path2.join(getConfigDir(), ".env");
+}
 async function ensureConfigDir() {
   await fs.mkdir(getConfigDir(), { recursive: true });
 }
+function loadOwnSearchEnv() {
+  for (const envPath of [path2.resolve(process.cwd(), ".env"), getEnvPath()]) {
+    if (!fsSync.existsSync(envPath)) {
+      continue;
+    }
+    const parsed = dotenv.parse(fsSync.readFileSync(envPath, "utf8"));
+    for (const [key, value] of Object.entries(parsed)) {
+      if (process.env[key] === void 0) {
+        process.env[key] = value;
+      }
+    }
+  }
+}
 async function loadConfig() {
   await ensureConfigDir();
   const configPath = getConfigPath();
@@ -171,6 +189,11 @@ async function saveConfig(config) {
   await fs.writeFile(getConfigPath(), `${JSON.stringify(config, null, 2)}
 `, "utf8");
 }
+async function saveGeminiApiKey(apiKey) {
+  await ensureConfigDir();
+  await fs.writeFile(getEnvPath(), `GEMINI_API_KEY=${apiKey.trim()}
+`, "utf8");
+}
 function createRootDefinition(rootPath, name) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const rootName = name?.trim() || path2.basename(rootPath);
@@ -715,7 +738,10 @@ async function indexPath(rootPath, options = {}) {
 export {
   buildContextBundle,
   getConfigPath,
+  getEnvPath,
+  loadOwnSearchEnv,
   loadConfig,
+  saveGeminiApiKey,
   deleteRootDefinition,
   findRoot,
   listRoots,

package/dist/cli.js

@@ -7,15 +7,18 @@ import {
   embedQuery,
   findRoot,
   getConfigPath,
+  getEnvPath,
   indexPath,
   listRoots,
-  loadConfig
-} from "./chunk-NLETDGQ5.js";
+  loadConfig,
+  loadOwnSearchEnv,
+  saveGeminiApiKey
+} from "./chunk-LGXCBOO4.js";
 
 // src/cli.ts
-import "dotenv/config";
 import path from "path";
 import { spawn } from "child_process";
+import readline from "readline/promises";
 import { fileURLToPath } from "url";
 import { Command } from "commander";
 
@@ -61,23 +64,50 @@ async function ensureQdrantDocker() {
 }
 
 // src/cli.ts
+loadOwnSearchEnv();
 var program = new Command();
+var PACKAGE_NAME = "ownsearch";
 function requireGeminiKey() {
   if (!process.env.GEMINI_API_KEY) {
     throw new OwnSearchError("Set GEMINI_API_KEY before running OwnSearch.");
   }
 }
+async function promptForGeminiKey() {
+  if (process.env.GEMINI_API_KEY || !process.stdin.isTTY || !process.stdout.isTTY) {
+    return Boolean(process.env.GEMINI_API_KEY);
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    const apiKey = (await rl.question(
+      `Enter GEMINI_API_KEY to save in ${getEnvPath()} (leave blank to skip): `
+    )).trim();
+    if (!apiKey) {
+      return false;
+    }
+    await saveGeminiApiKey(apiKey);
+    process.env.GEMINI_API_KEY = apiKey;
+    return true;
+  } finally {
+    rl.close();
+  }
+}
 program.name("ownsearch").description("Gemini-powered local search MCP server backed by Qdrant.").version("0.1.0");
 program.command("setup").description("Create config and start a local Qdrant Docker container.").action(async () => {
   const config = await loadConfig();
   const result = await ensureQdrantDocker();
+  const geminiApiKeyPresent = await promptForGeminiKey();
   console.log(JSON.stringify({
     configPath: getConfigPath(),
+    envPath: getEnvPath(),
     qdrantUrl: config.qdrantUrl,
-    qdrantStarted: result.started
+    qdrantStarted: result.started,
+    geminiApiKeyPresent
   }, null, 2));
-  if (!process.env.GEMINI_API_KEY) {
-    console.log("GEMINI_API_KEY is not set. Indexing and search will require it later.");
+  if (!geminiApiKeyPresent) {
+    console.log(`GEMINI_API_KEY is not set. Re-run setup or add it to ${getEnvPath()} before indexing or search.`);
   }
 });
 program.command("index").argument("<folder>", "Folder path to index").option("-n, --name <name>", "Display name for the indexed root").option("--max-file-bytes <n>", "Override the file size limit for this run", (value) => Number(value)).description("Index a local folder into Qdrant using Gemini embeddings.").action(async (folder, options) => {
@@ -150,6 +180,7 @@ program.command("doctor").description("Check local prerequisites and package con
   }
   console.log(JSON.stringify({
     configPath: getConfigPath(),
+    envPath: getEnvPath(),
     geminiApiKeyPresent: Boolean(process.env.GEMINI_API_KEY),
     qdrantUrl: config.qdrantUrl,
     qdrantReachable,
@@ -176,7 +207,7 @@ program.command("serve-mcp").description("Start the stdio MCP server.").action(a
 program.command("print-agent-config").argument("<agent>", "codex | claude-desktop | cursor").description("Print an MCP config snippet for a supported agent.").action(async (agent) => {
   const config = {
     command: "npx",
-    args: ["-y", "ownsearch", "serve-mcp"],
+    args: ["-y", PACKAGE_NAME, "serve-mcp"],
     env: {
       GEMINI_API_KEY: "${GEMINI_API_KEY}"
     }

package/dist/mcp/server.js

@@ -7,14 +7,15 @@ import {
   embedQuery,
   findRoot,
   indexPath,
-  loadConfig
-} from "../chunk-NLETDGQ5.js";
+  loadConfig,
+  loadOwnSearchEnv
+} from "../chunk-LGXCBOO4.js";
 
 // src/mcp/server.ts
-import "dotenv/config";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+loadOwnSearchEnv();
 function asText(result) {
   return {
     content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ownsearch",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Text-first local document search MCP server backed by Gemini embeddings and Qdrant.",
   "type": "module",
   "bin": {
@@ -44,6 +44,7 @@
   },
   "dependencies": {
     "@google/genai": "^1.46.0",
+    "@grumppie/ownsearch": "^0.1.3",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@qdrant/js-client-rest": "^1.17.0",
     "commander": "^14.0.1",