@productbrain/mcp 0.0.1-beta.75 → 0.0.1-beta.77

package/dist/{chunk-UEUFJX5P.js → chunk-ZY3ORYC3.js}

@@ -1227,6 +1227,19 @@ function withEnvelope(handler) {
   };
 }
 
+// src/lib/fieldTypes.ts
+var FIELD_TYPE_DEFAULTS = {
+  "string": "",
+  "text": "",
+  "rich-text": "",
+  "number": null,
+  "boolean": false,
+  "select": null,
+  "multi-select": [],
+  "array": [],
+  "json": null
+};
+
 // src/tools/smart-capture-routing.ts
 var STARTER_COLLECTIONS = CLASSIFIABLE_COLLECTIONS;
 
@@ -2123,7 +2136,17 @@ var captureSuccessOutputSchema = z2.object({
   qualityScore: z2.number(),
   qualityVerdict: z2.record(z2.unknown()).optional(),
   classifier: captureClassifierSchema.optional(),
-  studioUrl: z2.string().optional()
+  studioUrl: z2.string().optional(),
+  warnings: z2.array(z2.string()).optional(),
+  normalization: z2.object({
+    remapped: z2.record(z2.string()).optional(),
+    rejected: z2.array(z2.string()).optional()
+  }).optional(),
+  expectedFields: z2.array(z2.object({
+    key: z2.string(),
+    type: z2.string(),
+    required: z2.boolean().optional()
+  })).optional()
 }).strict();
 var captureClassifierOnlyOutputSchema = z2.object({
   classifier: captureClassifierSchema
@@ -2140,7 +2163,12 @@ var batchCaptureOutputSchema = z2.object({
     status: z2.enum(["draft", "committed", "proposed"]),
     classifiedBy: z2.enum(["llm", "heuristic", "explicit"]).optional(),
     confidence: z2.number().optional(),
-    confidenceTier: z2.enum(["high", "medium", "low"]).optional()
+    confidenceTier: z2.enum(["high", "medium", "low"]).optional(),
+    warnings: z2.array(z2.string()).optional(),
+    normalization: z2.object({
+      remapped: z2.record(z2.string()).optional(),
+      rejected: z2.array(z2.string()).optional()
+    }).optional()
   })),
   total: z2.number(),
   failed: z2.number(),
@@ -2169,6 +2197,17 @@ var batchCaptureOutputSchema = z2.object({
 function shouldAutoCommitCapture(autoCommit, governanceMode) {
   return autoCommit === true || autoCommit === void 0 && governanceMode === "open";
 }
+function buildDataFromFields(fields, descriptionField, descriptionValue) {
+  const data = {};
+  for (const field of fields) {
+    if (field.key === descriptionField) {
+      data[field.key] = descriptionValue;
+    } else {
+      data[field.key] = FIELD_TYPE_DEFAULTS[field.type] ?? null;
+    }
+  }
+  return data;
+}
 function registerSmartCaptureTools(server) {
   const captureTool = server.registerTool(
     "capture",
@@ -2230,19 +2269,8 @@ Or use \`collections action=list\` to see available collections.`
           )
         };
       }
-      const data = {};
+      const data = buildDataFromFields(col.fields ?? [], profile.descriptionField, description);
       const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-      for (const field of col.fields ?? []) {
-        const key = field.key;
-        if (key === profile.descriptionField) {
-          data[key] = description;
-        } else if (field.type === "array" || field.type === "multi-select") {
-          data[key] = [];
-        } else if (field.type === "select") {
-        } else {
-          data[key] = "";
-        }
-      }
       for (const def of profile.defaults) {
         if (def.value === "today") {
           data[def.key] = today;
@@ -2287,10 +2315,43 @@ Or use \`collections action=list\` to see available collections.`
         }
         data.links = betLinks;
       }
+      const E2_LLM_REMAP_ENABLED = false;
+      const payloadForPreview = E2_LLM_REMAP_ENABLED && userData && typeof userData === "object" ? { ...data } : null;
+      if (payloadForPreview) {
+        try {
+          const preview = await mcpCall(
+            "chain.normalizeEntryDataPreview",
+            { collectionSlug: resolvedCollection, data: payloadForPreview }
+          );
+          const rejected = (preview?.rejected ?? []).filter((k) => k !== "name");
+          if (rejected.length > 0) {
+            const llmResult = await mcpCall(
+              "chain.normalizeEntryDataLLM",
+              {
+                collectionSlug: resolvedCollection,
+                unknownKeys: rejected,
+                data: payloadForPreview
+              }
+            );
+            if (llmResult && Object.keys(llmResult.remapped).length > 0) {
+              const fieldKeySet = new Set((col.fields ?? []).map((f) => f.key));
+              for (const [oldKey, newKey] of Object.entries(llmResult.remapped)) {
+                if (data[oldKey] !== void 0 && !fieldKeySet.has(oldKey)) {
+                  data[newKey] = data[oldKey];
+                  delete data[oldKey];
+                }
+              }
+            }
+          }
+        } catch {
+        }
+      }
       const status = "draft";
       const agentId = getAgentSessionId();
       let finalEntryId;
       let internalId;
+      let entryWarnings = [];
+      let normalizationMeta;
       try {
         const result = await mcpMutation("chain.createEntry", {
           collectionSlug: resolvedCollection,
@@ -2304,6 +2365,8 @@ Or use \`collections action=list\` to see available collections.`
         });
         internalId = result.docId;
         finalEntryId = result.entryId;
+        entryWarnings = result.warnings ?? [];
+        normalizationMeta = result.normalization;
         resolveGapsForEntry(name, result.entryId);
       } catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
@@ -2333,6 +2396,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       const linksCreated = [];
       const linksSuggested = [];
       const userLinkResults = [];
+      const pendingRelations = [];
       const skipAutoDiscovery = links && links.length > 0;
       const searchQuery = extractSearchTerms(name, description);
       if (searchQuery && !skipAutoDiscovery) {
@@ -2351,63 +2415,95 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             confidenceReason: conf.reason
           };
         }).sort((a, b) => b.confidence - a.confidence);
+        let autoCount = 0;
         for (const c of candidates) {
-          if (linksCreated.length >= MAX_AUTO_LINKS) break;
+          if (autoCount >= MAX_AUTO_LINKS) break;
           if (c.confidence < AUTO_LINK_CONFIDENCE_THRESHOLD) break;
           if (!c.entryId || !finalEntryId) continue;
           const { type: relationType, reason: relationReason } = inferRelationType(resolvedCollection, c.collSlug, profile);
-          try {
-            await mcpMutation("chain.createEntryRelation", {
-              fromEntryId: finalEntryId,
-              toEntryId: c.entryId,
-              type: relationType,
-              sessionId: agentId ?? void 0
-            });
-            linksCreated.push({
-              targetEntryId: c.entryId,
+          pendingRelations.push({
+            fromEntryId: finalEntryId,
+            toEntryId: c.entryId,
+            type: relationType,
+            meta: {
+              source: "auto",
               targetName: c.name,
               targetCollection: c.collSlug,
-              relationType,
               linkReason: `confidence ${c.confidence} (${c.confidenceReason}) + ${relationReason}`
-            });
-          } catch {
-          }
+            }
+          });
+          autoCount++;
         }
-        const linkedIds = new Set(linksCreated.map((l) => l.targetEntryId));
+        const autoTargetIds = new Set(pendingRelations.map((r) => r.toEntryId));
         for (const c of candidates) {
           if (linksSuggested.length >= MAX_SUGGESTIONS) break;
-          if (linkedIds.has(c.entryId)) continue;
+          if (autoTargetIds.has(c.entryId)) continue;
           if (c.confidence < 10) continue;
           const preview = extractPreview(c.data, 80);
           const reason = c.confidence >= AUTO_LINK_CONFIDENCE_THRESHOLD ? "high relevance (already linked)" : `"${c.name.toLowerCase().split(/\s+/).filter((w) => `${name} ${description}`.toLowerCase().includes(w) && w.length > 3).slice(0, 2).join('", "')}" appears in content`;
-          linksSuggested.push({
-            entryId: c.entryId,
-            name: c.name,
-            collection: c.collSlug,
-            reason,
-            preview
-          });
+          linksSuggested.push({ entryId: c.entryId, name: c.name, collection: c.collSlug, reason, preview });
         }
       }
       if (links && links.length > 0 && finalEntryId) {
         for (const link of links) {
-          try {
-            await mcpMutation("chain.createEntryRelation", {
-              fromEntryId: finalEntryId,
-              toEntryId: link.to,
-              type: link.type,
-              sessionId: agentId ?? void 0
-            });
-            userLinkResults.push({ label: `\u2713 ${link.type} \u2192 ${link.to}`, ok: true });
-            linksCreated.push({
-              targetEntryId: link.to,
-              targetName: link.to,
-              targetCollection: "unknown",
-              relationType: link.type
-            });
-          } catch (e) {
-            const msg = e instanceof Error ? e.message : "failed";
-            userLinkResults.push({ label: `\u2717 ${link.type} \u2192 ${link.to}: ${msg}`, ok: false });
+          pendingRelations.push({
+            fromEntryId: finalEntryId,
+            toEntryId: link.to,
+            type: link.type,
+            meta: { source: "user", targetName: link.to, targetCollection: "unknown" }
+          });
+        }
+      }
+      const resolvedCK = canonicalKey;
+      const batchRelationsPromise = pendingRelations.length > 0 ? mcpMutation(
+        "chain.createEntryRelations",
+        {
+          relations: pendingRelations.slice(0, 25).map((r) => ({ fromEntryId: r.fromEntryId, toEntryId: r.toEntryId, type: r.type })),
+          sessionId: agentId ?? void 0
+        }
+      ).catch((err) => {
+        entryWarnings.push(`Auto-linking partially failed: ${err instanceof Error ? err.message : "unknown error"}`);
+        return null;
+      }) : Promise.resolve(null);
+      const cardinalityPromise = resolvedCK ? mcpQuery("chain.checkCardinalityWarning", { canonicalKey: resolvedCK }).catch(() => null) : Promise.resolve(null);
+      const contradictionPromise = runContradictionCheck(name, description);
+      const coachingPromise = mcpMutation("quality.evaluateHeuristicAndSchedule", {
+        entryId: finalEntryId,
+        context: "capture"
+      }).catch(() => null);
+      const [batchResult, cardinalityCheck, contradictionWarnings, verdictResult] = await Promise.all([
+        batchRelationsPromise,
+        cardinalityPromise,
+        contradictionPromise,
+        coachingPromise
+      ]);
+      if (batchResult) {
+        for (let i = 0; i < pendingRelations.length; i++) {
+          const pending = pendingRelations[i];
+          const result = batchResult.results[i];
+          if (!result) continue;
+          if (pending.meta.source === "auto") {
+            if (result.ok) {
+              linksCreated.push({
+                targetEntryId: pending.toEntryId,
+                targetName: pending.meta.targetName,
+                targetCollection: pending.meta.targetCollection,
+                relationType: pending.type,
+                linkReason: pending.meta.linkReason
+              });
+            }
+          } else {
+            if (result.ok) {
+              userLinkResults.push({ label: `\u2713 ${pending.type} \u2192 ${pending.toEntryId}`, ok: true });
+              linksCreated.push({
+                targetEntryId: pending.toEntryId,
+                targetName: pending.meta.targetName,
+                targetCollection: pending.meta.targetCollection,
+                relationType: pending.type
+              });
+            } else {
+              userLinkResults.push({ label: `\u2717 ${pending.type} \u2192 ${pending.toEntryId}: ${result.error ?? "failed"}`, ok: false });
+            }
           }
         }
       }
@@ -2424,34 +2520,13 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         collectionFields: col.fields ?? []
       };
       const quality = scoreQuality(captureCtx, profile);
-      let cardinalityWarning = null;
-      const resolvedCK = canonicalKey ?? captureCtx.canonicalKey;
-      if (resolvedCK) {
-        try {
-          const check = await mcpQuery("chain.checkCardinalityWarning", {
-            canonicalKey: resolvedCK
-          });
-          if (check?.warning) {
-            cardinalityWarning = check.warning;
-          }
-        } catch {
-        }
-      }
-      const contradictionWarnings = await runContradictionCheck(name, description);
+      const cardinalityWarning = cardinalityCheck?.warning ?? null;
       if (contradictionWarnings.length > 0) {
         await recordSessionActivity({ contradictionWarning: true });
       }
       let coachingSection = "";
-      let verdictResult = null;
-      try {
-        verdictResult = await mcpMutation("quality.evaluateHeuristicAndSchedule", {
-          entryId: finalEntryId,
-          context: "capture"
-        });
-        if (verdictResult?.verdict && verdictResult.verdict.tier !== "passive" && verdictResult.verdict.criteria.length > 0) {
-          coachingSection = formatRubricCoaching(verdictResult);
-        }
-      } catch {
+      if (verdictResult?.verdict && verdictResult.verdict.tier !== "passive" && verdictResult.verdict.criteria.length > 0) {
+        coachingSection = formatRubricCoaching(verdictResult);
       }
       if (verdictResult?.verdict) {
         try {
@@ -2596,6 +2671,13 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         }
         lines.push("Run `context action=gather` on these entries before committing.");
       }
+      if (entryWarnings.length > 0) {
+        lines.push("");
+        lines.push("## Validation Warnings");
+        for (const w of entryWarnings) {
+          lines.push(`- ${w}`);
+        }
+      }
       if (coachingSection) {
         lines.push("");
         lines.push(coachingSection);
@@ -2646,6 +2728,11 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         next.push({ tool: "commit-entry", description: "Commit to Chain", parameters: { entryId: finalEntryId } });
       }
       const summary = finalStatus === "committed" ? `Captured and committed ${finalEntryId} (${name}) to ${resolvedCollection}. Quality ${quality.score}/10.` : finalStatus === "proposed" ? `Captured ${finalEntryId} (${name}) in ${resolvedCollection} and created a proposal for commit. Quality ${quality.score}/10.` : `Captured ${finalEntryId} (${name}) as draft in ${resolvedCollection}. Quality ${quality.score}/10.`;
+      const expectedFields = (col.fields ?? []).map((f) => ({
+        key: f.key,
+        type: f.type,
+        ...f.required && { required: true }
+      }));
       const toolResult = {
         content: [{ type: "text", text: lines.join("\n") }],
         structuredContent: success(
@@ -2658,7 +2745,15 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             qualityScore: quality.score,
             qualityVerdict: verdictResult?.verdict ? { ...verdictResult.verdict, source: verdictResult.source ?? "heuristic" } : void 0,
             ...classifierMeta && { classifier: classifierMeta },
-            ...studioUrl && { studioUrl }
+            ...studioUrl && { studioUrl },
+            ...entryWarnings.length > 0 && { warnings: entryWarnings },
+            ...normalizationMeta && (Object.keys(normalizationMeta.remapped).length > 0 || normalizationMeta.rejected.length > 0) && {
+              normalization: {
+                remapped: normalizationMeta.remapped,
+                rejected: normalizationMeta.rejected
+              }
+            },
+            expectedFields
           },
           next
         )
@@ -2759,19 +2854,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           });
           continue;
         }
-        const data = {};
+        const data = buildDataFromFields(col.fields ?? [], profile.descriptionField, entry.description);
         const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-        for (const field of col.fields ?? []) {
-          const key = field.key;
-          if (key === profile.descriptionField) {
-            data[key] = entry.description;
-          } else if (field.type === "array" || field.type === "multi-select") {
-            data[key] = [];
-          } else if (field.type === "select") {
-          } else {
-            data[key] = "";
-          }
-        }
         for (const def of profile.defaults) {
           if (def.value === "today") data[def.key] = today;
           else if (def.value !== "infer") data[def.key] = def.value;
@@ -2806,6 +2890,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           });
           const internalId = result.docId;
           const finalEntryId = result.entryId;
+          const batchEntryWarnings = result.warnings ?? [];
           resolveGapsForEntry(entry.name, result.entryId);
           let finalStatus = "draft";
           let commitError;
@@ -2816,27 +2901,22 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
               const searchResults = await mcpQuery("chain.searchEntries", { query: searchQuery });
               const candidates = (searchResults ?? []).filter((r) => r.entryId !== finalEntryId).map((r) => {
                 const conf = computeLinkConfidence(r, entry.name, entry.description, resolvedSlug, collIdToSlug.get(r.collectionId) ?? "unknown");
-                return {
-                  ...r,
-                  collSlug: collIdToSlug.get(r.collectionId) ?? "unknown",
-                  confidence: conf.score
-                };
+                return { ...r, collSlug: collIdToSlug.get(r.collectionId) ?? "unknown", confidence: conf.score };
               }).sort((a, b) => b.confidence - a.confidence);
+              const batchAutoLinks = [];
               for (const c of candidates) {
-                if (autoLinkCount >= MAX_AUTO_LINKS) break;
+                if (batchAutoLinks.length >= MAX_AUTO_LINKS) break;
                 if (c.confidence < AUTO_LINK_CONFIDENCE_THRESHOLD) break;
                 if (!c.entryId) continue;
                 const { type: relationType } = inferRelationType(resolvedSlug, c.collSlug, profile);
-                try {
-                  await mcpMutation("chain.createEntryRelation", {
-                    fromEntryId: finalEntryId,
-                    toEntryId: c.entryId,
-                    type: relationType,
-                    sessionId: agentId ?? void 0
-                  });
-                  autoLinkCount++;
-                } catch {
-                }
+                batchAutoLinks.push({ fromEntryId: finalEntryId, toEntryId: c.entryId, type: relationType });
+              }
+              if (batchAutoLinks.length > 0) {
+                const batchRes = await mcpMutation("chain.createEntryRelations", {
+                  relations: batchAutoLinks,
+                  sessionId: agentId ?? void 0
+                });
+                autoLinkCount = batchRes.created;
               }
             } catch {
             }
@@ -2856,6 +2936,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
               commitError = error instanceof Error ? error.message : String(error);
             }
           }
+          const entryNorm = result.normalization;
           results.push({
             name: entry.name,
             collection: resolvedSlug,
@@ -2866,7 +2947,11 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             classifiedBy,
             confidence,
             confidenceTier,
-            ...commitError ? { commitError } : {}
+            ...commitError ? { commitError } : {},
+            ...batchEntryWarnings.length > 0 ? { warnings: batchEntryWarnings } : {},
+            ...entryNorm && (Object.keys(entryNorm.remapped).length > 0 || entryNorm.rejected.length > 0) && {
+              normalization: { remapped: entryNorm.remapped, rejected: entryNorm.rejected }
+            }
           });
         } catch (error) {
           const msg = error instanceof Error ? error.message : String(error);
@@ -2964,6 +3049,14 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
           lines.push(`- **${r.entryId}**: ${r.name} [${r.collection}] \u2014 ${r.commitError}`);
         }
       }
+      const entriesWithWarnings = created.filter((r) => r.warnings && r.warnings.length > 0);
+      if (entriesWithWarnings.length > 0) {
+        lines.push("");
+        lines.push("## Validation Warnings");
+        for (const r of entriesWithWarnings) {
+          lines.push(`- **${r.entryId}** (${r.name}): ${r.warnings.join("; ")}`);
+        }
+      }
       if (failed.length > 0) {
         lines.push("");
         lines.push("## Failed");
@@ -3016,7 +3109,9 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
               status: r.status,
               ...r.classifiedBy ? { classifiedBy: r.classifiedBy } : {},
               ...r.confidence != null ? { confidence: r.confidence } : {},
-              ...r.confidenceTier ? { confidenceTier: r.confidenceTier } : {}
+              ...r.confidenceTier ? { confidenceTier: r.confidenceTier } : {},
+              ...r.warnings?.length ? { warnings: r.warnings } : {},
+              ...r.normalization ? { normalization: r.normalization } : {}
             })),
             total: created.length,
             failed: failed.length,
@@ -3308,4 +3403,4 @@ export {
   formatRubricCoaching,
   formatRubricVerdictSection
 };
-//# sourceMappingURL=chunk-UEUFJX5P.js.map
+//# sourceMappingURL=chunk-ZY3ORYC3.js.map