@plur-ai/core 0.9.5 → 0.9.7

package/dist/index.d.ts

@@ -2252,6 +2252,16 @@ declare class Plur {
      * freshness and closes the race. See issue #25.
      */
     private _writeEngrams;
+    /**
+     * Resolve a remote store for a write scope. Returns the RemoteStore driver
+     * if the engram's scope matches a registered remote entry, else null.
+     *
+     * Match rule (pilot scope): exact-match `entry.scope === engramScope`. We
+     * intentionally don't do prefix-match yet — agents that want to write to a
+     * narrower scope than they registered must explicitly register the narrower
+     * scope. Keeps routing predictable and prevents accidental cross-team writes.
+     */
+    private _resolveRemoteStoreForScope;
     /** Find which store owns an engram by ID. For namespaced IDs, strips prefix to find in store. */
     private _findEngramStore;
     /** Content hash fast-path dedup. */

package/dist/index.js

@@ -283,10 +283,31 @@ var PlurConfigSchema = z.object({
 // src/config.ts
 function loadConfig(configPath) {
   if (!existsSync3(configPath)) return PlurConfigSchema.parse({});
+  let raw;
   try {
-    const raw = yaml.load(readFileSync(configPath, "utf8"));
-    return PlurConfigSchema.parse(raw ?? {});
-  } catch {
+    raw = yaml.load(readFileSync(configPath, "utf8")) ?? {};
+  } catch (err) {
+    logger.warning(`[plur:config] cannot parse YAML at ${configPath}: ${err.message} \u2014 falling back to defaults`);
+    return PlurConfigSchema.parse({});
+  }
+  if (Array.isArray(raw.stores)) {
+    const validStores = [];
+    for (let i = 0; i < raw.stores.length; i++) {
+      const entry = raw.stores[i];
+      const parsed = StoreEntrySchema.safeParse(entry);
+      if (parsed.success) {
+        validStores.push(entry);
+      } else {
+        const label = entry?.scope ?? entry?.url ?? entry?.path ?? `index ${i}`;
+        logger.warning(`[plur:config] dropping invalid stores[${i}] (${label}) from ${configPath}: ${parsed.error.issues.map((it) => it.message).join("; ")}`);
+      }
+    }
+    raw.stores = validStores;
+  }
+  try {
+    return PlurConfigSchema.parse(raw);
+  } catch (err) {
+    logger.warning(`[plur:config] top-level config invalid at ${configPath}: ${err.message} \u2014 falling back to defaults`);
     return PlurConfigSchema.parse({});
   }
 }
@@ -3442,6 +3463,31 @@ var Plur = class {
     saveEngrams(path3, engrams);
     this._engramCache.delete(path3);
   }
+  /**
+   * Resolve a remote store for a write scope. Returns the RemoteStore driver
+   * if the engram's scope matches a registered remote entry, else null.
+   *
+   * Match rule (pilot scope): exact-match `entry.scope === engramScope`. We
+   * intentionally don't do prefix-match yet — agents that want to write to a
+   * narrower scope than they registered must explicitly register the narrower
+   * scope. Keeps routing predictable and prevents accidental cross-team writes.
+   */
+  _resolveRemoteStoreForScope(scope) {
+    const stores = this.config.stores ?? [];
+    for (const entry of stores) {
+      if (!entry.url) continue;
+      if (entry.readonly === true) continue;
+      if (entry.scope !== scope) continue;
+      const key = `${entry.url}::${entry.scope}`;
+      let driver = this._remoteStores.get(key);
+      if (!driver) {
+        driver = new RemoteStore(entry.url, entry.token ?? "", entry.scope);
+        this._remoteStores.set(key, driver);
+      }
+      return driver;
+    }
+    return null;
+  }
   /** Find which store owns an engram by ID. For namespaced IDs, strips prefix to find in store. */
   _findEngramStore(id) {
     const primaryEngrams = this._loadCached(this.paths.engrams);
@@ -3572,6 +3618,19 @@ var Plur = class {
         } : void 0,
         pinned: context?.pinned === true ? true : void 0
       };
+      const remoteDriver = this._resolveRemoteStoreForScope(scope);
+      if (remoteDriver) {
+        void remoteDriver.append(engram).catch((err) => {
+          logger.error(`[plur:learn] remote append failed for ${engram.id} (scope=${scope}): ${err.message}`);
+        });
+        appendHistory(this.paths.root, {
+          event: "engram_created",
+          engram_id: engram.id,
+          timestamp: now,
+          data: { type: engram.type, scope: engram.scope, source: engram.source, routed_to: "remote" }
+        });
+        return engram;
+      }
       engrams.push(engram);
       this._writeEngrams(this.paths.engrams, engrams);
       this._syncIndex();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/core",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",