@medicine-wheel/storage-provider 0.4.11 → 0.4.12

package/dist/index.d.ts

@@ -15,7 +15,7 @@
  * const node = await store.getNode('elder-1');
  * ```
  */
-export type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog, ProviderType, } from './interface.js';
+export type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog, WeaveRecord, WeaveSyncState, InquiryWeaveFilters, ProviderType, } from './interface.js';
 export { createProvider, detectProvider } from './factory.js';
 export { JsonlProvider } from './jsonl.js';
 export { NeonProvider } from './neon.js';

package/dist/interface.d.ts

@@ -13,6 +13,44 @@ export interface RelationalEdge extends Omit<OntologyRelationalEdge, 'id'> {
     last_ceremony?: string;
 }
 export type CeremonyLog = OntologyCeremonyLog;
+export type WeaveSyncState = 'never-synced' | 'in-sync' | 'stale' | 'episode-copy-diverged';
+export interface WeaveRecord extends Record<string, unknown> {
+    id: string;
+    weave: 1;
+    artefact: {
+        id: string;
+        path?: string;
+        [key: string]: unknown;
+    };
+    issue: string;
+    issue_url?: string;
+    episode: {
+        path: string;
+        number: number;
+        [key: string]: unknown;
+    };
+    last_sync: {
+        state: WeaveSyncState;
+        at?: string;
+        tree_sha256?: string;
+        file_count?: number;
+        bytes_total?: number;
+        [key: string]: unknown;
+    };
+    source: {
+        package: string;
+        record_path?: string;
+        registered_at: string;
+        updated_at: string;
+        [key: string]: unknown;
+    };
+}
+export interface InquiryWeaveFilters {
+    episode_path?: string;
+    episode_number?: number;
+    issue?: string;
+    artefact?: string;
+}
 export interface StorageProvider {
     readonly name: string;
     connect(): Promise<void>;
@@ -33,5 +71,8 @@ export interface StorageProvider {
     getCeremoniesByDirection(direction: DirectionName): Promise<CeremonyLog[]>;
     getCeremoniesByType(type: CeremonyType): Promise<CeremonyLog[]>;
     getAllCeremonies(limit?: number): Promise<CeremonyLog[]>;
+    registerInquiryWeave(record: WeaveRecord): Promise<void>;
+    getInquiryWeave(id: string): Promise<WeaveRecord | null>;
+    listInquiryWeaves(filters?: InquiryWeaveFilters): Promise<WeaveRecord[]>;
 }
 export type ProviderType = 'jsonl' | 'neon' | 'redis' | 'auto';

package/dist/jsonl.d.ts

@@ -1,11 +1,12 @@
 import type { DirectionName, NodeType, CeremonyType } from '@medicine-wheel/ontology-core';
-import type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog } from './interface.js';
+import type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog, WeaveRecord, InquiryWeaveFilters } from './interface.js';
 export declare class JsonlProvider implements StorageProvider {
     readonly name = "jsonl";
     readonly dataDir: string;
     private readonly nodesFile;
     private readonly edgesFile;
     private readonly ceremoniesFile;
+    private readonly inquiryWeavesFile;
     constructor(dataDir?: string);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -25,9 +26,13 @@ export declare class JsonlProvider implements StorageProvider {
     getCeremoniesByDirection(direction: DirectionName): Promise<CeremonyLog[]>;
     getCeremoniesByType(type: CeremonyType): Promise<CeremonyLog[]>;
     getAllCeremonies(limit?: number): Promise<CeremonyLog[]>;
+    registerInquiryWeave(record: WeaveRecord): Promise<void>;
+    getInquiryWeave(id: string): Promise<WeaveRecord | null>;
+    listInquiryWeaves(filters?: InquiryWeaveFilters): Promise<WeaveRecord[]>;
     private readNodes;
     private readEdges;
     private readCeremonies;
+    private readInquiryWeaves;
     private upsertById;
     private upsertEdge;
     private parseNode;

package/dist/jsonl.js

@@ -7,11 +7,13 @@ export class JsonlProvider {
     nodesFile;
     edgesFile;
     ceremoniesFile;
+    inquiryWeavesFile;
     constructor(dataDir) {
         this.dataDir = path.resolve(dataDir ?? resolveProjectDataDir());
         this.nodesFile = path.join(this.dataDir, 'nodes.jsonl');
         this.edgesFile = path.join(this.dataDir, 'edges.jsonl');
         this.ceremoniesFile = path.join(this.dataDir, 'ceremonies.jsonl');
+        this.inquiryWeavesFile = path.join(this.dataDir, 'inquiry-weaves.jsonl');
     }
     async connect() {
         ensureDirectory(this.dataDir);
@@ -118,6 +120,15 @@ export class JsonlProvider {
             .slice(0, limit)
             .map((ceremony) => this.parseCeremony(ceremony));
     }
+    async registerInquiryWeave(record) {
+        await this.upsertById(this.inquiryWeavesFile, record);
+    }
+    async getInquiryWeave(id) {
+        return this.readInquiryWeaves().find((record) => record.id === id) ?? null;
+    }
+    async listInquiryWeaves(filters = {}) {
+        return this.readInquiryWeaves().filter((record) => matchesInquiryWeaveFilters(record, filters));
+    }
     readNodes() {
         return readJsonl(this.nodesFile);
     }
@@ -127,6 +138,9 @@ export class JsonlProvider {
     readCeremonies() {
         return readJsonl(this.ceremoniesFile);
     }
+    readInquiryWeaves() {
+        return readJsonl(this.inquiryWeavesFile);
+    }
     async upsertById(filePath, item) {
         await withWriteLock(filePath, () => {
             const nextRecords = readJsonl(filePath).filter((candidate) => candidate.id !== item.id);
@@ -254,6 +268,21 @@ 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.

package/dist/neon.d.ts

@@ -2,7 +2,7 @@
  * Neon (Postgres) Storage Provider
  */
 import type { DirectionName, NodeType, CeremonyType } from '@medicine-wheel/ontology-core';
-import type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog } from './interface.js';
+import type { StorageProvider, RelationalNode, RelationalEdge, CeremonyLog, WeaveRecord, InquiryWeaveFilters } from './interface.js';
 export declare class NeonProvider implements StorageProvider {
     readonly name = "neon";
     private sql;
@@ -28,4 +28,9 @@ export declare class NeonProvider implements StorageProvider {
     getCeremoniesByType(type: CeremonyType): Promise<CeremonyLog[]>;
     getAllCeremonies(limit?: number): Promise<CeremonyLog[]>;
     private parseCeremony;
+    registerInquiryWeave(record: WeaveRecord): Promise<void>;
+    getInquiryWeave(id: string): Promise<WeaveRecord | null>;
+    listInquiryWeaves(filters?: InquiryWeaveFilters): Promise<WeaveRecord[]>;
+    private getAllInquiryWeaves;
+    private ensureInquiryWeavesTable;
 }

package/dist/neon.js

@@ -10,6 +10,7 @@ export class NeonProvider {
             throw new Error('DATABASE_URL, POSTGRES_URL, or NEON_DATABASE_URL must be set');
         const { neon } = await import('@neondatabase/serverless');
         this.sql = neon(url);
+        await this.ensureInquiryWeavesTable();
     }
     async disconnect() {
         this.sql = null;
@@ -174,6 +175,59 @@ export class NeonProvider {
             research_context: row.research_context || undefined,
         };
     }
+    // ── Inquiry Weave Operations ──
+    async registerInquiryWeave(record) {
+        await this.db `
+      INSERT INTO inquiry_weaves (id, payload, episode_path, episode_number, issue, artefact_id, updated_at)
+      VALUES (
+        ${record.id},
+        ${JSON.stringify(record)},
+        ${record.episode.path},
+        ${record.episode.number},
+        ${record.issue},
+        ${record.artefact.id},
+        NOW()
+      )
+      ON CONFLICT (id) DO UPDATE SET
+        payload = EXCLUDED.payload,
+        episode_path = EXCLUDED.episode_path,
+        episode_number = EXCLUDED.episode_number,
+        issue = EXCLUDED.issue,
+        artefact_id = EXCLUDED.artefact_id,
+        updated_at = NOW()
+    `;
+    }
+    async getInquiryWeave(id) {
+        const rows = await this.db `SELECT payload FROM inquiry_weaves WHERE id = ${id}`;
+        if (rows.length === 0)
+            return null;
+        return parseJsonValue(rows[0].payload, null);
+    }
+    async listInquiryWeaves(filters = {}) {
+        const records = await this.getAllInquiryWeaves();
+        return records.filter((record) => matchesInquiryWeaveFilters(record, filters));
+    }
+    async getAllInquiryWeaves() {
+        const rows = await this.db `SELECT payload FROM inquiry_weaves ORDER BY updated_at DESC`;
+        return rows.map((row) => parseJsonValue(row.payload, null));
+    }
+    async ensureInquiryWeavesTable() {
+        await this.db `
+      CREATE TABLE IF NOT EXISTS inquiry_weaves (
+        id TEXT PRIMARY KEY,
+        payload JSONB NOT NULL,
+        episode_path TEXT NOT NULL,
+        episode_number INTEGER NOT NULL,
+        issue TEXT NOT NULL,
+        artefact_id TEXT NOT NULL,
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+      )
+    `;
+        await this.db `CREATE INDEX IF NOT EXISTS idx_inquiry_weaves_episode_path ON inquiry_weaves(episode_path)`;
+        await this.db `CREATE INDEX IF NOT EXISTS idx_inquiry_weaves_episode_number ON inquiry_weaves(episode_number)`;
+        await this.db `CREATE INDEX IF NOT EXISTS idx_inquiry_weaves_issue ON inquiry_weaves(issue)`;
+        await this.db `CREATE INDEX IF NOT EXISTS idx_inquiry_weaves_artefact_id ON inquiry_weaves(artefact_id)`;
+    }
 }
 function getConnectionString() {
     return process.env.DATABASE_URL ?? process.env.POSTGRES_URL ?? process.env.NEON_DATABASE_URL;
@@ -198,3 +252,18 @@ 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.4.11",
+  "version": "0.4.12",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,7 @@
   "dependencies": {
     "@neondatabase/serverless": "^0.10.0",
     "@upstash/redis": "^1.34.3",
-    "@medicine-wheel/ontology-core": "^0.4.11"
+    "@medicine-wheel/ontology-core": "^0.4.12"
   },
   "devDependencies": {
     "typescript": "^5.7.0"