archgraph-argo 0.24.1 → 0.24.2

package/argo/scripts/graph-rag/defaultSemanticRetrieval.js

@@ -85,32 +85,35 @@ const CHANNELS = Object.freeze([
     indexName: 'argo_production_semantic_view_vector',
   }),
 ]);
+// Project an explicit metadata allowlist instead of properties(node): Neo4j map
+// projection `.*` lets an existing property win, so properties(node) / node{.*, vector:null}
+// would still ship the 1536-dim vector; the read path only consumes canonicalIdentity, channel, searchText and score.
 const VECTOR_QUERY_CYPHER = [
   'CALL db.index.vector.queryNodes($indexName, $topK, $vector)',
   'YIELD node, score',
   'WHERE node.channel = $channel',
-  'RETURN properties(node) AS record, score',
+  'RETURN {canonicalIdentity: node.canonicalIdentity, channel: node.channel, searchText: node.searchText, dimensions: node.dimensions, provider: node.provider, model: node.model, modelVersion: node.modelVersion, canonicalVersion: node.canonicalVersion, contentVersion: node.contentVersion, indexVersion: node.indexVersion} AS record, score',
   'ORDER BY score DESC',
 ].join('\n');
 const VECTOR_QUERY_CYPHER_SCOPED = [
   'CALL db.index.vector.queryNodes($indexName, $topK, $vector)',
   'YIELD node, score',
   'WHERE node.channel = $channel AND node.canonicalIdentity IN $canonicalIdentities',
-  'RETURN properties(node) AS record, score',
+  'RETURN {canonicalIdentity: node.canonicalIdentity, channel: node.channel, searchText: node.searchText, dimensions: node.dimensions, provider: node.provider, model: node.model, modelVersion: node.modelVersion, canonicalVersion: node.canonicalVersion, contentVersion: node.contentVersion, indexVersion: node.indexVersion} AS record, score',
   'ORDER BY score DESC',
 ].join('\n');
 const LEXICAL_QUERY_CYPHER = [
   'CALL db.index.fulltext.queryNodes($indexName, $queryText, { limit: $topK })',
   'YIELD node, score',
   'WHERE node.channel = $channel',
-  'RETURN properties(node) AS record, score',
+  'RETURN {canonicalIdentity: node.canonicalIdentity, channel: node.channel, searchText: node.searchText, dimensions: node.dimensions, provider: node.provider, model: node.model, modelVersion: node.modelVersion, canonicalVersion: node.canonicalVersion, contentVersion: node.contentVersion, indexVersion: node.indexVersion} AS record, score',
   'ORDER BY score DESC',
 ].join('\n');
 const LEXICAL_QUERY_CYPHER_SCOPED = [
   'CALL db.index.fulltext.queryNodes($indexName, $queryText, { limit: $topK })',
   'YIELD node, score',
   'WHERE node.channel = $channel AND node.canonicalIdentity IN $canonicalIdentities',
-  'RETURN properties(node) AS record, score',
+  'RETURN {canonicalIdentity: node.canonicalIdentity, channel: node.channel, searchText: node.searchText, dimensions: node.dimensions, provider: node.provider, model: node.model, modelVersion: node.modelVersion, canonicalVersion: node.canonicalVersion, contentVersion: node.contentVersion, indexVersion: node.indexVersion} AS record, score',
   'ORDER BY score DESC',
 ].join('\n');
 const READINESS_QUERY_CYPHER = [
@@ -149,6 +152,12 @@ function resolveTopK() {
   const k = envNumber('ARGO_SEMANTIC_TOP_K', DEFAULT_TOP_K);
   return Number.isInteger(k) && k > 0 ? k : DEFAULT_TOP_K;
 }
+// The single production seed gate: a retrieved record becomes a seed only when
+// its TRUE vector similarity reaches the purpose-aware threshold. Exposed so
+// acceptance tests exercise the exact predicate the retrieval runtime uses.
+function isSeedAboveThreshold(score, threshold) {
+  return Number.isFinite(score) && Number.isFinite(threshold) && score >= threshold;
+}
 const testCompositionStorage = new AsyncLocalStorage();
 
 function createDefaultSemanticRetrieval(dependencies = {}) {
@@ -828,7 +837,7 @@ async function exhaustChannel({
     for (const raw of newlyVisible) {
       if (accepted.length >= effectiveMax) break;
       const record = normalizeVectorRecord(raw, channel);
-      if (record && record.score >= effectiveThreshold && !seen.has(record.id)) {
+      if (record && isSeedAboveThreshold(record.score, effectiveThreshold) && !seen.has(record.id)) {
         seen.add(record.id);
         accepted.push(Object.freeze(record));
       }
@@ -1238,8 +1247,11 @@ module.exports = {
   memoryThresholdFor,
   auditThresholdFor,
   resolveTopK,
+  isSeedAboveThreshold,
   scopeCanonicalIdentitiesForChannel,
   bareCanonicalId,
   normalizeVectorRecord,
+  exhaustChannel,
+  exhaustLexicalChannel,
   AUDIT_PURPOSES,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archgraph-argo",
-  "version": "0.24.1",
+  "version": "0.24.2",
   "description": "Deploy the ArchGraph ARGO toolchain, skills, and rules (schema, scripts, argo-init skill, global rule) with one command.",
   "license": "MIT",
   "bin": {