bikky 0.3.13 → 0.4.0

package/CONTRIBUTING.md

@@ -0,0 +1,206 @@
+# Contributing to bikky
+
+Thanks for your interest in bikky! We welcome PRs of all sizes — from typo fixes to new daemon features. This document covers the practical bits: how the repo is laid out, how to run the tests, and what we look for in a contribution.
+
+## Repository layout
+
+bikky is a small monorepo:
+
+```
+.
+├── src/                  # Core CLI + MCP server + daemon (published as `bikky`)
+│   ├── cli/              # `bikky <subcommand>` entrypoints
+│   ├── daemon/           # Background workers: extraction, consolidation, staleness, …
+│   ├── mcp/              # MCP server (the surface AI agents call into)
+│   ├── prompts/          # Versioned LLM prompt registry
+│   └── llm/              # Provider adapters (OpenAI, Bedrock, Ollama, Portkey)
+│       ├── embedding/    #   embedding registry + providers
+│       └── inference/    #   chat-completion registry + providers
+└── packages/
+    └── ui/               # Local web UI (`bikky-ui`) — Hono server + React frontend
+        ├── src/lib/      #   - config, qdrant client, embeddings
+        ├── src/routes/   #   - REST API routes
+        └── app/          #   - React/Vite frontend
+```
+
+## Setup
+
+```bash
+git clone https://github.com/bikky-dev/bikky.git
+cd bikky
+npm install
+cd packages/ui && npm install && cd ../..
+```
+
+## Running the tests
+
+We use the Node.js built-in test runner ([`node:test`](https://nodejs.org/api/test.html)) — no Jest, no Vitest, no extra dependencies.
+
+```bash
+# Core (CLI, daemon, MCP server) — 300+ tests
+npm test
+
+# UI server + libraries — 50+ tests
+cd packages/ui && npm test
+```
+
+Both packages compile TypeScript into `dist/` first and then run the compiled `*.test.js` files. The UI test suite uses `--test-isolation=process --test-concurrency=1` because several tests share `~/.bikky/config.json` on the developer's machine; running them in isolation avoids flakiness.
+
+> **Note on `~/.bikky/config.json`** — UI tests back up your real config in `before()` and restore it in `after()`. If a test crashes mid-run the file *should* survive, but if you ever see odd behaviour after a failed test run, just delete the file and re-run `bikky setup`.
+
+### What we test
+
+We aim for **focused, fast unit tests** that lock in behaviour without being a maintenance tax:
+
+- Pure functions (filter builders, hashers, parsers) — exhaustive cases.
+- Stateful modules (config loaders, lifecycle/PID, daemons) — happy path + a couple of failure modes.
+- Network clients (Qdrant, embeddings, LLM providers) — mock `globalThis.fetch` and assert on the request, never call a real backend.
+- HTTP routes (Hono) — exercise via `app.fetch(new Request(...))` against the real router with mocked underlying calls.
+
+We deliberately **do not** test:
+
+- LLM prompt quality or extraction accuracy. Those live in the separate [`bikky-evals`](https://github.com/bikky-dev/bikky-evals) repo, which uses DeepEval for prompt-level scoring.
+- Implementation details (private function internals, exact log strings) — these change often and tests that pin them slow contributors down.
+- The React frontend — the testable surface there is small; we rely on type-checking and manual smoke tests.
+
+### Adding a new test
+
+Tests live alongside the source as `*.test.ts`:
+
+```
+src/foo.ts       # source
+src/foo.test.ts  # tests
+```
+
+Use the [`node:test`](https://nodejs.org/api/test.html) `describe/it/before/after` API and `node:assert/strict`. For mocking, prefer **dependency injection** (e.g. the `StaleDeps` pattern in `src/daemon/staleness.ts`) over module mocking — it keeps tests deterministic and the production code easier to reason about.
+
+Good references for new tests:
+
+| Pattern                          | Reference                              |
+|----------------------------------|----------------------------------------|
+| Filesystem with backup/restore   | `src/lifecycle.test.ts`                |
+| Temp dir with `mkdtemp`          | `src/logger.test.ts`                   |
+| Env-based path override          | `src/llm/telemetry.test.ts`            |
+| Dependency injection for daemons | `src/daemon/staleness.test.ts`         |
+| Mocking `globalThis.fetch`       | `src/mcp/api.test.ts`, `packages/ui/src/lib/qdrant.test.ts` |
+| Hono route via `app.fetch`       | `packages/ui/src/routes/memory.test.ts` |
+
+### Integration tests (opt-in, real Qdrant)
+
+The default `npm test` mocks every external call. We also ship one **opt-in** end-to-end smoke test that talks to a real Qdrant instance (Cloud, local Docker, or self-hosted) and a real embedding provider — it's the only thing that catches filter-shape rejections, payload-index mismatches, vector-dimension drift, and whether the dedup similarity thresholds (`THRESHOLD_DUPLICATE`, `THRESHOLD_RELATED`) actually correspond to near-duplicates against your embedding model.
+
+```bash
+# Uses your existing ~/.bikky/config.json + QDRANT_URL (and QDRANT_API_KEY if your Qdrant requires it).
+BIKKY_INTEGRATION=1 npm run test:integration
+```
+
+What it does:
+
+1. Creates a throwaway collection named `bikky-it-<short-uuid>` with the real payload indexes.
+2. Exercises `memory_store` (insert, exact-dup, near-duplicate paraphrase), `memory_recall`, `memory_entity`, and `memory_forget` against live Qdrant + your real embeddings.
+3. Drops the collection in `after()` regardless of pass/fail.
+
+Cost is negligible — a handful of small embedding calls per run (≈ $0.0001 on OpenAI's `text-embedding-3-small`, free on Ollama). Files end in `.itest.ts` so the default `*.test.js` glob never picks them up.
+
+If the near-duplicate paraphrase doesn't reinforce on your embedding model, the test logs the actual similarity score so you can re-tune `THRESHOLD_DUPLICATE` rather than failing outright.
+
+## Adding an embedding or LLM provider
+
+The most common contribution is **adding a new embedding or LLM provider**. Each provider is a single file. The registry dispatches by `provider.name`, so no central edits are required beyond adding one import line to the barrel.
+
+### Embedding provider
+
+1. Create `src/llm/embedding/providers/<name>.ts`:
+
+   ```ts
+   import {
+     registerEmbeddingProvider,
+     type EmbeddingProvider,
+     type ResolvedEmbeddingConfig,
+   } from "../registry.js";
+
+   export const myProvider: EmbeddingProvider = {
+     name: "myprovider",
+     label: "My Provider",
+     browserCompatible: true, // false if it needs a server-only SDK
+     defaults: {
+       model: "default-model",
+       dimensions: 1024,
+       baseUrl: "https://api.example.com", // omit if SDK-only
+     },
+     async embed(text, cfg) {
+       // cfg.{model,baseUrl,apiKey,extra} are pre-resolved
+       const resp = await fetch(`${cfg.baseUrl}/v1/embeddings`, { /* … */ });
+       // throw on programmer error; return number[] on success
+       return [/* embedding vector */];
+     },
+   };
+
+   registerEmbeddingProvider(myProvider);
+   ```
+
+2. Add a side-effect import in `src/llm/embedding/providers/index.ts`:
+
+   ```ts
+   import "./myprovider.js";
+   ```
+
+3. Add a small unit test next to your provider (`<name>.test.ts`). Mock
+   `globalThis.fetch` (see `ollama.test.ts` for the pattern). Cover at minimum:
+   - success path (verifies URL, headers, body shape)
+   - non-OK response handling
+   - any provider-specific behaviour (auth, extra headers, fallback fields)
+
+4. If your provider is browser-friendly, mirror it under
+   `packages/ui/src/lib/embedding/providers/<name>.ts` so the UI can use it.
+
+5. Configure it in `~/.bikky/config.json`:
+
+   ```json
+   {
+     "embedding": {
+       "provider": "myprovider",
+       "model": "my-model",
+       "api_key": "…",
+       "extra": { "any-key": "any-value" }
+     }
+   }
+   ```
+
+   Or via env: `BIKKY_EMBEDDING_EXTRA_<KEY>=value` flows into `extra`.
+
+### Inference (LLM) provider
+
+Same pattern, under `src/llm/inference/providers/`. The interface is
+`InferenceProvider` (see `src/llm/inference/types.ts`), the key method is
+`chat(opts, cfg, log)`, and providers should **return `null`** on recoverable
+errors (HTTP error, missing key, network failure) so the orchestrator can fall
+back to `cfg.fallback` if configured. Throw only for programmer errors.
+
+Configure a fallback chain via `llm.fallback_provider` in config (or
+`LLM_FALLBACK_PROVIDER` env).
+
+## Submitting changes
+
+1. **Open an issue first** for non-trivial changes so we can align on the approach.
+2. **Branch** from `main` (`git checkout -b your-feature-name`).
+3. **Run the tests** in both packages before pushing.
+4. **Open a PR** referencing the issue (`Closes #123`). CI will re-run tests on push.
+5. We aim to review within a few business days — ping the issue if it goes quiet.
+
+## Style
+
+- TypeScript strict mode is on; no `any` unless interfacing with external SDK types (use a focused local interface to constrain the surface area).
+- We prefer small, pure functions and clear module boundaries to elaborate abstractions.
+- Tests live next to the source they cover (`foo.ts` + `foo.test.ts`).
+- Providers must not call `process.exit`, log to stdout, or modify global state beyond their own module-scope cache.
+- Heavy SDKs (e.g. `@aws-sdk/*`) **must be `await import(...)`-loaded inside the provider's `embed`/`chat`** so users on lighter providers don't pay the bundle cost.
+- Comments explain *why*, not *what* — the code shows the *what*.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the project's [AGPL-3.0-or-later](LICENSE) license.
+
+## Code of conduct
+
+Be kind. We follow the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).

package/README.md

@@ -1,25 +1,25 @@
 <h1 align="center">bikky</h1>
 
-<p align="center"><b>Persistent memory for AI coding agents — for teams, and for solo power users.</b></p>
+<p align="center"><b>Persistent memory for AI coding agents — built for teams and multi-agent engineering workflows.</b></p>
 
-bikky gives AI coding agents (GitHub Copilot, Claude Code, Cursor, and other MCP clients) long-term memory that persists across sessions, across tools, and across your whole team. Whether you're a team that wants every engineer's agent to start from the same knowledge base, or a solo power dev running a dozen agentic sessions a day, bikky captures what's learned *during* sessions so future sessions start smarter.
+bikky gives AI coding agents (GitHub Copilot, Claude Code, Cursor, and other MCP clients) long-term memory that persists across sessions, across tools, and across your whole team. When multiple engineers, agents, or repos need to build on the same knowledge base, bikky captures what's learned *during* sessions so future sessions start smarter.
 
 ### Who it's for
 
 - 👥 **Teams & software factories** — What one engineer's agent learns today, every agent on the team can recall tomorrow. Shared memory turns institutional knowledge into something queryable instead of tribal — onboarding accelerates, conventions stop drifting, and the same lesson never gets re-learned twice.
-- 🧑‍💻 **Solo AI power devs** — You run multiple Cursor / Claude Code / Copilot sessions every day and you're tired of re-explaining the codebase, the conventions, and last week's decisions to each new agent. bikky remembers across every session and every tool.
+- 🤖 **Multi-agent engineering workflows** — Multiple Cursor / Claude Code / Copilot sessions can share codebase context, conventions, and recent decisions instead of re-learning them from scratch.
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/bikky@latest/docs/diagrams/team-memory.svg" alt="Memory — facts flow from individual sessions into a self-curating knowledge store, shared across your team (or kept just for you)" width="720" />
+  <img src="https://cdn.jsdelivr.net/npm/bikky@latest/docs/diagrams/team-memory.svg" alt="Memory — facts flow from individual sessions into a self-curating knowledge store shared across your team" width="720" />
 </p>
 
-<p align="center"><i>Knowledge flows from every session into a store that curates itself over time — deduplicating, distilling, and decaying stale facts — so every future session starts smarter. Share it across a team, or keep it solo.</i></p>
+<p align="center"><i>Knowledge flows from every session into a store that curates itself over time — deduplicating, distilling, and decaying stale facts — so every future session starts smarter across the team.</i></p>
 
 ---
 
 ### The problem
 
-The most valuable things you and your agents learn — why a config value exists, which deploy step matters, what broke last quarter, the convention you settled on yesterday — happen *during* sessions. And then they vanish when the session closes. Whether you're a team — where knowledge lives in heads, chat threads, and closed PRs, and every new engineer's agent has to learn it from scratch — or a solo power dev juggling dozens of agentic sessions a day across multiple tools that don't remember each other, it's the same wall. Hand-written docs drift the moment they're published.
+The most valuable things you and your agents learn — why a config value exists, which deploy step matters, what broke last quarter, the convention you settled on yesterday — happen *during* sessions. And then they vanish when the session closes. Across teams, repos, and tools, knowledge still lives in heads, chat threads, and closed PRs, and every new agent session has to learn it from scratch. Hand-written docs drift the moment they're published.
 
 ### How bikky solves it
 
@@ -30,6 +30,7 @@ bikky gives your agent memory tools and runs a small background service after `b
 - **Recall** — Every new session, yours or a teammate's, recalls from the same store via semantic search.
 - **Curate** — bikky merges duplicates, fades stale facts, resolves contradictions, distills recurring patterns, and builds an entity graph over time.
 - **Compound** — Session 50 is dramatically better than session 1 because memory accumulates.
+- **Route** — Optionally keep team, client, or environment-specific memory in separate Qdrant destinations from one install. See [separate memory stores](#optional-separate-memory-stores).
 
 Subtypes keep recall precise without making setup harder:
 
@@ -42,7 +43,7 @@ Subtypes keep recall precise without making setup harder:
 
 ## Quick start
 
-This quick start uses **local Qdrant + hosted models**: Qdrant runs on your machine, while hosted embeddings and LLM calls provide strong extraction and recall quality without running local LLMs.
+This is the fastest path to a working memory store: Qdrant runs locally, while hosted embeddings and LLM calls provide strong extraction and recall quality without running local models.
 
 ```bash
 # 1. Pull and run Qdrant (vector store)
@@ -82,9 +83,9 @@ Restart your editor. The memory tools appear automatically in supported MCP clie
 bikky status           # confirms Qdrant, embeddings, daemon, and UI health
 ```
 
-That's it. You can keep Qdrant local forever, or move the vector store to Qdrant Cloud later.
+That's it. You can keep Qdrant local forever, or move the vector store to Qdrant Cloud later for a shared team setup.
 
-For 100% local and account-free setup, use the [local and free config](docs/config/local.md). It is best for private testing rather than long-term team use, and extraction, embedding, and curation performance depends on the local models and hardware you run.
+For other deployment shapes — fully hosted, 100% local, or hosted Qdrant with local models — see [Setup options](#setup-options).
 
 ---
 
@@ -104,24 +105,67 @@ bikky supports four common setup shapes. Pick based on where you want Qdrant to
 
 Both `embedding.provider` and `llm.provider` accept the same values: `ollama`, `openai`, `bedrock`, or `portkey`.
 
+> ⚠️ **Qdrant Cloud free tier does not include automatic backups.** Deleted collections cannot be recovered. If your memory data is valuable, use a paid Qdrant Cloud plan (which includes daily backups), run Qdrant locally with your own backup strategy, or periodically export snapshots via the [Qdrant snapshots API](https://qdrant.tech/documentation/concepts/snapshots/).
+
 ### Choose a setup
 
 | Setup                            | Best for                                                       | Config                                                                    |
 | -------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| **Fully hosted**                 | Best performance and teams; managed vector storage and models  | [Fully hosted config](docs/config/fully-hosted.md)                        |
-| **Local Qdrant + hosted models** | Local vector storage with hosted extraction and embedding      | [Hosted models config](docs/config/hosted-models.md)                      |
-| **Local and free**               | Private/free testing; quality depends on local models          | [Local config guide](docs/config/local.md)                                |
-| **Hosted Qdrant + local Ollama** | Shared vector storage while keeping model calls local          | [Hosted Qdrant + local models](docs/config/hosted-qdrant-local-models.md) |
+| **Fully hosted**                 | Best performance and teams; managed vector storage and models  | [Fully hosted config][fully-hosted-config]                              |
+| **Local Qdrant + hosted models** | Local vector storage with hosted extraction and embedding      | [Hosted models config][hosted-models-config]                            |
+| **Local and free**               | Local evaluation; quality depends on local models              | [Local config guide][local-config]                                      |
+| **Hosted Qdrant + local Ollama** | Shared vector storage while keeping model calls local          | [Hosted Qdrant + local models][hosted-qdrant-local-models-config]       |
+
+### Configuration basics
+
+Pick the setup guide above for the copy-paste config. All setup shapes use the same three building blocks:
 
-### Configure
+- **Qdrant** — where vectors and memory payloads are stored.
+- **Embeddings** — how facts become searchable vectors.
+- **LLM** — how session transcripts are extracted, curated, and distilled.
 
-Pick the setup guide above for the copy-paste config. Config lives at `~/.bikky/config.json`, and you can also set `QDRANT_URL` and `QDRANT_API_KEY` as environment variables.
+Config lives at `~/.bikky/config.json`, or at `BIKKY_HOME/config.json` when `BIKKY_HOME` is set. You can keep credentials out of the file with environment variables such as `QDRANT_URL`, `QDRANT_API_KEY`, and provider API keys.
 
 For hosted models, custom providers, multiple profiles, or advanced tuning, use the full configuration guide.
 
-> 📖 **Full configuration guide:** [docs/configuration.md](docs/configuration.md)
+> 📖 **Full configuration guide:** [docs/configuration.md][configuration-guide]
 >
-> 🛠 Want to add a new embedding or LLM provider (Vertex, OpenRouter, etc.)? See **[CONTRIBUTING.md](CONTRIBUTING.md)** — it's a single-file change.
+> 🛠 Want to add a new embedding or LLM provider (Vertex, OpenRouter, etc.)? See **[CONTRIBUTING.md][contributing]** — it's a single-file change.
+
+#### Optional: separate memory stores
+
+Most installs use one Qdrant destination. If you need clean separation later, replace the single `qdrant_url` / `collection` fields with named `destinations[]`:
+
+```jsonc
+{
+  "destinations": [
+    {
+      "name": "platform",
+      "qdrant_url": "https://platform.cloud.qdrant.io:6333",
+      "qdrant_api_key": "...",
+      "collection": "bikky-platform",
+      "default": true
+    },
+    {
+      "name": "client-a",
+      "qdrant_url": "https://client-a.cloud.qdrant.io:6333",
+      "qdrant_api_key": "...",
+      "collection": "bikky-client-a"
+    }
+  ]
+}
+```
+
+That is enough for explicit selection in the UI and tools. Add routing rules only when you want automatic placement by cwd, entity, content, or metadata. Existing single-Qdrant configs continue to work.
+
+> 📖 **Details:** [multi-destination configuration](docs/configuration.md#multi-destination-routing)
+
+[fully-hosted-config]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/config/fully-hosted.md
+[hosted-models-config]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/config/hosted-models.md
+[local-config]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/config/local.md
+[hosted-qdrant-local-models-config]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/config/hosted-qdrant-local-models.md
+[configuration-guide]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/configuration.md
+[contributing]: https://cdn.jsdelivr.net/npm/bikky@latest/CONTRIBUTING.md
 
 ---
 
@@ -137,17 +181,17 @@ bikky-ui              # opens http://localhost:1422
 ```
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/bikky@latest/docs/screenshots/dashboard.png" alt="Dashboard — overview stats, category breakdown, recent facts" width="720" />
+  <img src="docs/screenshots/dashboard.png" alt="Dashboard — overview stats, category breakdown, recent facts" width="720" />
 </p>
 <p align="center"><i>Dashboard — memory stats, category breakdown, and recent facts at a glance</i></p>
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/bikky@latest/docs/screenshots/memory.png" alt="Memory browser — search, filter, and browse all stored facts" width="720" />
+  <img src="docs/screenshots/memory.png" alt="Memory browser — search, filter, and browse all stored facts" width="720" />
 </p>
 <p align="center"><i>Memory browser — search, filter by category/kind/source, and browse all stored facts</i></p>
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/bikky@latest/docs/screenshots/graph.png" alt="Entity graph — interactive visualization of entity relationships" width="720" />
+  <img src="docs/screenshots/graph.png" alt="Entity graph — interactive visualization of entity relationships" width="720" />
 </p>
 <p align="center"><i>Entity graph — interactive visualization of how concepts, people, and services relate</i></p>
 

package/dist/config.d.ts

@@ -76,11 +76,48 @@ export interface WatcherConfig {
         path: string;
     };
 }
+/**
+ * One Qdrant routing target. Each destination is fully self-contained: its own
+ * URL, API key, collection name, and match rules. All fields in `match` are
+ * arrays of regex strings; OR semantics within a destination's match block,
+ * first-match-wins across destinations.
+ */
+export interface DestinationMatch {
+    /** Match against `process.cwd()`. */
+    cwd?: string[];
+    /** Match against any of the input `entities`. */
+    entity?: string[];
+    /** Match against the input `content`. */
+    content?: string[];
+    /** Per-key match against the input `metadata`. */
+    metadata?: Record<string, string[]>;
+}
+export interface Destination {
+    /** Stable, unique name. Used as the `destination` override on tool calls. */
+    name: string;
+    qdrant_url: string;
+    qdrant_api_key: string | null;
+    collection: string;
+    /** Marks this destination as the fallback when no rule matches. */
+    default?: boolean;
+    /** Routing rules. Omit for a destination that is only reachable by override. */
+    match?: DestinationMatch;
+}
 export interface BikkyConfig {
+    /**
+     * Top-level Qdrant fields. When `destinations` is empty, a single default
+     * destination is synthesized from these — keeps single-Qdrant configs
+     * working without changes.
+     */
     qdrant_url: string | null;
     qdrant_api_key: string | null;
     collection: string;
-    default_workspace: string | null;
+    /**
+     * One or more Qdrant routing targets. Memory operations resolve to a
+     * destination via override → cwd/entity/content/metadata regex match →
+     * default flag → first entry.
+     */
+    destinations: Destination[];
     aws_profile: string | null;
     embedding: EmbeddingConfig;
     llm: LLMConfig;
@@ -107,6 +144,17 @@ export declare function validateConfigObject(raw: unknown): ConfigIssue[];
 export declare function inspectConfigFile(configPath?: string): ConfigFileDiagnostics;
 export declare function getActiveConfigEnvOverrides(env?: NodeJS.ProcessEnv): string[];
 export declare function loadConfig(): BikkyConfig;
+/**
+ * Resolve the effective list of destinations from the loaded config.
+ *
+ * - If `destinations` is non-empty, return as-is.
+ * - Otherwise synthesize a single fallback destination from the top-level
+ *   `qdrant_url` / `qdrant_api_key` / `collection` so existing single-Qdrant
+ *   configs keep working without changes.
+ * - If neither is configured, returns an empty array — callers should treat
+ *   that as "Qdrant not configured" the same way they did before.
+ */
+export declare function getEffectiveDestinations(config?: BikkyConfig): Destination[];
 /** Save config to disk (used by setup command). */
 export declare function saveConfig(config: BikkyConfig): void;
 /** Reset cached config (for testing). */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -28,7 +28,7 @@ const DEFAULTS = {
     qdrant_url: null,
     qdrant_api_key: null,
     collection: "bikky",
-    default_workspace: null,
+    destinations: [],
     aws_profile: null,
     embedding: {
         provider: "ollama",
@@ -176,11 +176,26 @@ const identityConfigFileSchema = z.object({
     actor_id: z.string().nullable().optional(),
     actor_label: z.string().nullable().optional(),
 }).passthrough();
+const regexArrayField = z.array(z.string()).optional();
+const destinationMatchSchema = z.object({
+    cwd: regexArrayField,
+    entity: regexArrayField,
+    content: regexArrayField,
+    metadata: z.record(z.array(z.string())).optional(),
+}).passthrough();
+const destinationFileSchema = z.object({
+    name: z.string().min(1),
+    qdrant_url: z.string().min(1),
+    qdrant_api_key: z.string().nullable().optional(),
+    collection: z.string().min(1),
+    default: z.boolean().optional(),
+    match: destinationMatchSchema.optional(),
+}).passthrough();
 const configFileSchema = z.object({
     qdrant_url: z.string().nullable().optional(),
     qdrant_api_key: z.string().nullable().optional(),
     collection: z.string().optional(),
-    default_workspace: z.string().nullable().optional(),
+    destinations: z.array(destinationFileSchema).optional(),
     aws_profile: z.string().nullable().optional(),
     embedding: embeddingConfigFileSchema.optional(),
     llm: llmConfigFileSchema.optional(),
@@ -267,6 +282,87 @@ export function validateConfigObject(raw) {
         });
     }
     validateUrlLike(raw.qdrant_url, "qdrant_url", issues);
+    // Destinations validation
+    if (Array.isArray(raw.destinations)) {
+        const seenNames = new Set();
+        let defaultCount = 0;
+        raw.destinations.forEach((entry, idx) => {
+            const base = `destinations[${idx}]`;
+            if (!isObject(entry)) {
+                issues.push({ severity: "error", path: base, message: "must be an object" });
+                return;
+            }
+            const name = entry.name;
+            if (typeof name === "string" && name.trim() !== "") {
+                if (seenNames.has(name)) {
+                    issues.push({ severity: "error", path: `${base}.name`, message: `duplicate destination name '${name}'` });
+                }
+                seenNames.add(name);
+            }
+            validateUrlLike(entry.qdrant_url, `${base}.qdrant_url`, issues);
+            if (typeof entry.collection === "string" && entry.collection.trim() === "") {
+                issues.push({ severity: "error", path: `${base}.collection`, message: "must not be empty" });
+            }
+            if (entry.default === true)
+                defaultCount++;
+            const match = childObject(entry, "match");
+            if (match) {
+                for (const field of ["cwd", "entity", "content"]) {
+                    const value = match[field];
+                    if (value === undefined)
+                        continue;
+                    if (!Array.isArray(value)) {
+                        issues.push({ severity: "error", path: `${base}.match.${field}`, message: "must be an array of regex strings" });
+                        continue;
+                    }
+                    value.forEach((pattern, pIdx) => {
+                        if (typeof pattern !== "string") {
+                            issues.push({ severity: "error", path: `${base}.match.${field}[${pIdx}]`, message: "must be a string" });
+                            return;
+                        }
+                        try {
+                            new RegExp(pattern);
+                        }
+                        catch (e) {
+                            issues.push({
+                                severity: "error",
+                                path: `${base}.match.${field}[${pIdx}]`,
+                                message: `invalid regex: ${e instanceof Error ? e.message : String(e)}`,
+                            });
+                        }
+                    });
+                }
+                const metadata = childObject(match, "metadata");
+                if (metadata) {
+                    for (const [key, value] of Object.entries(metadata)) {
+                        if (!Array.isArray(value)) {
+                            issues.push({ severity: "error", path: `${base}.match.metadata.${key}`, message: "must be an array of regex strings" });
+                            continue;
+                        }
+                        value.forEach((pattern, pIdx) => {
+                            if (typeof pattern !== "string") {
+                                issues.push({ severity: "error", path: `${base}.match.metadata.${key}[${pIdx}]`, message: "must be a string" });
+                                return;
+                            }
+                            try {
+                                new RegExp(pattern);
+                            }
+                            catch (e) {
+                                issues.push({
+                                    severity: "error",
+                                    path: `${base}.match.metadata.${key}[${pIdx}]`,
+                                    message: `invalid regex: ${e instanceof Error ? e.message : String(e)}`,
+                                });
+                            }
+                        });
+                    }
+                }
+            }
+        });
+        if (defaultCount > 1) {
+            issues.push({ severity: "error", path: "destinations", message: `at most one destination may set 'default: true' (found ${defaultCount})` });
+        }
+    }
     const embedding = childObject(raw, "embedding");
     if (embedding)
         validateUrlLike(embedding.base_url, "embedding.base_url", issues);
@@ -345,8 +441,6 @@ export function loadConfig() {
         config.qdrant_api_key = process.env.QDRANT_API_KEY;
     if (process.env.BIKKY_COLLECTION)
         config.collection = process.env.BIKKY_COLLECTION;
-    if (process.env.BIKKY_DEFAULT_WORKSPACE)
-        config.default_workspace = process.env.BIKKY_DEFAULT_WORKSPACE;
     // Embedding env overrides
     if (process.env.EMBEDDING_PROVIDER)
         config.embedding.provider = process.env.EMBEDDING_PROVIDER;
@@ -481,9 +575,36 @@ export function loadConfig() {
         config.qdrant_url = config.qdrant_url.replace(/\/+$/, "");
     config.embedding.base_url = config.embedding.base_url.replace(/\/+$/, "");
     config.llm.base_url = config.llm.base_url.replace(/\/+$/, "");
+    for (const dest of config.destinations) {
+        if (dest.qdrant_url)
+            dest.qdrant_url = dest.qdrant_url.replace(/\/+$/, "");
+    }
     _config = config;
     return config;
 }
+/**
+ * Resolve the effective list of destinations from the loaded config.
+ *
+ * - If `destinations` is non-empty, return as-is.
+ * - Otherwise synthesize a single fallback destination from the top-level
+ *   `qdrant_url` / `qdrant_api_key` / `collection` so existing single-Qdrant
+ *   configs keep working without changes.
+ * - If neither is configured, returns an empty array — callers should treat
+ *   that as "Qdrant not configured" the same way they did before.
+ */
+export function getEffectiveDestinations(config = loadConfig()) {
+    if (config.destinations.length > 0)
+        return config.destinations;
+    if (!config.qdrant_url)
+        return [];
+    return [{
+            name: "default",
+            qdrant_url: config.qdrant_url,
+            qdrant_api_key: config.qdrant_api_key,
+            collection: config.collection,
+            default: true,
+        }];
+}
 /** Save config to disk (used by setup command). */
 export function saveConfig(config) {
     fs.mkdirSync(BIKKY_DIR, { recursive: true });