@memstack/core 0.7.0 → 0.7.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.
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # MemStack
2
2
 
3
+ > Implementation priority is maintained in the [canonical roadmap](docs/ROADMAP.md).
4
+
3
5
  > The open-source memory layer for AI agents — store, retrieve, summarize, and prune.
4
6
 
5
7
  [![npm version](https://img.shields.io/npm/v/@memstack/core)](https://www.npmjs.com/package/@memstack/core)
@@ -673,9 +675,16 @@ new OpenAIEmbeddingAdapter({ apiKey: "...", baseURL: "https://api.voyageai.com/v
673
675
 
674
676
  ### Storage Adapters
675
677
 
676
- MemStack ships with **12 production-ready storage adapters (6 experimental)** — every major backend, zero peer dependencies, all client-injected.
678
+ MemStack contains 18 storage-adapter implementations. Twelve are exported from `@memstack/core`; six remain experimental source implementations. Core has no runtime dependencies, and database clients are injected by callers.
679
+
680
+ **Support levels:**
677
681
 
678
- ### Production (e2e verified against real instances)
682
+ - **Production-ready** means exported from the public package, covered by unit tests, and supported as part of the public API.
683
+ - **Real-service E2E verified** means the adapter also passes against its actual database implementation in `pnpm test:e2e`.
684
+ - **Mock-tested** means unit coverage uses an injected fake client rather than a live cloud service.
685
+ - **Experimental** means implemented in source but not exported from the published package.
686
+
687
+ ### Public package exports
679
688
 
680
689
  **Built-in (zero external deps):**
681
690
  | Adapter | Backend | Use case |
@@ -709,9 +718,9 @@ MemStack ships with **12 production-ready storage adapters (6 experimental)**
709
718
  |---|---|
710
719
  | `Neo4jStorageAdapter` | Neo4j |
711
720
 
712
- ### Experimental (mock-tested, blocked by cloud deps or platform constraints)
721
+ ### Experimental (mock-tested or missing an optional E2E capability)
713
722
 
714
- Available via direct source import. Not yet in the barrel export — uncomment in `src/index.ts` when e2e verified.
723
+ These implementations are available to source contributors but are not part of the published package API.
715
724
 
716
725
  | Adapter | Backend | Blocker |
717
726
  |---|---|---|
@@ -722,7 +731,7 @@ Available via direct source import. Not yet in the barrel export — uncomment i
722
731
  | `Mem0StorageAdapter` | Mem0 OSS or Cloud | Cloud-only (needs API key) |
723
732
  | `ZepStorageAdapter` | Zep Cloud or CE | Cloud-only (needs API key) |
724
733
 
725
- > **Direct import:** `import { ChromaStorageAdapter } from "@memstack/core/src/adapters/storage/chroma.js"`
734
+ Live cloud compatibility remains unverified for Pinecone, Upstash, Mem0, Zep, and Turso. Chroma's real-client E2E suite is skipped when its optional default embedding function is unavailable. LLM and embedding-provider tests use mocks; live-provider testing is opt-in and is not part of CI.
726
735
 
727
736
  **Quick-start per backend:**
728
737
 
@@ -965,13 +974,21 @@ git clone https://github.com/isiomaC/memstack.git
965
974
  cd memstack
966
975
  pnpm install
967
976
 
968
- pnpm test # 393 tests, no external services needed
969
- pnpm test:e2e # 82 E2E tests (requires Docker)
970
- pnpm test:watch # Watch mode
971
- pnpm build # CJS + ESM + type declarations
972
- pnpm check # TypeScript type-check only
977
+ pnpm test # 407 core tests, no external services needed
978
+ pnpm test:packages # 78 package tests after dependency-ordered builds
979
+ pnpm test:e2e # 80 pass, 1 optional Chroma skip (requires Docker services)
980
+ pnpm test:e2e:run # Start services, run E2E once, preserve failure logs, clean up
981
+ pnpm smoke:artifacts # Built core, CLI, MCP, and server black-box checks
982
+ pnpm smoke:packages # Pack and install publishable tarballs in a clean project
983
+ pnpm smoke:docker # Build and exercise the server image
984
+ pnpm verify # Complete local verification pipeline
985
+ pnpm test:watch # Watch core tests
986
+ pnpm build:all # Build core and all workspace packages
987
+ pnpm check:all # Type-check core and all workspace packages
973
988
  ```
974
989
 
990
+ CI exposes a stable `verification` job. Configure that job as a required status check in GitHub branch protection for `main`.
991
+
975
992
  ### Debugging
976
993
 
977
994
  Use hooks for observability — MemStack has no built-in logging:
package/dist/index.cjs CHANGED
@@ -3221,7 +3221,7 @@ var LanceDBStorageAdapter = class {
3221
3221
  return results;
3222
3222
  }
3223
3223
  async get(id) {
3224
- const results = await this.table.search(this._zeroVector).limit(1).where(`id = "${id}"`).execute();
3224
+ const results = await this.table.search(this._zeroVector).limit(1).where(`id = "${id}"`).prefilter(true).execute();
3225
3225
  if (results.length === 0) return null;
3226
3226
  const row = results[0];
3227
3227
  if (row.expires_at) {