@contractspec/lib.context-storage 0.7.5 → 0.7.8

package/README.md

@@ -1,42 +1,63 @@
 # @contractspec/lib.context-storage
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
 **Context pack and snapshot storage primitives.**
 
-Provides the store interface, domain types, and an in-memory implementation for managing context packs and snapshots. Packs describe curated sets of sources (docblocks, contracts, schemas); snapshots capture point-in-time materializations of those packs.
+## What It Provides
+
+- **Layer**: lib.
+- **Consumers**: module.context-storage.
+- Related ContractSpec packages include `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Installation
 
-```bash
-bun add @contractspec/lib.context-storage
-```
+`npm install @contractspec/lib.context-storage`
 
-## Exports
+or
 
-- `.` -- Re-exports types, store interface, and in-memory implementation
-- `./store` -- `ContextSnapshotStore` interface (upsertPack, createSnapshot, listPacks, etc.)
-- `./in-memory-store` -- `InMemoryContextSnapshotStore` class
-- `./types` -- Domain types: `ContextPackRecord`, `ContextSnapshotRecord`, `ContextSnapshotItem`, queries, and list results
+`bun add @contractspec/lib.context-storage`
 
 ## Usage
 
-```ts
-import { InMemoryContextSnapshotStore } from "@contractspec/lib.context-storage/in-memory-store";
-import type { ContextPackRecord } from "@contractspec/lib.context-storage/types";
+Import the root entrypoint from `@contractspec/lib.context-storage`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/in-memory-store.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/store.ts` is part of the package's public or composition surface.
+- `src/types.ts` is shared public type definitions.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./in-memory-store` resolves through `./src/in-memory-store.ts`.
+- Export `./store` resolves through `./src/store.ts`.
+- Export `./types` resolves through `./src/types.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
-const store = new InMemoryContextSnapshotStore();
+## Recent Updates
 
-const pack: ContextPackRecord = {
-  packKey: "onboarding",
-  version: "1.0.0",
-  title: "Onboarding Context Pack",
-  tags: ["getting-started"],
-  createdAt: new Date().toISOString(),
-};
+- Replace eslint+prettier by biomejs to optimize speed.
+- Add AI provider ranking system with ranking-driven model selection.
 
-await store.upsertPack(pack);
+## Notes
 
-const result = await store.listPacks({ tag: "getting-started" });
-console.log(result.packs);
-```
+- `Store` interface is the contract boundary for persistence adapters; do not change its shape without updating all adapters.

package/dist/in-memory-store.d.ts

@@ -1,5 +1,5 @@
-import type { ContextPackListResult, ContextPackQuery, ContextPackRecord, ContextSnapshotItem, ContextSnapshotItemInput, ContextSnapshotListResult, ContextSnapshotQuery, ContextSnapshotRecord } from './types';
 import type { ContextSnapshotStore } from './store';
+import type { ContextPackListResult, ContextPackQuery, ContextPackRecord, ContextSnapshotItem, ContextSnapshotItemInput, ContextSnapshotListResult, ContextSnapshotQuery, ContextSnapshotRecord } from './types';
 export declare class InMemoryContextSnapshotStore implements ContextSnapshotStore {
     private readonly packs;
     private readonly snapshots;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './types';
-export * from './store';
 export * from './in-memory-store';
+export * from './store';
+export * from './types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.context-storage",
-  "version": "0.7.5",
+  "version": "0.7.8",
   "description": "Context pack and snapshot storage primitives",
   "keywords": [
     "contractspec",
@@ -23,16 +23,16 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test --pass-with-no-tests",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {},
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
-    "@contractspec/tool.bun": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.8",
+    "@contractspec/tool.bun": "3.7.8",
     "typescript": "^5.9.3"
   },
   "exports": {