@equationalapplications/expo-llm-wiki 7.5.0 → 7.7.0

package/README.md

@@ -122,6 +122,8 @@ const wiki = createWiki(db, {
     staleInferredAfterDays: 60,        // default: 60 (days before runHeal downgrades inferred facts; null to disable)
     preFilterLimit: 50,                // default: undefined — MiniSearch pre-filter before cosine scan; recommended for >500 facts
     hybridWeight: 0.7,                 // default: undefined — blend semantic (1.0) ↔ keyword (0.0); pure semantic when unset
+    excludeDrafts: false,              // default: false — hide unreviewed drafts from reads; traversal skips discovered drafts (a draft start fact is still returned)
+    grounding: { mode: 'off' },        // default: off — 'draft' stores facts that don't quote their source as drafts
 
     // Global prompt overrides — librarianSystemPrompt and healSystemPrompt apply to write() auto-runs;
     // ingestSystemPrompt applies only to explicit ingestDocument() calls.
@@ -136,6 +138,41 @@ const wiki = createWiki(db, {
 });
 ```
 
+**Diagnostics and draft review.** Pass `onDiagnostic` beside `llmProvider` (not inside `config`) to receive typed, content-free reports of dropped chunks, facts, edges and failed background jobs. `useMemoryRead` and `useWikiTraversal` accept `excludeDrafts` per call, which overrides the config default. There are no dedicated hooks for listing or promoting drafts yet: call `listDrafts` / `promoteDraft` on the `WikiMemory` instance from `useWiki()`, as shown below. With `grounding` on, facts that don't quote their source land as drafts; see [core: Grounding](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#grounding). See [core: Diagnostics](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#diagnostics) and [core: Draft Review](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#draft-review). Other `WikiConfig` fields, such as `ontology`, are documented in the [core README](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#configuration).
+
+```tsx
+import { useWiki } from '@equationalapplications/expo-llm-wiki';
+
+function DraftReview({ entityId }: { entityId: string }) {
+  const wiki = useWiki(); // the WikiMemory instance; throws outside <WikiProvider>
+  const loadDrafts = () => wiki.listDrafts(entityId, { limit: 20 }); // → { facts, nextCursor }
+  // ...
+}
+```
+
+`useWiki()` also exposes the read-only health and instruction APIs for components that need them:
+
+```tsx
+function HealthAndInstructions({ entityId, batch }: { entityId: string; batch: Array<{ sourceRef: string; sourceHash: string }> }) {
+  const wiki = useWiki();
+
+  // Lint: read-only health report for one entity (dangling edges, manifest violations, drafts, etc.)
+  const loadReport = () => wiki.lint(entityId);
+  // → { danglingEdges, manifestViolations, untypedFacts, drafts, unverifiedInferred,
+  //     sample: { danglingEdgeIds, manifestViolationEdgeIds } }
+
+  // pendingSources: per-input change status including the partial-ingest state.
+  const loadStatuses = () => wiki.pendingSources(entityId, batch);
+  // → Array<{ sourceRef: string; status: 'new' | 'changed' | 'partial' | 'current' }>
+
+  // getInstructions: effective system prompts for each writer, with overrides applied.
+  const loadInstructions = () => wiki.getInstructions(entityId);
+  // → { ingest, librarian, heal, ontologyBackfill }
+}
+```
+
+See [core: Lint](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#lint), [core: Batch Change Detection](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#batch-change-detection), and [core: Effective instructions](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#effective-instructions-getinstructions).
+
 ## Retrieval Tuning
 
 Optimize `read()` performance and blend retrieval strategies:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/expo-llm-wiki",
-  "version": "7.5.0",
+  "version": "7.7.0",
   "description": "Local-first LLM memory for Expo and React Native. Combines the core semantic search and extraction engine with expo-sqlite and ready-to-use React hooks.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -55,8 +55,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@equationalapplications/core-llm-wiki": "7.5.0",
-    "@equationalapplications/react-llm-wiki": "7.5.0"
+    "@equationalapplications/core-llm-wiki": "7.7.0",
+    "@equationalapplications/react-llm-wiki": "7.7.0"
   },
   "peerDependencies": {
     "expo-crypto": ">=12",