@medicine-wheel/storage-provider 0.5.1 → 0.5.3

package/README.md

@@ -2,6 +2,12 @@
 
 Abstract storage layer for Medicine Wheel data with JSONL and Neon backends, plus a future Redis path.
 
+> [!WARNING]
+> **Experimental alpha.** Part of the Medicine Wheel Developer Suite, which is
+> under active development. APIs change between patch versions and all packages
+> move in lockstep — pin exact versions. See
+> [ALPHA.md](https://github.com/jgwill/medicine-wheel/blob/main/ALPHA.md).
+
 ## Install
 
 ```bash

package/dist/index.d.ts

@@ -18,6 +18,7 @@
 export type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog, WeaveRecord, WeaveSyncState, InquiryWeaveFilters, PlanPerspectiveRecord, PlanPerspectiveEpisode, PlanPerspectiveFilters, CeremonialPhase, DiaryEntryType, DiaryEntryLocation, DiaryEntryMetadata, DiaryEntryRecord, DiaryEntryFilters, CeremonyEventKind, CeremonyEventParticipant, CeremonyEventRecord, CeremonyEventFilters, ProviderType, NodePatch, EdgePatch, } from './interface.js';
 export { NodeNotFoundError, EdgeNotFoundError, NodeHasRelationsError, } from './interface.js';
 export { mergePlanPerspectiveRecords, unionPlanPerspectiveEpisodes, matchesPlanPerspectiveFilters, } from './plan-perspectives.js';
+export { matchesInquiryWeaveFilters, filterInquiryWeaves, } from './inquiry-weaves.js';
 export { matchesDiaryEntryFilters, filterAndOrderDiaryEntries, } from './diary-records.js';
 export { matchesCeremonyEventFilters } from './ceremony-events.js';
 export { createProvider, detectProvider } from './factory.js';

package/dist/index.js

@@ -19,6 +19,8 @@
 export { NodeNotFoundError, EdgeNotFoundError, NodeHasRelationsError, } from './interface.js';
 // Plan Perspective merge/filter semantics (shared across providers)
 export { mergePlanPerspectiveRecords, unionPlanPerspectiveEpisodes, matchesPlanPerspectiveFilters, } from './plan-perspectives.js';
+// Inquiry Weave filter semantics (shared across providers)
+export { matchesInquiryWeaveFilters, filterInquiryWeaves, } from './inquiry-weaves.js';
 // Ceremonial Diary filter/ordering semantics (shared across providers)
 export { matchesDiaryEntryFilters, filterAndOrderDiaryEntries, } from './diary-records.js';
 // Ceremony Event filter semantics (shared across providers)

package/dist/inquiry-weaves.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Inquiry Weave filter semantics — shared across providers.
+ *
+ * Both the JSONL and Postgres providers answer the same questions about a
+ * weave; keeping the predicate in one place stops the two from drifting apart
+ * on what a filter means.
+ */
+import type { InquiryWeaveFilters, WeaveRecord } from './interface.js';
+export declare function matchesInquiryWeaveFilters(record: WeaveRecord, filters: InquiryWeaveFilters): boolean;
+/**
+ * Filter a batch of weave rows, dropping anything that did not survive the read.
+ *
+ * A Postgres payload that fails to parse arrives here as null, and every
+ * sibling record collection drops those before filtering. Without the guard a
+ * single unreadable row throws while reading `record.episode`, and the whole
+ * listing answers with an error instead of the weaves that are intact.
+ */
+export declare function filterInquiryWeaves(records: readonly (WeaveRecord | null | undefined)[], filters?: InquiryWeaveFilters): WeaveRecord[];

package/dist/inquiry-weaves.js

@@ -0,0 +1,36 @@
+/**
+ * Inquiry Weave filter semantics — shared across providers.
+ *
+ * Both the JSONL and Postgres providers answer the same questions about a
+ * weave; keeping the predicate in one place stops the two from drifting apart
+ * on what a filter means.
+ */
+export function matchesInquiryWeaveFilters(record, filters) {
+    if (filters.episode_path !== undefined && record.episode?.path !== filters.episode_path) {
+        return false;
+    }
+    if (filters.episode_number !== undefined && record.episode?.number !== filters.episode_number) {
+        return false;
+    }
+    if (filters.issue !== undefined && record.issue !== filters.issue) {
+        return false;
+    }
+    if (filters.artefact !== undefined && record.artefact?.id !== filters.artefact) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Filter a batch of weave rows, dropping anything that did not survive the read.
+ *
+ * A Postgres payload that fails to parse arrives here as null, and every
+ * sibling record collection drops those before filtering. Without the guard a
+ * single unreadable row throws while reading `record.episode`, and the whole
+ * listing answers with an error instead of the weaves that are intact.
+ */
+export function filterInquiryWeaves(records, filters = {}) {
+    return records.filter((record) => record !== null &&
+        record !== undefined &&
+        typeof record === 'object' &&
+        matchesInquiryWeaveFilters(record, filters));
+}

package/dist/jsonl.js

@@ -3,6 +3,7 @@ import * as path from 'path';
 import { randomUUID } from 'crypto';
 import { NodeNotFoundError, EdgeNotFoundError, NodeHasRelationsError, } from './interface.js';
 import { mergePlanPerspectiveRecords, matchesPlanPerspectiveFilters, } from './plan-perspectives.js';
+import { filterInquiryWeaves } from './inquiry-weaves.js';
 import { filterAndOrderDiaryEntries } from './diary-records.js';
 import { matchesCeremonyEventFilters } from './ceremony-events.js';
 export class JsonlProvider {
@@ -205,7 +206,7 @@ export class JsonlProvider {
         return this.readInquiryWeaves().find((record) => record.id === id) ?? null;
     }
     async listInquiryWeaves(filters = {}) {
-        return this.readInquiryWeaves().filter((record) => matchesInquiryWeaveFilters(record, filters));
+        return filterInquiryWeaves(this.readInquiryWeaves(), filters);
     }
     async registerPlanPerspective(record) {
         let merged = record;
@@ -402,21 +403,6 @@ function edgeKey(edge) {
 function sortByNewest(field) {
     return (left, right) => Date.parse(right[field]) - Date.parse(left[field]);
 }
-function matchesInquiryWeaveFilters(record, filters) {
-    if (filters.episode_path !== undefined && record.episode?.path !== filters.episode_path) {
-        return false;
-    }
-    if (filters.episode_number !== undefined && record.episode?.number !== filters.episode_number) {
-        return false;
-    }
-    if (filters.issue !== undefined && record.issue !== filters.issue) {
-        return false;
-    }
-    if (filters.artefact !== undefined && record.artefact?.id !== filters.artefact) {
-        return false;
-    }
-    return true;
-}
 function isProcessAlive(pid) {
     try {
         // Signal 0 checks process existence without sending a real signal.
@@ -428,6 +414,13 @@ function isProcessAlive(pid) {
     }
 }
 function isLockStale(lockPath) {
+    let mtimeMs;
+    try {
+        mtimeMs = fs.statSync(lockPath).mtimeMs;
+    }
+    catch {
+        return false; // Lock already gone — nothing to reap.
+    }
     try {
         const content = fs.readFileSync(lockPath, 'utf-8').trim();
         const parsed = JSON.parse(content);
@@ -442,7 +435,11 @@ function isLockStale(lockPath) {
         return lockAgeMs > 30_000;
     }
     catch {
-        return false;
+        // A lock file we cannot read names no owner: a writer that died between
+        // creating the file and stamping it, or a foreign lock format. Judging it
+        // permanently held would leave the entity unwritable forever, so fall back
+        // to its age — the same grace period a stamped lock gets.
+        return Date.now() - mtimeMs > 30_000;
     }
 }
 async function acquireWriteLock(lockPath) {

package/dist/neon.js

@@ -3,6 +3,7 @@
  */
 import { NodeNotFoundError, EdgeNotFoundError, NodeHasRelationsError, } from './interface.js';
 import { mergePlanPerspectiveRecords, matchesPlanPerspectiveFilters, } from './plan-perspectives.js';
+import { filterInquiryWeaves } from './inquiry-weaves.js';
 import { filterAndOrderDiaryEntries } from './diary-records.js';
 import { matchesCeremonyEventFilters } from './ceremony-events.js';
 export class NeonProvider {
@@ -283,8 +284,7 @@ export class NeonProvider {
         return parseJsonValue(rows[0].payload, null);
     }
     async listInquiryWeaves(filters = {}) {
-        const records = await this.getAllInquiryWeaves();
-        return records.filter((record) => matchesInquiryWeaveFilters(record, filters));
+        return filterInquiryWeaves(await this.getAllInquiryWeaves(), filters);
     }
     async getAllInquiryWeaves() {
         const rows = await this.db `SELECT payload FROM inquiry_weaves ORDER BY updated_at DESC`;
@@ -513,18 +513,3 @@ function parseJsonValue(value, fallback) {
     }
     return value;
 }
-function matchesInquiryWeaveFilters(record, filters) {
-    if (filters.episode_path !== undefined && record.episode?.path !== filters.episode_path) {
-        return false;
-    }
-    if (filters.episode_number !== undefined && record.episode?.number !== filters.episode_number) {
-        return false;
-    }
-    if (filters.issue !== undefined && record.issue !== filters.issue) {
-        return false;
-    }
-    if (filters.artefact !== undefined && record.artefact?.id !== filters.artefact) {
-        return false;
-    }
-    return true;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medicine-wheel/storage-provider",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,9 +16,14 @@
   "dependencies": {
     "@neondatabase/serverless": "^0.10.0",
     "@upstash/redis": "^1.34.3",
-    "@medicine-wheel/ontology-core": "^0.5.1"
+    "@medicine-wheel/ontology-core": "^0.5.3"
   },
   "devDependencies": {
     "typescript": "^5.7.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jgwill/medicine-wheel.git",
+    "directory": "src/storage-provider"
   }
 }