@lh8ppl/claude-memory-kit 0.2.3 → 0.3.0

package/template/support/milvus-deploy/README.md

@@ -1,57 +0,0 @@
-# Milvus deployment (Windows + optional)
-
-This compose stack runs Milvus v2.6.16 plus its required dependencies (etcd, MinIO) as three local containers. It's used by **Layer 5** (memsearch vector search) of the memory system.
-
-## When you need this
-
-- **Windows**: required. `milvus-lite` (the default embedded vector store memsearch ships) has no Windows wheels on PyPI. Use this Docker stack instead.
-- **Linux / macOS**: optional. memsearch auto-installs milvus-lite and uses it at `~/.memsearch/milvus.db`. Skip this directory entirely unless you specifically want a remote Milvus.
-
-## Bring it up
-
-```bash
-cd milvus-deploy
-docker compose up -d
-```
-
-Wait ~30-60 seconds for all three containers to report `(healthy)`:
-
-```bash
-docker compose ps
-```
-
-You should see `milvus-etcd`, `milvus-minio`, `milvus-standalone` all `Up (healthy)`.
-
-## Configure memsearch to use it
-
-```bash
-memsearch config set milvus.uri "http://localhost:19530"
-```
-
-## Bring it down
-
-```bash
-docker compose down
-```
-
-Volumes persist in `./volumes/` — re-running `up -d` reuses the same data.
-
-## Why a multi-container stack and not just `milvus-standalone`?
-
-Milvus standalone needs etcd (metadata store) and MinIO (object storage for segments and index data). On Linux/macOS, `milvus-lite` bundles all of that into one Python wheel; on Windows there's no equivalent wheel, so the three services run as separate containers.
-
-The single-container `docker run milvusdb/milvus:latest standalone` pattern referenced in some older docs is no longer supported — `latest` is `v3.0-beta` whose entrypoint doesn't accept `standalone` as a command. Use this compose file with the pinned versions instead.
-
-## Known quirk: memsearch index without flush
-
-memsearch v0.4.x doesn't call `flush()` after `MilvusStore.upsert()`. On Milvus v2.6+ (Woodpecker WAL), this means `memsearch index` reports success but the data isn't searchable until a flush forces the growing segment to seal.
-
-Use `scripts/memsearch-index-with-flush.sh` instead of raw `memsearch index` until upstream ships a fix. Tracked as [memsearch issue #534](https://github.com/zilliztech/memsearch/issues/534).
-
-## Pinned versions
-
-| Image | Version | Why pinned |
-|---|---|---|
-| `milvusdb/milvus` | `v2.6.16` | Latest stable v2.6 line. `latest` tag is v3.0-beta and crashes. |
-| `quay.io/coreos/etcd` | `v3.5.25` | Compatible with milvus v2.6. |
-| `minio/minio` | `RELEASE.2024-12-18T13-15-44Z` | Recent stable RELEASE tag. |

package/template/support/milvus-deploy/docker-compose.yml

@@ -1,66 +0,0 @@
-version: '3.5'
-
-services:
-  etcd:
-    container_name: milvus-etcd
-    image: quay.io/coreos/etcd:v3.5.25
-    environment:
-      - ETCD_AUTO_COMPACTION_MODE=revision
-      - ETCD_AUTO_COMPACTION_RETENTION=1000
-      - ETCD_QUOTA_BACKEND_BYTES=4294967296
-      - ETCD_SNAPSHOT_COUNT=50000
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/etcd:/etcd
-    command: etcd -advertise-client-urls=http://etcd:2379 -listen-client-urls http://0.0.0.0:2379 --data-dir /etcd
-    healthcheck:
-      test: ["CMD", "etcdctl", "endpoint", "health"]
-      interval: 30s
-      timeout: 20s
-      retries: 3
-
-  minio:
-    container_name: milvus-minio
-    image: minio/minio:RELEASE.2024-12-18T13-15-44Z
-    environment:
-      MINIO_ACCESS_KEY: minioadmin
-      MINIO_SECRET_KEY: minioadmin
-    ports:
-      - "9001:9001"
-      - "9000:9000"
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/minio:/minio_data
-    command: minio server /minio_data --console-address ":9001"
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
-      interval: 30s
-      timeout: 20s
-      retries: 3
-
-  standalone:
-    container_name: milvus-standalone
-    image: milvusdb/milvus:v2.6.16
-    command: ["milvus", "run", "standalone"]
-    security_opt:
-    - seccomp:unconfined
-    environment:
-      ETCD_ENDPOINTS: etcd:2379
-      MINIO_ADDRESS: minio:9000
-      MQ_TYPE: woodpecker
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
-      interval: 30s
-      start_period: 90s
-      timeout: 20s
-      retries: 3
-    ports:
-      - "19530:19530"
-      - "9091:9091"
-    depends_on:
-      - "etcd"
-      - "minio"
-
-networks:
-  default:
-    name: milvus

package/template/support/scripts/memsearch-index-with-flush.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-#
-# Wraps `memsearch index` to also force a Milvus flush afterward.
-#
-# Why: Milvus v2.6+ uses the Woodpecker WAL backend, which (unlike v2.5's
-# Pulsar) does not auto-flush growing segments on a short timer. As a result,
-# `memsearch index` reports "Indexed N chunks" successfully but
-# `get_collection_stats` returns 0 rows and search returns no results until
-# a manual flush forces the growing segment to seal.
-#
-# This wrapper runs the index, then issues a flush via pymilvus.
-#
-# Usage:
-#   bash scripts/memsearch-index-with-flush.sh context/memory context/sessions context/transcripts
-#
-# Reads MILVUS_URI from env (falls back to the memsearch config value, then localhost).
-# Reads MILVUS_COLLECTION from env (falls back to memsearch config, then "memsearch_chunks").
-
-# Task Scheduler / launchd / unattended cron contexts don't always inherit
-# the user's PATH. Set it up explicitly for the common locations.
-case ":$PATH:" in
-    *":/usr/bin:"*) ;;
-    *) export PATH="/usr/bin:/usr/local/bin:/opt/homebrew/bin:/c/Program Files/Git/usr/bin:$PATH" ;;
-esac
-
-# On Windows, also add the Python Scripts dir where `memsearch.exe` lands.
-if [ -d "/c/Users/$USERNAME/AppData/Local/Programs/Python" ]; then
-    for d in /c/Users/$USERNAME/AppData/Local/Programs/Python/Python*/Scripts \
-             /c/Users/$USERNAME/AppData/Local/Programs/Python/Python*; do
-        [ -d "$d" ] && export PATH="$d:$PATH"
-    done
-fi
-
-set -euo pipefail
-
-# Step 1 — index. Pass through all args.
-memsearch index "$@"
-
-# Step 2 — flush.
-MILVUS_URI="${MILVUS_URI:-$(memsearch config get milvus.uri 2>/dev/null | tail -n1 | tr -d '\r')}"
-MILVUS_COLLECTION="${MILVUS_COLLECTION:-$(memsearch config get milvus.collection 2>/dev/null | tail -n1 | tr -d '\r')}"
-MILVUS_URI="${MILVUS_URI:-http://localhost:19530}"
-MILVUS_COLLECTION="${MILVUS_COLLECTION:-memsearch_chunks}"
-
-# Flush only if we're using a remote Milvus (milvus-lite auto-flushes).
-case "$MILVUS_URI" in
-    http://*|https://*|tcp://*)
-        python -c "
-from pymilvus import MilvusClient
-client = MilvusClient(uri='${MILVUS_URI}')
-client.flush('${MILVUS_COLLECTION}')
-stats = client.get_collection_stats('${MILVUS_COLLECTION}')
-print(f'Flushed. Collection {stats!r}')
-"
-        ;;
-    *)
-        echo "Local milvus-lite detected (${MILVUS_URI}); skipping flush (auto-flush)."
-        ;;
-esac