bikky 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -9,6 +9,12 @@ This project uses npm package versions for release tracking:
 
 ## Unreleased
 
+## 0.4.2
+
+- Republished the core package from current `main` so the npm package README uses GitHub documentation links instead of stale jsDelivr links.
+
+## 0.4.1
+
 - Public OSS readiness cleanup: package metadata, support docs, public maintainer ownership, package tarball hygiene, and privacy/transcript-capture documentation.
 - Added package verification CI and a privacy-first quickstart for local storage/local model setups.
 

package/CODE_OF_CONDUCT.md

@@ -45,7 +45,7 @@ or harmful.
 ## Scope
 
 This Code of Conduct applies within all community spaces (issues, PRs,
-Discussions, Discord/Slack if any), and also applies when an individual is
+Discord/Slack if any), and also applies when an individual is
 officially representing the community in public spaces.
 
 ## Enforcement

package/CONTRIBUTING.md

@@ -199,7 +199,7 @@ Configure a fallback chain via `llm.fallback_provider` in config (or
 
 ## License
 
-By contributing, you agree that your contributions will be licensed under the project's [AGPL-3.0-or-later](LICENSE) license.
+By contributing, you agree that your contributions will be licensed under the project's [AGPL-3.0-or-later](https://github.com/bikky-dev/bikky/blob/main/LICENSE) license.
 
 ## Code of conduct
 

package/README.md

@@ -10,7 +10,7 @@ bikky gives AI coding agents (GitHub Copilot, Claude Code, Cursor, and other MCP
 - 🤖 **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" width="720" />
+  <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/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 across the team.</i></p>
@@ -101,11 +101,11 @@ bikky supports four common setup shapes. Pick based on where you want Qdrant to
 | ----------------------- | ------------------------------ | ---------------------------------------------------------------------------------------- |
 | **Node.js**             | ≥ 20                           | `nvm install 20` or your package manager                                                 |
 | **Vector store**        | Qdrant                         | Local Docker · [Qdrant Cloud](https://cloud.qdrant.io) · Self-hosted                     |
-| **Embeddings**          | One provider                   | OpenAI · Ollama · Bedrock · Portkey                                                     |
-| **LLM**                 | One provider                   | OpenAI · Ollama · Bedrock · Portkey                                                     |
+| **Embeddings**          | One provider                   | Portkey · OpenAI · Ollama · Bedrock                                                     |
+| **LLM**                 | One provider                   | Portkey · OpenAI · Ollama · Bedrock                                                     |
 | **Docker** *(optional)* | Only if you run Qdrant locally | Docker Desktop, OrbStack, colima, etc.                                                   |
 
-Both `embedding.provider` and `llm.provider` accept the same values: `ollama`, `openai`, `bedrock`, or `portkey`.
+Both `embedding.provider` and `llm.provider` accept the same values: `ollama`, `openai`, `bedrock`, or `portkey`. **Portkey is the easiest cloud option** — one API key, any upstream provider, with built-in routing/fallbacks. Bikky's canonical embedding dimension is **1024**, portable across every modern provider.
 
 > ⚠️ **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/).
 
@@ -128,6 +128,8 @@ Pick the setup guide above for the copy-paste config. All setup shapes use the s
 
 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.
 
+`bikky setup` also provisions `identity.user_id` / `identity.user_name` when they are missing. New memory writes store canonical `origin` metadata with the configured human user, the acting agent or daemon/UI surface, the interface, and the operation. MCP clients cannot supply or spoof `origin.user`; if config, env, Git, and shell identity detection all fail, bikky falls back to the local hostname.
+
 For hosted models, custom providers, multiple profiles, or advanced tuning, use the full configuration guide.
 
 > 📖 **Full configuration guide:** [docs/configuration.md][configuration-guide]
@@ -165,15 +167,15 @@ Most installs use one Qdrant destination. If you need clean separation later, re
 
 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. Search tools can also use `search_scope: "all"` or a named/listed scope when context may span stores. Existing single-Qdrant configs continue to work.
 
-> 📖 **Details:** [multi-destination configuration](docs/configuration.md#multi-destination-routing)
+> 📖 **Details:** [multi-destination configuration](https://github.com/bikky-dev/bikky/blob/main/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
-[privacy-quickstart]: https://cdn.jsdelivr.net/npm/bikky@latest/docs/privacy-first.md
-[contributing]: https://cdn.jsdelivr.net/npm/bikky@latest/CONTRIBUTING.md
+[fully-hosted-config]: https://github.com/bikky-dev/bikky/blob/main/docs/config/fully-hosted.md
+[hosted-models-config]: https://github.com/bikky-dev/bikky/blob/main/docs/config/hosted-models.md
+[local-config]: https://github.com/bikky-dev/bikky/blob/main/docs/config/local.md
+[hosted-qdrant-local-models-config]: https://github.com/bikky-dev/bikky/blob/main/docs/config/hosted-qdrant-local-models.md
+[configuration-guide]: https://github.com/bikky-dev/bikky/blob/main/docs/configuration.md
+[privacy-quickstart]: https://github.com/bikky-dev/bikky/blob/main/docs/privacy-first.md
+[contributing]: https://github.com/bikky-dev/bikky/blob/main/CONTRIBUTING.md
 
 ---
 
@@ -189,17 +191,17 @@ bikky-ui              # opens http://localhost:1422
 ```
 
 <p align="center">
-  <img src="docs/screenshots/dashboard.png" alt="Dashboard — overview stats, category breakdown, recent facts" width="720" />
+  <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/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="docs/screenshots/memory.png" alt="Memory browser — search, filter, and browse all stored facts" width="720" />
+  <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/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"><i>Memory browser — search, filter by category/kind/origin, and browse all stored facts</i></p>
 
 <p align="center">
-  <img src="docs/screenshots/graph.png" alt="Entity graph — interactive visualization of entity relationships" width="720" />
+  <img src="https://raw.githubusercontent.com/bikky-dev/bikky/main/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>
 
@@ -242,6 +244,10 @@ You can also set `daemon.extract_every_sec` to `0` to disable background extract
 
 For a local-storage, local-model setup that minimizes what leaves your machine, see the [privacy-first quickstart][privacy-quickstart].
 
+## Support and contact
+
+For questions, bugs, and feature requests, please use [GitHub issues](https://github.com/bikky-dev/bikky/issues). For maintainer contact, reach Saber Zrelli on GitHub: [@zrelli-s](https://github.com/zrelli-s).
+
 ## License
 
-AGPL-3.0 — see [LICENSE](LICENSE).
+AGPL-3.0 — see [LICENSE](https://github.com/bikky-dev/bikky/blob/main/LICENSE).

package/SUPPORT.md

@@ -12,11 +12,12 @@ bikky status
 
 Please redact API keys, access tokens, local file contents, and any private transcript data before posting.
 
+For maintainer contact, reach Saber Zrelli on GitHub: [@zrelli-s](https://github.com/zrelli-s).
+
 ## Bugs
 
 Use the bug report template and include a minimal reproduction when possible. If the issue involves setup, include whether you installed with `npm install -g bikky`, `npx bikky`, or a local checkout.
 
 ## Security reports
 
-Do not open a public issue for vulnerabilities. Follow [SECURITY.md](SECURITY.md) and use GitHub private vulnerability reporting.
-
+Do not open a public issue for vulnerabilities. Follow [SECURITY.md](https://github.com/bikky-dev/bikky/blob/main/SECURITY.md) and use GitHub private vulnerability reporting.

package/dist/config.d.ts

@@ -4,6 +4,12 @@
  * Resolution order: defaults → ~/.bikky/config.json → env vars.
  * Config directory: ~/.bikky/
  */
+export declare function getBikkyDir(): string;
+export declare function getConfigPath(): string;
+export declare function getLogDir(): string;
+export declare function getStateDir(): string;
+export declare function getPidPath(): string;
+export declare function getExtractionHealthPath(): string;
 export declare const BIKKY_DIR: string;
 export declare const CONFIG_PATH: string;
 export declare const LOG_DIR: string;
@@ -63,7 +69,11 @@ export interface QdrantClientConfig {
     retry_base_delay_ms: number;
 }
 export interface IdentityConfig {
+    user_id: string | null;
+    user_name: string | null;
+    /** @deprecated Use origin.user.id instead. */
     actor_id: string | null;
+    /** @deprecated Use origin.user.name / origin.agent.name instead. */
     actor_label: string | null;
 }
 export interface WatcherConfig {
@@ -158,7 +168,7 @@ export interface ConfigFileDiagnostics {
     issues: ConfigIssue[];
 }
 declare const DEFAULTS: BikkyConfig;
-export declare const CONFIG_ENV_KEYS: readonly ["QDRANT_URL", "QDRANT_API_KEY", "BIKKY_COLLECTION", "EMBEDDING_PROVIDER", "EMBEDDING_MODEL", "EMBEDDING_BASE_URL", "EMBEDDING_DIMENSIONS", "OPENAI_API_KEY", "LLM_PROVIDER", "LLM_MODEL", "LLM_BASE_URL", "LLM_FALLBACK_PROVIDER", "AWS_PROFILE", "AWS_BEDROCK_REGION", "AWS_REGION", "QDRANT_TIMEOUT_MS", "QDRANT_RETRIES", "QDRANT_RETRY_BASE_DELAY_MS", "BIKKY_EMBEDDING_TIMEOUT_MS", "BIKKY_EMBEDDING_RETRIES", "BIKKY_EMBEDDING_RETRY_BASE_DELAY_MS", "BIKKY_LLM_TIMEOUT_MS", "BIKKY_LLM_RETRIES", "BIKKY_LLM_RETRY_BASE_DELAY_MS", "BIKKY_DAEMON_RELATION_INFERENCE_ENABLED", "BIKKY_DAEMON_RELATION_INFERENCE_INTERVAL_SEC", "BIKKY_DAEMON_RELATION_INFERENCE_MAX_PAIRS_PER_RUN", "BIKKY_DAEMON_ENTITY_TYPING_ENABLED", "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC", "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN", "BIKKY_ACTOR_ID", "BIKKY_ACTOR_LABEL"];
+export declare const CONFIG_ENV_KEYS: readonly ["QDRANT_URL", "QDRANT_API_KEY", "BIKKY_COLLECTION", "EMBEDDING_PROVIDER", "EMBEDDING_MODEL", "EMBEDDING_BASE_URL", "EMBEDDING_DIMENSIONS", "OPENAI_API_KEY", "PORTKEY_API_KEY", "LLM_PROVIDER", "LLM_MODEL", "LLM_BASE_URL", "LLM_FALLBACK_PROVIDER", "AWS_PROFILE", "AWS_BEDROCK_REGION", "AWS_REGION", "QDRANT_TIMEOUT_MS", "QDRANT_RETRIES", "QDRANT_RETRY_BASE_DELAY_MS", "BIKKY_EMBEDDING_TIMEOUT_MS", "BIKKY_EMBEDDING_RETRIES", "BIKKY_EMBEDDING_RETRY_BASE_DELAY_MS", "BIKKY_LLM_TIMEOUT_MS", "BIKKY_LLM_RETRIES", "BIKKY_LLM_RETRY_BASE_DELAY_MS", "BIKKY_DAEMON_RELATION_INFERENCE_ENABLED", "BIKKY_DAEMON_RELATION_INFERENCE_INTERVAL_SEC", "BIKKY_DAEMON_RELATION_INFERENCE_MAX_PAIRS_PER_RUN", "BIKKY_DAEMON_ENTITY_TYPING_ENABLED", "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC", "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN", "BIKKY_USER_ID", "BIKKY_USER_NAME", "BIKKY_AGENT_ID", "BIKKY_AGENT_NAME", "BIKKY_ACTOR_ID", "BIKKY_ACTOR_LABEL"];
 export declare function validateConfigObject(raw: unknown): ConfigIssue[];
 export declare function inspectConfigFile(configPath?: string): ConfigFileDiagnostics;
 export declare function getActiveConfigEnvOverrides(env?: NodeJS.ProcessEnv): string[];

package/dist/config.js

@@ -12,15 +12,41 @@ import { z } from "zod";
 // Paths
 // ---------------------------------------------------------------------------
 // BIKKY_HOME env var lets tests (and advanced users) override the config dir
-// without touching the real ~/.bikky/. Tests MUST set this to an isolated
-// tempdir before importing this module — otherwise saveConfig() will write to
-// the user's real config file.
-export const BIKKY_DIR = process.env.BIKKY_HOME ?? path.join(os.homedir(), ".bikky");
-export const CONFIG_PATH = path.join(BIKKY_DIR, "config.json");
-export const LOG_DIR = path.join(BIKKY_DIR, "logs");
-export const STATE_DIR = path.join(BIKKY_DIR, "state");
-export const PID_PATH = path.join(STATE_DIR, "daemon.pid");
-export const EXTRACTION_HEALTH_PATH = path.join(STATE_DIR, "extraction-health.json");
+// without touching the real ~/.bikky/. The getter functions below re-read the
+// env var on every call, so changing BIKKY_HOME at runtime (e.g. in a test
+// setup hook) takes effect for all subsequent saveConfig()/loadConfig() calls.
+//
+// The legacy `BIKKY_DIR` / `CONFIG_PATH` / etc. exports are kept for
+// backward-compatibility, but they capture the env state at module load
+// time and should NOT be relied on for safe writes. Internal callers — and
+// any test that wants sandboxing — should call the getter functions instead.
+export function getBikkyDir() {
+    return process.env.BIKKY_HOME ?? path.join(os.homedir(), ".bikky");
+}
+export function getConfigPath() {
+    return path.join(getBikkyDir(), "config.json");
+}
+export function getLogDir() {
+    return path.join(getBikkyDir(), "logs");
+}
+export function getStateDir() {
+    return path.join(getBikkyDir(), "state");
+}
+export function getPidPath() {
+    return path.join(getStateDir(), "daemon.pid");
+}
+export function getExtractionHealthPath() {
+    return path.join(getStateDir(), "extraction-health.json");
+}
+// Legacy constant exports — captured at module load. Prefer the getter
+// functions above when you need fresh values (e.g. inside tests, or after
+// mutating BIKKY_HOME at runtime).
+export const BIKKY_DIR = getBikkyDir();
+export const CONFIG_PATH = getConfigPath();
+export const LOG_DIR = getLogDir();
+export const STATE_DIR = getStateDir();
+export const PID_PATH = getPidPath();
+export const EXTRACTION_HEALTH_PATH = getExtractionHealthPath();
 // ---------------------------------------------------------------------------
 // Defaults
 // ---------------------------------------------------------------------------
@@ -69,6 +95,8 @@ const DEFAULTS = {
         staleness_threshold_days: 30,
     },
     identity: {
+        user_id: null,
+        user_name: null,
         actor_id: null,
         actor_label: null,
     },
@@ -91,6 +119,7 @@ export const CONFIG_ENV_KEYS = [
     "EMBEDDING_BASE_URL",
     "EMBEDDING_DIMENSIONS",
     "OPENAI_API_KEY",
+    "PORTKEY_API_KEY",
     "LLM_PROVIDER",
     "LLM_MODEL",
     "LLM_BASE_URL",
@@ -113,6 +142,10 @@ export const CONFIG_ENV_KEYS = [
     "BIKKY_DAEMON_ENTITY_TYPING_ENABLED",
     "BIKKY_DAEMON_ENTITY_TYPING_INTERVAL_SEC",
     "BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN",
+    "BIKKY_USER_ID",
+    "BIKKY_USER_NAME",
+    "BIKKY_AGENT_ID",
+    "BIKKY_AGENT_NAME",
     "BIKKY_ACTOR_ID",
     "BIKKY_ACTOR_LABEL",
 ];
@@ -122,7 +155,7 @@ const CONFIG_ENV_PREFIXES = [
 ];
 const nonNegativeInt = z.number().int().nonnegative();
 const positiveInt = z.number().int().positive();
-const stringRecord = z.record(z.string());
+const stringRecord = z.record(z.string(), z.string());
 const embeddingConfigFileSchema = z.object({
     provider: z.string().optional(),
     model: z.string().optional(),
@@ -175,6 +208,8 @@ const qdrantClientConfigFileSchema = z.object({
     retry_base_delay_ms: nonNegativeInt.optional(),
 }).passthrough();
 const identityConfigFileSchema = z.object({
+    user_id: z.string().nullable().optional(),
+    user_name: z.string().nullable().optional(),
     actor_id: z.string().nullable().optional(),
     actor_label: z.string().nullable().optional(),
 }).passthrough();
@@ -183,7 +218,7 @@ const destinationMatchSchema = z.object({
     cwd: regexArrayField,
     entity: regexArrayField,
     content: regexArrayField,
-    metadata: z.record(z.array(z.string())).optional(),
+    metadata: z.record(z.string(), z.array(z.string())).optional(),
 }).passthrough();
 const destinationFileSchema = z.object({
     name: z.string().min(1),
@@ -442,7 +477,7 @@ export function validateConfigObject(raw) {
         validateUrlLike(llm.base_url, "llm.base_url", issues);
     return issues;
 }
-export function inspectConfigFile(configPath = CONFIG_PATH) {
+export function inspectConfigFile(configPath = getConfigPath()) {
     if (!fs.existsSync(configPath)) {
         return { path: configPath, exists: false, parse_error: null, issues: [] };
     }
@@ -490,21 +525,41 @@ export function loadConfig() {
     if (_config)
         return _config;
     // Ensure dirs exist
-    fs.mkdirSync(BIKKY_DIR, { recursive: true });
-    fs.mkdirSync(LOG_DIR, { recursive: true });
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(getBikkyDir(), { recursive: true });
+    fs.mkdirSync(getLogDir(), { recursive: true });
+    fs.mkdirSync(getStateDir(), { recursive: true });
     // Start from defaults
     let config = structuredClone(DEFAULTS);
     // Merge config file
-    if (fs.existsSync(CONFIG_PATH)) {
+    const configPath = getConfigPath();
+    let fileConfig = {};
+    if (fs.existsSync(configPath)) {
         try {
-            const fileConfig = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+            fileConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
             config = deepMerge(config, fileConfig);
         }
         catch (e) {
-            console.error(`bikky: failed to parse ${CONFIG_PATH}: ${e instanceof Error ? e.message : String(e)}`);
+            console.error(`bikky: failed to parse ${configPath}: ${e instanceof Error ? e.message : String(e)}`);
         }
     }
+    // Provider/base_url consistency (issue #131): the DEFAULTS.embedding.base_url
+    // is the ollama localhost URL, baked in for the default ollama provider. If
+    // the user picks a different provider (portkey/openai/bedrock) but doesn't
+    // set an explicit base_url, drop the inherited ollama URL so initEmbedding()
+    // can apply the provider's own default — otherwise we'd POST every embedding
+    // request to localhost:11434 and Ollama would reject the foreign model name.
+    const fileEmbedding = (fileConfig.embedding ?? {});
+    if (config.embedding.provider !== DEFAULTS.embedding.provider
+        && typeof fileEmbedding.base_url !== "string"
+        && !process.env.EMBEDDING_BASE_URL) {
+        config.embedding.base_url = "";
+    }
+    const fileLlm = (fileConfig.llm ?? {});
+    if (config.llm.provider !== DEFAULTS.llm.provider
+        && typeof fileLlm.base_url !== "string"
+        && !process.env.LLM_BASE_URL) {
+        config.llm.base_url = "";
+    }
     // Env var overrides (highest priority)
     if (process.env.QDRANT_URL)
         config.qdrant_url = process.env.QDRANT_URL;
@@ -526,6 +581,12 @@ export function loadConfig() {
     }
     if (process.env.OPENAI_API_KEY)
         config.embedding.api_key = process.env.OPENAI_API_KEY;
+    // Portkey users can supply their gateway key via PORTKEY_API_KEY without
+    // needing to repurpose OPENAI_API_KEY. Only applied when the embedding
+    // provider is Portkey, so non-Portkey setups remain untouched.
+    if (process.env.PORTKEY_API_KEY && config.embedding.provider === "portkey") {
+        config.embedding.api_key = process.env.PORTKEY_API_KEY;
+    }
     // Generic provider-extras: BIKKY_EMBEDDING_EXTRA_<KEY>=value
     config.embedding.extra = config.embedding.extra ?? {};
     for (const [k, v] of Object.entries(process.env)) {
@@ -542,6 +603,9 @@ export function loadConfig() {
         config.llm.base_url = process.env.LLM_BASE_URL;
     if (process.env.OPENAI_API_KEY && !config.llm.api_key)
         config.llm.api_key = process.env.OPENAI_API_KEY;
+    if (process.env.PORTKEY_API_KEY && config.llm.provider === "portkey" && !config.llm.api_key) {
+        config.llm.api_key = process.env.PORTKEY_API_KEY;
+    }
     if (process.env.LLM_FALLBACK_PROVIDER)
         config.llm.fallback_provider = process.env.LLM_FALLBACK_PROVIDER;
     if (process.env.AWS_PROFILE)
@@ -632,6 +696,10 @@ export function loadConfig() {
     const entityTypingMax = positiveInt(process.env.BIKKY_DAEMON_ENTITY_TYPING_MAX_ENTITIES_PER_RUN);
     if (entityTypingMax !== null)
         config.daemon.entity_typing_max_entities_per_run = entityTypingMax;
+    if (process.env.BIKKY_USER_ID)
+        config.identity.user_id = process.env.BIKKY_USER_ID;
+    if (process.env.BIKKY_USER_NAME)
+        config.identity.user_name = process.env.BIKKY_USER_NAME;
     if (process.env.BIKKY_ACTOR_ID)
         config.identity.actor_id = process.env.BIKKY_ACTOR_ID;
     if (process.env.BIKKY_ACTOR_LABEL)
@@ -679,8 +747,8 @@ export function getEffectiveDestinations(config = loadConfig()) {
 }
 /** Save config to disk (used by setup command). */
 export function saveConfig(config) {
-    fs.mkdirSync(BIKKY_DIR, { recursive: true });
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n");
+    fs.mkdirSync(getBikkyDir(), { recursive: true });
+    fs.writeFileSync(getConfigPath(), JSON.stringify(config, null, 2) + "\n");
     _config = config;
 }
 /** Reset cached config (for testing). */

package/dist/daemon/capture-policy.d.ts

@@ -86,7 +86,6 @@ export declare const CAPTURE_KIND_SUBTYPES: {
 export declare const FACT_CATEGORY_TO_SUBTYPE: Record<Category, MemorySubtype>;
 export declare const DEFAULT_CAPTURE_CONTEXT: {
     readonly domain: "software_engineering" | "product_strategy" | "business_operations" | "research" | "personal_productivity";
-    readonly source: "system";
     readonly reviewStatus: "candidate";
     readonly volatility: "evolving";
 };

package/dist/daemon/capture-policy.js

@@ -110,7 +110,6 @@ export const FACT_CATEGORY_TO_SUBTYPE = {
 };
 export const DEFAULT_CAPTURE_CONTEXT = {
     domain: DEFAULT_DOMAIN,
-    source: "system",
     reviewStatus: "candidate",
     // Default fallback volatility when the LLM does not self-judge. Storage path
     // overrides this with the LLM's value (or the volatility verifier's

package/dist/daemon/consolidation.d.ts

@@ -51,6 +51,7 @@ declare const detectContradiction: (fact: {
 }, _config: BikkyConfig, telemetry?: {
     sessionId?: string;
     workstreamKey?: string;
+    destination?: string;
 }) => Promise<ContradictionResult>;
 /**
  * Main consolidation tick — called from daemon tick loop.
@@ -58,6 +59,6 @@ declare const detectContradiction: (fact: {
  */
 declare const tick: (config: BikkyConfig, opts?: ConsolidationTickOptions) => Promise<void>;
 /** Reset state (for testing). */
-declare const _reset: () => void;
+declare const _reset: (tickCount?: number) => void;
 export { detectContradiction, tick, setLogger, _reset, };
 //# sourceMappingURL=consolidation.d.ts.map

package/dist/daemon/consolidation.js

@@ -13,6 +13,7 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { createHash } from "node:crypto";
 import * as qdrant from "./qdrant.js";
+import { buildOperationOrigin } from "../provenance/origin.js";
 import { chatCompletion } from "../llm/index.js";
 import { categoryValues, normalizeCategory, normalizeDomain } from "../mcp/taxonomy.js";
 import { distillPrompt, DISTILL_PROMPT_DESCRIPTOR, contradictionPrompt, briefPrompt, BRIEF_PROMPT_DESCRIPTOR, safeParseJson, } from "../prompts/index.js";
@@ -33,6 +34,8 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
     if (!qdrant.isReady())
         return { distilled: false };
     try {
+        const destination = qdrant.resolveDestination({}).name;
+        const collection = qdrant.collectionForDestination(destination);
         // Find undistilled session summaries (support both legacy and new taxonomy)
         const legacyFilter = {
             must: [
@@ -47,12 +50,12 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
             ],
         };
         const [legacyRes, newRes] = await Promise.all([
-            qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
+            qdrant.qdrantRequest("POST", `/collections/${collection}/points/scroll`, {
                 filter: legacyFilter, limit: 50, with_payload: true,
-            }),
-            qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
+            }, destination),
+            qdrant.qdrantRequest("POST", `/collections/${collection}/points/scroll`, {
                 filter: newFilter, limit: 50, with_payload: true,
-            }),
+            }, destination),
         ]);
         // Deduplicate by ID
         const seen = new Set();
@@ -107,7 +110,6 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
                 domain: normalizeDomain(pattern.domain ?? "software_engineering"),
                 kind: "distilled",
                 entities: Array.isArray(pattern.entities) ? pattern.entities.map(e => String(e).toLowerCase()) : [],
-                source: "system",
                 confidence: 0.85,
                 importance: pattern.importance || 0.7,
                 content_hash: hash,
@@ -116,11 +118,25 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
                     distilled_at: new Date().toISOString(),
                     distilled_by_prompt: promptStamp,
                 },
-            });
+                origin: buildOperationOrigin({
+                    interface: "daemon",
+                    action: "create",
+                    subsystem: "consolidation",
+                    metadata: {
+                        distilled_from_count: batch.length,
+                        prompt: promptStamp,
+                    },
+                }),
+            }, { destination });
         }
         // Supersede the source summaries
         for (const pt of batch) {
-            await qdrant.supersedeFact(pt.id, `distilled:${new Date().toISOString()}`);
+            await qdrant.supersedeFact(pt.id, `distilled:${new Date().toISOString()}`, destination, buildOperationOrigin({
+                interface: "daemon",
+                action: "supersede",
+                subsystem: "consolidation",
+                metadata: { prompt: promptStamp },
+            }));
         }
         logFn("INFO", `Auto-distill: consolidated ${batch.length} summaries into ${patterns.length} patterns`);
         return { distilled: true, count: patterns.length };
@@ -143,12 +159,13 @@ const detectContradiction = async (fact, _config, telemetry) => {
     try {
         const vector = await qdrant.embed(fact.content);
         // Search across all categories because contradictions can cross category lines.
-        const results = await qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/search`, {
+        const collection = qdrant.collectionForDestination(telemetry?.destination);
+        const results = await qdrant.qdrantRequest("POST", `/collections/${collection}/points/search`, {
             vector,
             filter: { must: [{ is_null: { key: "superseded_by" } }] },
             limit: 5,
             with_payload: true,
-        });
+        }, telemetry?.destination);
         const candidates = (results.result || [])
             .filter(r => r.score >= 0.75 && r.score < 0.92);
         if (candidates.length === 0)
@@ -448,8 +465,8 @@ const tick = async (config, opts = {}) => {
     }
 };
 /** Reset state (for testing). */
-const _reset = () => {
-    consolidationTickCount = 0;
+const _reset = (tickCount = 0) => {
+    consolidationTickCount = tickCount;
 };
 export { detectContradiction, tick, setLogger, _reset, };
 //# sourceMappingURL=consolidation.js.map

package/dist/daemon/entity-typing.js

@@ -11,6 +11,7 @@ import { entityTypingPrompt, ENTITY_TYPING_PROMPT_DESCRIPTOR, safeParseJson } fr
 import * as qdrant from "./qdrant.js";
 import { isAttemptBackedOff, pruneRecentAttempts, readMaintenanceState, recordMaintenanceRun, shouldRunMaintenance, } from "./maintenance-state.js";
 import { isGenericEntity } from "./relations-vocab.js";
+import { buildOperationOrigin } from "../provenance/origin.js";
 const FACTS_SCAN_LIMIT = 200;
 const FACTS_PER_ENTITY = 5;
 const DEFAULT_LOOKBACK_MS = 7 * 24 * 60 * 60 * 1000;
@@ -171,6 +172,15 @@ const upsertEntityTypePoint = async (candidate, classification, source) => {
                     classified_at: now,
                     updated_at: now,
                     created_at: now,
+                    origin: buildOperationOrigin({
+                        interface: "daemon",
+                        action: "create",
+                        subsystem: "entity_typing",
+                        metadata: {
+                            entity_name: candidate.name,
+                            classification_source: source,
+                        },
+                    }),
                     source_fact_ids: candidate.factIds,
                     ...(candidate.workstreamKeys.length > 0 ? { workstream_key: candidate.workstreamKeys[0] } : {}),
                     metadata: {

package/dist/daemon/episode-summary.d.ts

@@ -2,6 +2,7 @@ import type { BikkyConfig } from "../config.js";
 import type { QdrantPayload } from "./qdrant.js";
 import { type RedactionSummary } from "../privacy/redaction.js";
 import { type WorkstreamRegistry } from "./workstream-resolver.js";
+import { type OperationOrigin } from "../provenance/origin.js";
 export { buildEpisodeSummaryMessages } from "../prompts/index.js";
 export interface WorkspaceScope {
     workspaceId?: string;
@@ -33,6 +34,7 @@ export interface EpisodeSummaryWriteResult {
     action: "stored" | "updated" | "skipped";
     factId?: string;
     episodeId?: string;
+    destination?: string;
     workstreamKey?: string | null;
     reason?: string;
 }
@@ -57,6 +59,8 @@ export declare const buildEpisodeSummaryPayload: (input: {
         enabled: boolean;
         redactPii: boolean;
     };
+    config?: BikkyConfig;
+    origin?: OperationOrigin;
 }) => EpisodeSummaryPayloadResult;
 export declare const updateEpisodeSummary: (input: {
     segment: EpisodeSegment;