@karmaniverous/jeeves-meta 0.3.1 → 0.3.3

package/dist/cli.js

@@ -48,20 +48,20 @@ const synthConfigSchema = z.object({
     /** Number of metas to synthesize per invocation. */
     batchSize: z.number().int().min(1).default(1),
     /**
-     * Watcher metadata properties for live .meta/meta.json files.
-     * Virtual rules use these to tag live metas; scan queries derive
-     * their filter from the first domain value.
+     * Watcher metadata properties applied to live .meta/meta.json files.
+     * Virtual rules set these on every indexed live meta point.
+     * Discovery filter is derived from these properties.
+     * Default: `\{ _meta: "current" \}`
      */
-    metaProperty: z
-        .object({ domains: z.array(z.string()).min(1) })
-        .default({ domains: ['meta'] }),
+    metaProperty: z.record(z.string(), z.unknown()).default({ _meta: 'current' }),
     /**
-     * Watcher metadata properties for .meta/archive/** snapshots.
-     * Virtual rules use these to tag archive files.
+     * Watcher metadata properties applied to .meta/archive/** snapshots.
+     * Virtual rules set these on every indexed archive point.
+     * Default: `\{ _meta: "archive" \}`
      */
     metaArchiveProperty: z
-        .object({ domains: z.array(z.string()).min(1) })
-        .default({ domains: ['meta-archive'] }),
+        .record(z.string(), z.unknown())
+        .default({ _meta: 'archive' }),
 });
 
 /**
@@ -373,21 +373,50 @@ async function paginatedScan(watcher, params) {
  *
  * @module discovery/discoverMetas
  */
+/**
+ * Build a single Qdrant filter clause from a key-value pair.
+ *
+ * Arrays use `match.value` on the first element (Qdrant array membership).
+ * Scalars (string, number, boolean) use `match.value` directly.
+ * Objects and other non-filterable types are skipped with a warning.
+ */
+function buildMatchClause(key, value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return null;
+        return { key, match: { value: value[0] } };
+    }
+    if (typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return { key, match: { value } };
+    }
+    // Non-filterable value (object, null, etc.) — valid for tagging but
+    // cannot be expressed as a Qdrant match clause.
+    return null;
+}
 /**
  * Build a Qdrant filter from config metaProperty.
  *
+ * Iterates all key-value pairs in `metaProperty` (a generic record)
+ * to construct `must` clauses. Always appends `file_path: meta.json`
+ * for deduplication.
+ *
  * @param config - Synth config with metaProperty.
  * @returns Qdrant filter object for scanning live metas.
  */
 function buildMetaFilter(config) {
-    return {
-        must: [
-            {
-                key: 'domains',
-                match: { value: config.metaProperty.domains[0] },
-            },
-        ],
-    };
+    const must = [];
+    for (const [key, value] of Object.entries(config.metaProperty)) {
+        const clause = buildMatchClause(key, value);
+        if (clause)
+            must.push(clause);
+    }
+    must.push({
+        key: 'file_path',
+        match: { text: 'meta.json' },
+    });
+    return { must };
 }
 /**
  * Discover all .meta/ directories via watcher scan.
@@ -405,16 +434,16 @@ async function discoverMetas(config, watcher) {
         filter,
         fields: ['file_path'],
     });
-    // Deduplicate by file_path (multi-chunk files)
+    // Deduplicate by .meta/ directory path (handles multi-chunk files)
     const seen = new Set();
     const metaPaths = [];
     for (const sf of scanFiles) {
         const fp = normalizePath$1(sf.file_path);
-        if (seen.has(fp))
-            continue;
-        seen.add(fp);
         // Derive .meta/ directory from file_path (strip /meta.json)
         const metaPath = fp.replace(/\/meta\.json$/, '');
+        if (seen.has(metaPath))
+            continue;
+        seen.add(metaPath);
         metaPaths.push(metaPath);
     }
     return metaPaths;
@@ -1471,6 +1500,8 @@ async function orchestrateOnce(config, executor, watcher, targetPath) {
     const candidates = [];
     for (const node of tree.nodes.values()) {
         const meta = metas.get(node.metaPath);
+        if (!meta)
+            continue; // Node not in metas map (e.g. unreadable meta.json)
         const staleness = actualStaleness(meta);
         if (staleness > 0) {
             candidates.push({ node, meta, actualStaleness: staleness });

package/dist/index.d.ts

@@ -53,12 +53,8 @@ declare const synthConfigSchema: z.ZodObject<{
     defaultCritic: z.ZodString;
     skipUnchanged: z.ZodDefault<z.ZodBoolean>;
     batchSize: z.ZodDefault<z.ZodNumber>;
-    metaProperty: z.ZodDefault<z.ZodObject<{
-        domains: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
-    metaArchiveProperty: z.ZodDefault<z.ZodObject<{
-        domains: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
+    metaProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metaArchiveProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 /** Inferred type for jeeves-meta configuration. */
 type SynthConfig = z.infer<typeof synthConfigSchema>;
@@ -347,6 +343,10 @@ interface WatcherClient {
 /**
  * Build a Qdrant filter from config metaProperty.
  *
+ * Iterates all key-value pairs in `metaProperty` (a generic record)
+ * to construct `must` clauses. Always appends `file_path: meta.json`
+ * for deduplication.
+ *
  * @param config - Synth config with metaProperty.
  * @returns Qdrant filter object for scanning live metas.
  */

package/dist/index.js

@@ -143,20 +143,20 @@ const synthConfigSchema = z.object({
     /** Number of metas to synthesize per invocation. */
     batchSize: z.number().int().min(1).default(1),
     /**
-     * Watcher metadata properties for live .meta/meta.json files.
-     * Virtual rules use these to tag live metas; scan queries derive
-     * their filter from the first domain value.
+     * Watcher metadata properties applied to live .meta/meta.json files.
+     * Virtual rules set these on every indexed live meta point.
+     * Discovery filter is derived from these properties.
+     * Default: `\{ _meta: "current" \}`
      */
-    metaProperty: z
-        .object({ domains: z.array(z.string()).min(1) })
-        .default({ domains: ['meta'] }),
+    metaProperty: z.record(z.string(), z.unknown()).default({ _meta: 'current' }),
     /**
-     * Watcher metadata properties for .meta/archive/** snapshots.
-     * Virtual rules use these to tag archive files.
+     * Watcher metadata properties applied to .meta/archive/** snapshots.
+     * Virtual rules set these on every indexed archive point.
+     * Default: `\{ _meta: "archive" \}`
      */
     metaArchiveProperty: z
-        .object({ domains: z.array(z.string()).min(1) })
-        .default({ domains: ['meta-archive'] }),
+        .record(z.string(), z.unknown())
+        .default({ _meta: 'archive' }),
 });
 
 /**
@@ -358,21 +358,50 @@ async function paginatedScan(watcher, params) {
  *
  * @module discovery/discoverMetas
  */
+/**
+ * Build a single Qdrant filter clause from a key-value pair.
+ *
+ * Arrays use `match.value` on the first element (Qdrant array membership).
+ * Scalars (string, number, boolean) use `match.value` directly.
+ * Objects and other non-filterable types are skipped with a warning.
+ */
+function buildMatchClause(key, value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return null;
+        return { key, match: { value: value[0] } };
+    }
+    if (typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return { key, match: { value } };
+    }
+    // Non-filterable value (object, null, etc.) — valid for tagging but
+    // cannot be expressed as a Qdrant match clause.
+    return null;
+}
 /**
  * Build a Qdrant filter from config metaProperty.
  *
+ * Iterates all key-value pairs in `metaProperty` (a generic record)
+ * to construct `must` clauses. Always appends `file_path: meta.json`
+ * for deduplication.
+ *
  * @param config - Synth config with metaProperty.
  * @returns Qdrant filter object for scanning live metas.
  */
 function buildMetaFilter(config) {
-    return {
-        must: [
-            {
-                key: 'domains',
-                match: { value: config.metaProperty.domains[0] },
-            },
-        ],
-    };
+    const must = [];
+    for (const [key, value] of Object.entries(config.metaProperty)) {
+        const clause = buildMatchClause(key, value);
+        if (clause)
+            must.push(clause);
+    }
+    must.push({
+        key: 'file_path',
+        match: { text: 'meta.json' },
+    });
+    return { must };
 }
 /**
  * Discover all .meta/ directories via watcher scan.
@@ -390,16 +419,16 @@ async function discoverMetas(config, watcher) {
         filter,
         fields: ['file_path'],
     });
-    // Deduplicate by file_path (multi-chunk files)
+    // Deduplicate by .meta/ directory path (handles multi-chunk files)
     const seen = new Set();
     const metaPaths = [];
     for (const sf of scanFiles) {
         const fp = normalizePath$1(sf.file_path);
-        if (seen.has(fp))
-            continue;
-        seen.add(fp);
         // Derive .meta/ directory from file_path (strip /meta.json)
         const metaPath = fp.replace(/\/meta\.json$/, '');
+        if (seen.has(metaPath))
+            continue;
+        seen.add(metaPath);
         metaPaths.push(metaPath);
     }
     return metaPaths;
@@ -1456,6 +1485,8 @@ async function orchestrateOnce(config, executor, watcher, targetPath) {
     const candidates = [];
     for (const node of tree.nodes.values()) {
         const meta = metas.get(node.metaPath);
+        if (!meta)
+            continue; // Node not in metas map (e.g. unreadable meta.json)
         const staleness = actualStaleness(meta);
         if (staleness > 0) {
             candidates.push({ node, meta, actualStaleness: staleness });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "author": "Jason Williscroft",
   "description": "Knowledge synthesis engine for the Jeeves platform",
   "license": "BSD-3-Clause",