bikky 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +4 -35
  2. package/package.json +5 -3
package/README.md CHANGED
@@ -40,13 +40,7 @@ bikky is not a wiki you have to write. Facts are captured as a natural byproduct
40
40
 
41
41
  ## How it works
42
42
 
43
- ```mermaid
44
- graph TD
45
- A["🤖 Copilot / Claude Code"] <-->|MCP stdio| B["bikky MCP Server"]
46
- C["📁 Session logs<br/>~/.copilot/"] -->|events.jsonl| D["bikky Daemon<br/>(background)"]
47
- B -->|store / recall| E[("🔮 Qdrant Cloud<br/>vector DB")]
48
- D -->|embed + store| E
49
- ```
43
+ ![Architecture](https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/diagrams/architecture.svg)
50
44
 
51
45
  **MCP Server** — 12 memory tools your AI assistant can call directly:
52
46
  - `memory_store` / `memory_recall` — store and search facts
@@ -264,15 +258,7 @@ bikky install # Write MCP config for Copilot + Claude Code
264
258
 
265
259
  Two-layer dedup prevents bloat:
266
260
 
267
- ```mermaid
268
- flowchart TD
269
- A[New fact] --> B{SHA-256<br/>content hash}
270
- B -->|exact match| C[Skip — duplicate]
271
- B -->|no match| D{Vector<br/>similarity}
272
- D -->|"> 0.92"| E["Reinforce existing<br/>(bump count)"]
273
- D -->|"> 0.80"| F[Store + flag<br/>as related]
274
- D -->|"< 0.80"| G[Store as new]
275
- ```
261
+ ![Deduplication](https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/diagrams/dedup.svg)
276
262
 
277
263
  ### Ranking formula
278
264
  Facts are ranked using a combined score:
@@ -285,15 +271,7 @@ Facts are ranked using a combined score:
285
271
 
286
272
  Facts mentioning multiple entities build an implicit graph:
287
273
 
288
- ```mermaid
289
- graph LR
290
- subgraph "Entity Graph"
291
- U(user) -->|owns| P(project-x)
292
- U -->|uses| Q(qdrant)
293
- P -->|depends-on| Q
294
- U -->|prefers| D(dark mode)
295
- end
296
- ```
274
+ ![Entity Graph](https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/diagrams/entity-graph.svg)
297
275
 
298
276
  The daemon periodically:
299
277
  1. Scrolls all facts → builds entity co-occurrence map
@@ -302,16 +280,7 @@ The daemon periodically:
302
280
 
303
281
  ### Consolidation pipeline
304
282
 
305
- ```mermaid
306
- flowchart LR
307
- A[Session<br/>summaries] --> B{5+ summaries?}
308
- B -->|yes| C[Auto-distill]
309
- C --> D[Distilled<br/>patterns]
310
- E[All facts] --> F[Contradiction<br/>detection]
311
- F --> G[Flagged for<br/>review]
312
- E --> H[Staleness<br/>scan]
313
- H --> I["Stale facts<br/>(30+ days)"]
314
- ```
283
+ ![Consolidation Pipeline](https://raw.githubusercontent.com/bikky-dev/bikky/main/docs/diagrams/consolidation.svg)
315
284
 
316
285
  - **Auto-distill** — merges 5+ session summaries into distilled patterns
317
286
  - **Contradiction detection** — flags conflicting facts for review
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bikky",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Shared memory for AI coding sessions — MCP server + background daemon",
5
5
  "type": "module",
6
6
  "license": "AGPL-3.0-or-later",
@@ -27,17 +27,19 @@
27
27
  "lint": "eslint src/",
28
28
  "check": "tsc --noEmit && eslint src/",
29
29
  "test": "node --test dist/*.test.js dist/**/*.test.js",
30
+ "build:diagrams": "node scripts/build-diagrams.mjs",
30
31
  "prepublishOnly": "npm run build"
31
32
  },
32
33
  "dependencies": {
33
- "@modelcontextprotocol/sdk": "^1.29.0",
34
34
  "@aws-sdk/client-bedrock-runtime": "^3.1006.0",
35
+ "@modelcontextprotocol/sdk": "^1.29.0",
35
36
  "zod": "^3.24.0"
36
37
  },
37
38
  "devDependencies": {
39
+ "@mermaid-js/mermaid-cli": "^11.12.0",
38
40
  "@types/node": "^22.0.0",
39
- "typescript": "^5.8.0",
40
41
  "eslint": "^9.0.0",
42
+ "typescript": "^5.8.0",
41
43
  "typescript-eslint": "^8.0.0"
42
44
  },
43
45
  "engines": {