stratagate-dsh 0.3.0 → 0.3.1

package/dist/plugin.js

@@ -4456,7 +4456,10 @@ var StrataGate = class _StrataGate {
           }
         });
       }
-      if (memory.graphProjector) await memory.commitMutation(() => memory.queueMissingGraphProjections());
+      if (memory.graphProjector) await memory.commitMutation(() => {
+        memory.recoverGraphNameProvenanceFailures();
+        memory.queueMissingGraphProjections();
+      });
     }
     return memory;
   }
@@ -5379,6 +5382,7 @@ var StrataGate = class _StrataGate {
         return event ? [event] : [];
       });
       if (events.length === 0) throw new Error(`Graph projection ${job.id} has no available source events`);
+      job.nameProvenanceRecoveryVersion = 1;
       job.status = "running";
       job.attempts += 1;
       job.lastError = null;
@@ -6269,6 +6273,7 @@ var StrataGate = class _StrataGate {
       priority,
       nodeIds: [],
       edgeIds: [],
+      nameProvenanceRecoveryVersion: 1,
       reason: null,
       lastError: null,
       nextRetryAt: null,
@@ -6278,6 +6283,21 @@ var StrataGate = class _StrataGate {
     this.graphProjectionJobs.set(job.id, job);
     return job;
   }
+  recoverGraphNameProvenanceFailures() {
+    const signature = /^StrataGate model did not produce a valid stratagate_project_knowledge_graph call after 2 attempts: StrataGate stratagate_project_knowledge_graph arguments were invalid: "nodes\[\d+\]\.metadataProvenance\.name\[\d+\]" must be a string(?:; "nodes\[\d+\]\.metadataProvenance\.name\[\d+\]" must be a string)*$/;
+    for (const job of this.graphProjectionJobs.values()) {
+      if (job.projectorVersion !== KNOWLEDGE_GRAPH_PROJECTOR_VERSION || job.nameProvenanceRecoveryVersion !== void 0 || job.status !== "failed" || job.attempts < DERIVATION_MAX_ATTEMPTS && job.nextRetryAt !== null || !signature.test((job.lastError ?? "").split("\n")[0].trim()) || job.sourceEventIds.length === 0 || !job.sourceEventIds.every((id) => {
+        const event = this.findEvent(id);
+        return event && (event.status === "active" || event.status === "superseded");
+      })) continue;
+      job.nameProvenanceRecoveryVersion = 1;
+      job.status = "pending";
+      job.attempts = 0;
+      job.lastError = null;
+      job.nextRetryAt = null;
+      job.updatedAt = toUtc8Iso(this.now());
+    }
+  }
   queueMissingGraphProjections() {
     const candidates = this.listAllEvents().filter((event) => event.status !== "forgotten" && event.status !== "archived").sort((left, right) => {
       const score = (event) => (event.status === "active" ? 1e4 : 0) + event.weight.mentionCount * 100 + (event.scope === "project" ? 500 : 0) + (Date.parse(event.temporal.happenedStart ?? event.temporal.mentionedAt ?? event.updatedAt) || 0) / 1e12;
@@ -7261,11 +7281,27 @@ var GRAPH_METADATA_PROVENANCE = {
   type: "object",
   additionalProperties: false,
   properties: {
-    name: { ...STRING_ARRAY, required: true },
-    aliases: { type: "array", items: GRAPH_METADATA_ENTRY },
-    tags: { type: "array", items: GRAPH_METADATA_ENTRY }
+    name: { ...STRING_ARRAY, description: 'Exact supplied Event ID strings supporting node.name, e.g. ["evt_x"]. Unlike aliases/tags, this is NOT an array of { value, sourceEventIds } objects.', required: true },
+    aliases: { type: "array", items: GRAPH_METADATA_ENTRY, description: 'One { value, sourceEventIds: ["evt_x"] } object per supported alias; value is the alias.' },
+    tags: { type: "array", items: GRAPH_METADATA_ENTRY, description: 'One { value, sourceEventIds: ["evt_x"] } object per supported tag; value is the tag.' }
   }
 };
+function normalizeGraphNameProvenance(value) {
+  const result = object(value);
+  if (!Array.isArray(result.nodes)) return value;
+  for (const candidate of result.nodes) {
+    const node = object(candidate);
+    const metadata = object(node.metadataProvenance);
+    const entries = metadata.name;
+    if (typeof node.name !== "string" || !Array.isArray(entries) || entries.length === 0) continue;
+    if (!entries.every((candidateEntry) => {
+      const entry = object(candidateEntry);
+      return entry.value === node.name && Object.keys(entry).every((key) => key === "value" || key === "sourceEventIds") && Array.isArray(entry.sourceEventIds) && entry.sourceEventIds.length > 0 && entry.sourceEventIds.every((id) => typeof id === "string");
+    })) continue;
+    metadata.name = [...new Set(entries.flatMap((entry) => entry.sourceEventIds))];
+  }
+  return value;
+}
 var GRAPH_NODE = {
   type: "object",
   additionalProperties: false,
@@ -7715,7 +7751,7 @@ Use project scope for repository decisions, user scope for stable preferences/id
     const eventIds = new Set(context.events.map((event) => event.id));
     const raw = object(await this.callStructured(
       "graphProjector",
-      `Project the supplied Events into the current Knowledge Graph, then call ${STRUCTURED_TOOLS.graphProjector.name} exactly once. Events are the sole source of truth; never use legacy Element data. Return only nodes and edges touched by the supplied Events; never echo unchanged historical graph records. Return at most 24 nodes and 32 edges. Use stable entity nodes for people, projects, organizations, tools, and places. Use aliases to merge spelling/case/separator variants. Give every returned node 1-6 concise semantic role tags such as benchmark, evaluation, memory-plugin, parser, or development-tool; tags describe the node's specific role and never replace its person/project/organization/tool/place type. Reuse stable tag wording when possible. For every node name, alias, and tag, include metadataProvenance with the exact supplied Event ids that support that individual value; never use an unrelated active Event as a substitute. Put attributes in node facts and every relationship in a directed edge using fromRef/toRef\u2014never encode a relationship as a fact string. Prefer concise canonical Chinese relation labels such as \u4F7F\u7528\u3001\u5C5E\u4E8E\u3001\u521B\u5EFA\u3001\u53C2\u4E0E\u3001\u8D21\u732E\u3001\u4F9D\u8D56\u3001\u4F4D\u4E8E\u3001\u76F8\u5173. Every node, fact, edge, and metadata provenance id must cite only supplied Event ids. Do not return text.`,
+      `Project the supplied Events into the current Knowledge Graph, then call ${STRUCTURED_TOOLS.graphProjector.name} exactly once. Events are the sole source of truth; never use legacy Element data. Return only nodes and edges touched by the supplied Events; never echo unchanged historical graph records. Return at most 24 nodes and 32 edges. Use stable entity nodes for people, projects, organizations, tools, and places. Use aliases to merge spelling/case/separator variants. Give every returned node 1-6 concise semantic role tags such as benchmark, evaluation, memory-plugin, parser, or development-tool; tags describe the node's specific role and never replace its person/project/organization/tool/place type. Reuse stable tag wording when possible. For every node name, alias, and tag, include metadataProvenance with the exact supplied Event ids that support that individual value; never use an unrelated active Event as a substitute. The shapes are different: metadataProvenance.name is an Event ID string array, e.g. ["evt_x"], supporting node.name; it is never an array of objects. Only metadataProvenance.aliases and metadataProvenance.tags are arrays of { value, sourceEventIds: ["evt_x"] } objects for each alias/tag. Example for node.name="StrataGate": metadataProvenance={"name":["evt_x"],"aliases":[{"value":"strata_gate","sourceEventIds":["evt_x"]}],"tags":[{"value":"memory-plugin","sourceEventIds":["evt_x"]}]}. Put attributes in node facts and every relationship in a directed edge using fromRef/toRef\u2014never encode a relationship as a fact string. Prefer concise canonical Chinese relation labels such as \u4F7F\u7528\u3001\u5C5E\u4E8E\u3001\u521B\u5EFA\u3001\u53C2\u4E0E\u3001\u8D21\u732E\u3001\u4F9D\u8D56\u3001\u4F4D\u4E8E\u3001\u76F8\u5173. Every node, fact, edge, and metadata provenance id must cite only supplied Event ids. Do not return text.`,
       compactGraphProjectionContext(context)
     ));
     const nodes = (Array.isArray(raw.nodes) ? raw.nodes : []).flatMap((candidate) => {
@@ -7863,6 +7899,7 @@ Use project scope for repository decisions, user scope for stable preferences/id
     let lastResponse = "";
     let attemptsUsed = 0;
     let noAdapterRetried = false;
+    let graphRetryFeedback = "";
     for (let attempt = 1; attempt <= JSON_RESPONSE_ATTEMPTS; attempt += 1) {
       attemptsUsed = attempt;
       const message = createUserMessage({
@@ -7876,7 +7913,7 @@ Use project scope for repository decisions, user scope for stable preferences/id
         messages: [message],
         system: attempt === 1 ? system : `${system}
 
-${JSON_RETRY_INSTRUCTION}`,
+${JSON_RETRY_INSTRUCTION}${graphRetryFeedback}`,
         tools: [{
           name: STRUCTURED_TOOLS[kind].name,
           description: STRUCTURED_TOOLS[kind].description,
@@ -7953,8 +7990,14 @@ ${JSON_RETRY_INSTRUCTION}`,
             );
           }
         }
+        if (kind === "graphProjector") parsed = normalizeGraphNameProvenance(parsed);
         const violations = validateArgs(STRUCTURED_TOOLS[kind].parameters, parsed);
         if (violations.length > 0) {
+          if (kind === "graphProjector") {
+            const paths = violations.flatMap((violation) => violation.match(/nodes\[\d+\]\.metadataProvenance\.name(?:\[\d+\])?/g) ?? []);
+            graphRetryFeedback = paths.length > 0 ? `
+Correct these canonical-name provenance fields: ${[...new Set(paths)].slice(0, 24).join(", ")}. metadataProvenance.name must be an array of supplied Event ID strings, e.g. ["evt_x"], supporting the actual node.name. Only aliases/tags use { value, sourceEventIds } objects. Do not substitute provenance for a different name.` : "";
+          }
           throw new ModelJsonResponseError(
             `StrataGate ${expectedTool} arguments were invalid: ${kind === "topicProjector" ? "structured topic schema mismatch" : violations.join("; ")}`,
             { response: responseForError }