@barivia/barsom-mcp 0.23.12 → 0.23.13

package/dist/shared.js

@@ -66,7 +66,7 @@ function newRequestId() {
  * X-Barsom-Client-Version so the server can annotate tool guidance with the
  * wrapper version each action requires. Keep in sync with package.json on bump.
  */
-export const CLIENT_VERSION = "0.23.12";
+export const CLIENT_VERSION = "0.23.13";
 /** User-facing links; keep aligned with barivia.se / api.barivia.se. */
 export const PUBLIC_SITE_ORIGIN = "https://barivia.se";
 /** Self-serve account dashboard (manage plan, billing, and API keys). */

package/dist/tools/results.js

@@ -40,7 +40,7 @@ action=recolor: Change colormap or output format — no retraining. Returns a ne
   AFTER: use results(action=get, job_id=NEW_JOB_ID).
   Colormaps: viridis, plasma, inferno, magma, cividis, turbo, coolwarm, balance, hsv, twilight, RdBu, Spectral. Also: thermal, hot, grays, RdYlBu, delta, curl, phase, rainbow, tol_bright, tol_muted.
 
-action=feature_divergences: Recompute component-plane divergences (min-shift sum-normalized denormalized planes). Finalize already writes symmetric KL + rankings; use this for Wasserstein or a refresh. metrics default ["symmetric_kl","directed_kl"]; add "wasserstein" for W1. Auto-polls then summarizes top pairs vs Pearson top_correlations.
+action=feature_divergences: Recompute component-plane divergences (min-shift sum-normalized denormalized planes). Finalize already writes directed KL heatmap (divergence_kl: cell (i,j)=KL(pᵢ‖pⱼ); upper/lower triangles opposite directions) plus SKL pair tops and mean-outgoing ranking in JSON; use this for Wasserstein or a refresh. metrics default ["symmetric_kl","directed_kl"]; add "wasserstein" for W1. Auto-polls then summarizes top pairs vs Pearson top_correlations.
 
 NOT FOR: Jobs that haven't completed (use jobs(action=status) first), or temporal flow (use inference(action=transition_flow)).`, {
         action: z
@@ -419,7 +419,7 @@ NOT FOR: Jobs that haven't completed (use jobs(action=status) first), or tempora
                     ...(topCorrLine ? ["", topCorrLine] : []),
                     ...(topDivLine ? [topDivLine] : []),
                     ...(klComplexityLine ? [klComplexityLine] : []),
-                    ...(topDivLine || klComplexityLine ? ["(Compare Pearson vs KL: high |r| ≠ low KL; use results(action=feature_divergences, metrics=[\"wasserstein\"]) for W1.)"] : []),
+                    ...(topDivLine || klComplexityLine ? ["(divergence_kl.png is directed KL: cell (i,j)=KL(pᵢ‖pⱼ), upper/lower triangles opposite directions. Compare Pearson vs SKL pair tops; use results(action=feature_divergences, metrics=[\"wasserstein\"]) for W1.)"] : []),
                     ...(siom ? ["", "SIOM layer coverage (distinct from grid dead nodes):",
                         `  Utilization: ${siom.utilization !== undefined ? Number(siom.utilization).toFixed(4) : "N/A"}`,
                         `  SIOM dead fraction: ${siom.dead_fraction !== undefined ? Number(siom.dead_fraction).toFixed(4) : "N/A"}`,
@@ -732,19 +732,19 @@ NOT FOR: Jobs that haven't completed (use jobs(action=status) first), or tempora
             const topW1 = sum.top_wasserstein ?? null;
             const lines = [
                 `Feature divergences complete — job_id: ${newJobId} (parent training: ${job_id})`,
-                `Method: ${sum.divergence_method ?? "symmetric_kl_min_shift_sum_norm_denormalized_component_planes"}`,
+                `Method: ${sum.divergence_method ?? "kl_min_shift_sum_norm_denormalized_component_planes"}`,
                 `Weight space: ${sum.weight_space ?? "denormalized"}`,
                 `Metrics: ${JSON.stringify(sum.metrics ?? body.metrics)}`,
                 topDivs.length
                     ? `Top symmetric KL pairs: ${topDivs.map((t) => `${t.f1}&${t.f2}=${typeof t.symmetric_kl === "number" ? Number(t.symmetric_kl).toFixed(3) : t.symmetric_kl}`).join(", ")}`
                     : "",
                 klComp.length
-                    ? `KL complexity ranking: ${klComp.map((t) => `${t.feature}=${typeof t.mean_outgoing_kl === "number" ? Number(t.mean_outgoing_kl).toFixed(3) : t.mean_outgoing_kl}`).join(", ")}`
+                    ? `KL complexity ranking (mean outgoing directed KL): ${klComp.map((t) => `${t.feature}=${typeof t.mean_outgoing_kl === "number" ? Number(t.mean_outgoing_kl).toFixed(3) : t.mean_outgoing_kl}`).join(", ")}`
                     : "",
                 topW1 && topW1.length
                     ? `Top Wasserstein pairs: ${topW1.map((t) => `${t.f1}&${t.f2}=${typeof t.wasserstein === "number" ? Number(t.wasserstein).toFixed(3) : t.wasserstein}`).join(", ")}`
                     : "",
-                `Artifacts refreshed on parent result (divergence_kl / feature_divergences.json). Compare with Pearson top_correlations from results(get) on the training job.`,
+                `Artifacts refreshed on parent result (divergence_kl = directed KL heatmap, upper/lower triangles opposite directions; feature_divergences.json has both directed_kl and symmetric_kl). Compare with Pearson top_correlations from results(get) on the training job.`,
             ].filter(Boolean);
             const content = [{ type: "text", text: lines.join("\n") }];
             const files = sum.files ?? [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barivia/barsom-mcp",
-  "version": "0.23.12",
+  "version": "0.23.13",
   "description": "barSOM MCP proxy — connect any MCP client to the barSOM cloud API for Self-Organizing Map analytics",
   "keywords": [
     "mcp",