bikky 0.3.12 → 0.4.0

package/package.json

@@ -1,22 +1,25 @@
 {
   "name": "bikky",
-  "version": "0.3.12",
+  "version": "0.4.0",
   "description": "Shared memory for AI coding sessions — MCP server + background daemon",
   "type": "module",
   "license": "AGPL-3.0-or-later",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bikky-dev/bikky.git"
+    "url": "git+https://github.com/bikky-dev/bikky.git"
   },
   "bin": {
-    "bikky": "./bin/bikky.js"
+    "bikky": "bin/bikky.js"
   },
   "exports": {
     ".": "./dist/mcp/index.js"
   },
   "files": [
+    "CONTRIBUTING.md",
     "dist/",
     "bin/",
+    "docs/configuration.md",
+    "docs/config/",
     "docs/diagrams/",
     "docs/screenshots/"
   ],
@@ -29,7 +32,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
     "check": "tsc --noEmit && eslint src/",
-    "test": "node --test --test-concurrency=1 $(find dist -name '*.test.js')",
+    "test": "tsc && node --test --test-concurrency=1 $(find dist -name '*.test.js')",
     "test:integration": "tsc && BIKKY_INTEGRATION=${BIKKY_INTEGRATION:-1} node --test $(find dist -name '*.itest.js')",
     "build:diagrams": "node scripts/build-diagrams.mjs",
     "prepublishOnly": "npm run build"

package/dist/mcp/api.test.d.ts

@@ -1,6 +0,0 @@
-/**
- * Tests for the MCP api helpers — Qdrant REST wrapper and ensureCollection.
- * Mocks global fetch so no real Qdrant is hit.
- */
-export {};
-//# sourceMappingURL=api.test.d.ts.map

package/dist/mcp/api.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.test.d.ts","sourceRoot":"","sources":["../../src/mcp/api.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/mcp/api.test.js

@@ -1,130 +0,0 @@
-/**
- * Tests for the MCP api helpers — Qdrant REST wrapper and ensureCollection.
- * Mocks global fetch so no real Qdrant is hit.
- */
-import { describe, it, before, after, beforeEach } from "node:test";
-import assert from "node:assert/strict";
-import { qdrantReq, ensureCollection, getCollection, setCollection, setQdrantUrl, setQdrantApiKey, setReady, initEmbedding, } from "./api.js";
-const realFetch = globalThis.fetch;
-function installMock(handler) {
-    const calls = [];
-    globalThis.fetch = (async (input, init) => {
-        const url = typeof input === "string" ? input : input.toString();
-        const headers = init?.headers ?? {};
-        const body = init?.body ? JSON.parse(String(init.body)) : null;
-        const call = { url, method: init?.method ?? "GET", headers, body };
-        calls.push(call);
-        return handler(call);
-    });
-    return calls;
-}
-describe("mcp/api", () => {
-    before(() => {
-        setQdrantUrl("https://qdrant.test:6333");
-        setQdrantApiKey("test-key");
-        setCollection("bikky-test");
-        initEmbedding({
-            provider: "ollama",
-            baseUrl: "http://localhost:11434",
-            model: "test-model",
-            dimensions: 8,
-            apiKey: null,
-        });
-    });
-    after(() => {
-        globalThis.fetch = realFetch;
-        setQdrantUrl(null);
-        setQdrantApiKey(null);
-        setReady(false);
-    });
-    beforeEach(() => {
-        globalThis.fetch = realFetch;
-    });
-    describe("collection setters", () => {
-        it("getCollection round-trips via setCollection", () => {
-            setCollection("foo");
-            assert.equal(getCollection(), "foo");
-            setCollection("bikky-test");
-        });
-    });
-    describe("qdrantReq", () => {
-        it("builds the URL, sends the api-key header, and serialises the body", async () => {
-            const calls = installMock(() => new Response(JSON.stringify({ result: { ok: true } }), { status: 200 }));
-            const result = await qdrantReq("POST", "/foo", { x: 1 });
-            assert.deepEqual(result, { result: { ok: true } });
-            assert.equal(calls.length, 1);
-            assert.equal(calls[0].url, "https://qdrant.test:6333/foo");
-            assert.equal(calls[0].method, "POST");
-            assert.equal(calls[0].headers["api-key"], "test-key");
-            assert.equal(calls[0].headers["Content-Type"], "application/json");
-            assert.deepEqual(calls[0].body, { x: 1 });
-        });
-        it("omits the body for GET-style requests", async () => {
-            const calls = installMock(() => new Response(JSON.stringify({}), { status: 200 }));
-            await qdrantReq("GET", "/x");
-            assert.equal(calls[0].body, null);
-        });
-        it("throws with status + body when the response is not ok", async () => {
-            installMock(() => new Response("boom", { status: 500 }));
-            await assert.rejects(qdrantReq("GET", "/fail"), /Qdrant GET \/fail failed \(500\): boom/);
-        });
-    });
-    describe("ensureCollection", () => {
-        it("does nothing if the collection already exists", async () => {
-            const calls = installMock((call) => {
-                if (call.method === "GET" && call.url.endsWith("/collections/bikky-test")) {
-                    return new Response(JSON.stringify({ result: { name: "bikky-test" } }), { status: 200 });
-                }
-                // Index creation calls
-                if (call.url.endsWith("/index")) {
-                    return new Response(JSON.stringify({ result: { ok: true } }), { status: 200 });
-                }
-                return new Response("unexpected", { status: 500 });
-            });
-            await ensureCollection([{ field_name: "category", field_schema: "keyword" }]);
-            // 1 GET (existence check) + 1 PUT (index)
-            assert.equal(calls.length, 2);
-            assert.equal(calls[0].method, "GET");
-            assert.equal(calls[1].method, "PUT");
-            assert.ok(calls[1].url.endsWith("/index"));
-        });
-        it("creates the collection when GET returns 404", async () => {
-            const calls = installMock((call) => {
-                if (call.method === "GET" && call.url.endsWith("/collections/bikky-test")) {
-                    return new Response("not found (404)", { status: 404 });
-                }
-                return new Response(JSON.stringify({ result: { ok: true } }), { status: 200 });
-            });
-            await ensureCollection([]);
-            assert.equal(calls[0].method, "GET");
-            assert.equal(calls[1].method, "PUT");
-            assert.equal(calls[1].url, "https://qdrant.test:6333/collections/bikky-test");
-            assert.ok(calls[1].body && typeof calls[1].body === "object");
-        });
-        it("propagates non-404 errors from the existence check", async () => {
-            installMock((call) => {
-                if (call.method === "GET")
-                    return new Response("auth failed", { status: 401 });
-                return new Response("{}", { status: 200 });
-            });
-            await assert.rejects(ensureCollection([]), /401/);
-        });
-        it("swallows index creation errors with a warning", async () => {
-            installMock((call) => {
-                if (call.method === "GET") {
-                    return new Response(JSON.stringify({ result: { name: "bikky-test" } }), { status: 200 });
-                }
-                if (call.url.endsWith("/index")) {
-                    return new Response("index already exists", { status: 400 });
-                }
-                return new Response("{}", { status: 200 });
-            });
-            // Must NOT throw — index errors are warned and swallowed
-            await ensureCollection([
-                { field_name: "category", field_schema: "keyword" },
-                { field_name: "domain", field_schema: "keyword" },
-            ]);
-        });
-    });
-});
-//# sourceMappingURL=api.test.js.map

package/dist/mcp/api.test.js.map

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

package/dist/mcp/tools.integration.itest.d.ts

@@ -1,23 +0,0 @@
-/**
- * End-to-end integration test against a real Qdrant Cloud collection.
- *
- * **OPT-IN.** This file uses the `.itest.ts` extension so the default
- * `dist/**\/*.test.js` glob does NOT pick it up. Run explicitly with:
- *
- *   BIKKY_INTEGRATION=1 npm run test:integration
- *
- * Required env (or in ~/.bikky/config.json — loadConfig merges env):
- *   - BIKKY_INTEGRATION=1   (master gate)
- *   - QDRANT_URL            (Qdrant Cloud REST URL)
- *   - QDRANT_API_KEY        (Qdrant Cloud API key)
- *   - embedding provider config (defaults from ~/.bikky/config.json)
- *
- * Behaviour:
- *   - Creates a uuid-suffixed throwaway collection (`bikky-it-<short>`).
- *   - Drops it in `after()` regardless of pass/fail.
- *   - Exercises the real handlers from registerTools() against live Qdrant +
- *     real embeddings — validating filter shapes, payload indexes, vector
- *     dimensions, and the dedup similarity thresholds for real.
- */
-export {};
-//# sourceMappingURL=tools.integration.itest.d.ts.map

package/dist/mcp/tools.integration.itest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.integration.itest.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.integration.itest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/mcp/tools.integration.itest.js

@@ -1,171 +0,0 @@
-/**
- * End-to-end integration test against a real Qdrant Cloud collection.
- *
- * **OPT-IN.** This file uses the `.itest.ts` extension so the default
- * `dist/**\/*.test.js` glob does NOT pick it up. Run explicitly with:
- *
- *   BIKKY_INTEGRATION=1 npm run test:integration
- *
- * Required env (or in ~/.bikky/config.json — loadConfig merges env):
- *   - BIKKY_INTEGRATION=1   (master gate)
- *   - QDRANT_URL            (Qdrant Cloud REST URL)
- *   - QDRANT_API_KEY        (Qdrant Cloud API key)
- *   - embedding provider config (defaults from ~/.bikky/config.json)
- *
- * Behaviour:
- *   - Creates a uuid-suffixed throwaway collection (`bikky-it-<short>`).
- *   - Drops it in `after()` regardless of pass/fail.
- *   - Exercises the real handlers from registerTools() against live Qdrant +
- *     real embeddings — validating filter shapes, payload indexes, vector
- *     dimensions, and the dedup similarity thresholds for real.
- */
-import { describe, it, before, after } from "node:test";
-import assert from "node:assert/strict";
-import { randomUUID } from "node:crypto";
-import { registerTools } from "./tools.js";
-import { setQdrantUrl, setQdrantApiKey, setReady, setCollection, initEmbedding, ensureCollection, qdrantReq, } from "./api.js";
-import { QDRANT_INDEXES } from "./taxonomy.js";
-import { loadConfig } from "../config.js";
-const enabled = process.env.BIKKY_INTEGRATION === "1" &&
-    Boolean(process.env.QDRANT_URL || loadConfig().qdrant_url) &&
-    Boolean(process.env.QDRANT_API_KEY || loadConfig().qdrant_api_key);
-function makeFakeServer() {
-    const handlers = new Map();
-    const server = {
-        tool(name, _desc, _schema, handler) {
-            handlers.set(name, handler);
-        },
-    };
-    return { server, handlers };
-}
-let handlers;
-let collectionName;
-function textOf(result) {
-    return result.content[0]?.text ?? "";
-}
-async function invoke(name, args) {
-    const h = handlers.get(name);
-    if (!h)
-        throw new Error(`Handler '${name}' not registered`);
-    return h(args);
-}
-describe("mcp/tools — Qdrant integration", { skip: !enabled }, () => {
-    before(async () => {
-        const cfg = loadConfig();
-        const url = process.env.QDRANT_URL ?? cfg.qdrant_url;
-        const apiKey = process.env.QDRANT_API_KEY ?? cfg.qdrant_api_key;
-        if (!url || !apiKey)
-            throw new Error("Qdrant URL / API key missing");
-        collectionName = `bikky-it-${randomUUID().slice(0, 8)}`;
-        setQdrantUrl(url);
-        setQdrantApiKey(apiKey);
-        setCollection(collectionName);
-        initEmbedding({
-            provider: cfg.embedding.provider,
-            baseUrl: cfg.embedding.base_url,
-            model: cfg.embedding.model,
-            dimensions: cfg.embedding.dimensions,
-            apiKey: cfg.embedding.api_key,
-        });
-        await ensureCollection(QDRANT_INDEXES);
-        setReady(true);
-        const fake = makeFakeServer();
-        registerTools(fake.server);
-        handlers = fake.handlers;
-    });
-    after(async () => {
-        try {
-            if (collectionName) {
-                await qdrantReq("DELETE", `/collections/${collectionName}`);
-            }
-        }
-        finally {
-            setReady(false);
-            setQdrantUrl(null);
-            setQdrantApiKey(null);
-        }
-    });
-    // Shared state across the ordered scenarios below.
-    let fact1Id;
-    let fact2Id;
-    it("inserts two distinct facts", async () => {
-        const r1 = JSON.parse(textOf(await invoke("memory_store", {
-            content: "Qdrant Cloud free tier provides 1GB storage with no credit card required",
-            category: "engineering",
-            entities: ["qdrant", "qdrant-cloud"],
-        })));
-        assert.equal(r1.action, "inserted");
-        fact1Id = r1.fact_id;
-        const r2 = JSON.parse(textOf(await invoke("memory_store", {
-            content: "OpenAI text-embedding-3-small produces 1536-dimensional vectors",
-            category: "engineering",
-            entities: ["openai", "embeddings"],
-        })));
-        assert.equal(r2.action, "inserted");
-        fact2Id = r2.fact_id;
-        assert.notEqual(fact1Id, fact2Id);
-    });
-    it("reinforces on exact content-hash match", async () => {
-        const r = JSON.parse(textOf(await invoke("memory_store", {
-            content: "Qdrant Cloud free tier provides 1GB storage with no credit card required",
-            category: "engineering",
-            entities: ["qdrant"],
-        })));
-        assert.equal(r.action, "reinforced");
-        assert.equal(r.fact_id, fact1Id);
-        assert.ok(r.reinforcement_count >= 2);
-    });
-    it("reinforces on a near-duplicate via real-vector similarity", async () => {
-        // Paraphrase of fact 1 — same meaning, different wording.
-        const r = JSON.parse(textOf(await invoke("memory_store", {
-            content: "Qdrant Cloud's free plan offers 1GB of storage and does not require a credit card",
-            category: "engineering",
-            entities: ["qdrant"],
-        })));
-        // Either reinforced (preferred — proves the 0.92 threshold) or inserted
-        // with a similar_facts entry pointing at fact1 (proves we're at least in
-        // the related band). The first case is the strong assertion; we log if it
-        // falls through so a maintainer can re-tune thresholds per embedding model.
-        if (r.action === "reinforced") {
-            assert.equal(r.fact_id, fact1Id);
-        }
-        else {
-            assert.equal(r.action, "inserted", `unexpected action: ${r.action}`);
-            const similar = (r.similar_facts ?? []);
-            const match = similar.find((s) => s.id === fact1Id);
-            assert.ok(match, `expected paraphrase to reinforce or appear in similar_facts; got ${JSON.stringify(r)}`);
-            console.warn(`[integration] paraphrase landed in related band (score=${match.score}) — consider tuning THRESHOLD_DUPLICATE for this embedding model`);
-        }
-    });
-    it("recalls a stored fact via semantic search", async () => {
-        const result = await invoke("memory_recall", {
-            query: "What does the Qdrant free tier include?",
-            limit: 5,
-        });
-        const text = textOf(result);
-        assert.match(text, /1GB|free tier/i);
-    });
-    it("aggregates facts about an entity", async () => {
-        const result = await invoke("memory_entity", { name: "qdrant" });
-        const text = textOf(result);
-        assert.match(text, /Facts about qdrant/);
-        assert.match(text, /1GB|free tier/i);
-    });
-    it("forgets a fact and excludes it from subsequent recall", async () => {
-        const forgetResult = JSON.parse(textOf(await invoke("memory_forget", {
-            fact_id: fact2Id,
-            reason: "integration-test cleanup",
-        })));
-        assert.equal(forgetResult.status, "forgotten");
-        // Recall something the forgotten fact would have matched.
-        const recallResult = await invoke("memory_recall", {
-            query: "OpenAI embedding dimensions",
-            limit: 10,
-        });
-        const text = textOf(recallResult);
-        // Fact 2 should not appear (it was the only one about embedding dimensions
-        // we inserted). A "no matching facts" response is acceptable.
-        assert.doesNotMatch(text, /1536-dimensional/);
-    });
-});
-//# sourceMappingURL=tools.integration.itest.js.map

package/dist/mcp/tools.integration.itest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.integration.itest.js","sourceRoot":"","sources":["../../src/mcp/tools.integration.itest.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools.test.d.ts

@@ -1,16 +0,0 @@
-/**
- * Integration tests for the MCP tool handlers in tools.ts.
- *
- * tools.ts registers all tool handlers inside `registerTools(mcp)`. To exercise
- * them without a live MCP server we use a minimal fake McpServer that captures
- * each `tool(name, desc, schema, handler)` registration into a map. Tests then
- * invoke handlers directly with mocked fetch responses for Qdrant + embedding.
- *
- * Covers the data-integrity + recall surface:
- *   - memory_store: hash dedup, vector dedup, supersedes, relation insertion
- *   - memory_recall: filter passthrough, graph_depth=1 traversal, ranking
- *   - memory_entity: facts + relations aggregation with dedup
- *   - memory_forget: marks fact as superseded with reason
- */
-export {};
-//# sourceMappingURL=tools.test.d.ts.map

package/dist/mcp/tools.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.test.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}