@polycode-projects/the-mechanical-code-talker 2.5.2 → 2.5.4

package/src/tools/definitions.mjs

@@ -180,6 +180,19 @@ export const TOOL_DEFINITIONS = Object.freeze([
     inputSchema: classArg("The class to walk the inheritance edges of."),
     example: { class: "Field" },
   },
+  {
+    name: "tmct_related",
+    tier: "cold",
+    summary: "A term's synonyms (skos:altLabel) and related concepts (skos:related), from the memory graph's relation facts.",
+    inputSchema: {
+      type: "object",
+      required: ["term"],
+      properties: {
+        term: { type: "string", description: "The term whose synonyms / related concepts you want." },
+      },
+    },
+    example: { term: "sofa" },
+  },
   {
     name: "tmct_architecture",
     tier: "cold",

package/src/tools/handlers/index.mjs

@@ -14,6 +14,7 @@ import { tmct_impact } from "./tmct-impact.mjs";
 import { tmct_search } from "./tmct-search.mjs";
 import { tmct_members } from "./tmct-members.mjs";
 import { tmct_subclasses } from "./tmct-subclasses.mjs";
+import { tmct_related } from "./tmct-related.mjs";
 import { tmct_architecture } from "./tmct-architecture.mjs";
 import { tmct_exports } from "./tmct-exports.mjs";
 import { tmct_untested } from "./tmct-untested.mjs";
@@ -38,6 +39,7 @@ export const HANDLERS = Object.freeze({
   tmct_search,
   tmct_members,
   tmct_subclasses,
+  tmct_related,
   tmct_architecture,
   tmct_exports,
   tmct_untested,

package/src/tools/handlers/tmct-related.mjs

@@ -0,0 +1,30 @@
+// tmct_related — a term's synonyms (skos:altLabel) and related concepts (skos:related),
+// served from the conversational-memory graph's mgx:synonym / mgx:relatedTo / mgx:similarTo
+// facts through the derived SKOS concept view (src/domain/skos-view.mjs). A term the store
+// holds no relation facts for misses honestly — never a guessed neighbour.
+
+import { ToolError } from "../../adapters/config.mjs";
+import { relatedForTerm } from "../../domain/skos-view.mjs";
+import { memoryFactRows } from "../memory-fallthrough.mjs";
+import { requiredArg } from "./kit.mjs";
+
+export async function tmct_related(args, { config }) {
+  const term = requiredArg(args, "term");
+  const hit = relatedForTerm(await memoryFactRows(config), term);
+  if (!hit) {
+    throw new ToolError(
+      `no synonym or related facts for "${term}" in the memory graph. ` +
+        "This view answers where the store holds mgx:synonym / mgx:relatedTo facts (a corpus import seeds them).",
+    );
+  }
+  const lines = [`${hit.prefLabel} [${hit.conceptId}]`];
+  if (hit.synonyms.length) lines.push(`synonyms (skos:altLabel): ${hit.synonyms.join(", ")}`);
+  if (hit.related.length) lines.push(`related (skos:related): ${hit.related.map((c) => c.prefLabel).join(", ")}`);
+  lines.push("(from the memory graph's mgx:synonym / mgx:relatedTo / mgx:similarTo facts)");
+  return lines.join("\n");
+}
+
+// The memory graph is this tool's only source — it answers with or without a
+// code-map graph, so the shared code-graph load (which refuses an empty graph)
+// must not gate it.
+tmct_related.ownsGraphLoad = true;