@lucern/contracts 1.0.0 → 1.0.1

package/dist/tool-contracts.intelligence-evidence.js

@@ -0,0 +1,303 @@
+// src/tool-contracts.intelligence-evidence.ts
+var DETECT_CONFIRMATION_BIAS = {
+  name: "detect_confirmation_bias",
+  description: "Detect confirmation bias in the evidence graph. Like `git diff --stat` for reasoning \u2014 analyzes the ratio of supporting vs challenging evidence per belief and flags beliefs where the evidence is suspiciously one-sided. Returns risk classification (critical/high/moderate/healthy).",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" },
+    threshold: {
+      type: "number",
+      description: "Bias threshold (0-1, default 0.7)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Beliefs with bias scores, risk levels, and evidence counts",
+    fields: {
+      beliefs: "array \u2014 { nodeId, biasScore, riskLevel, supportingCount, challengingCount }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var GET_GRAPH_STRUCTURE_ANALYSIS = {
+  name: "get_graph_structure_analysis",
+  description: "Run comprehensive structural analysis on the knowledge graph. Like `git fsck` combined with PageRank \u2014 runs 14 algorithmic detectors including PageRank centrality, Louvain community detection, Tarjan SCC, Fiedler vector spectral analysis, Bayesian surprise, and overconfidence detection.",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Structural analysis with detector results and recommendations",
+    fields: {
+      topicId: "string \u2014 canonical topic scope",
+      metric: "string \u2014 analysis metric identifier",
+      payload: "object \u2014 detector results, recommendations, graph metrics"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var LIST_GRAPH_INTELLIGENCE_QUERIES = {
+  name: "list_graph_intelligence_queries",
+  description: "List the Graph Intelligence query catalog that powers structural graph analysis experiences. Returns categories, query IDs, prompt templates, modes, and the public tool plan each query can use.",
+  parameters: {
+    categoryId: {
+      type: "string",
+      description: "Optional category filter, such as problems or strategic"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode filter: core, bias, stress, operational, alpha, semantic, or evidence"
+    }
+  },
+  required: [],
+  response: {
+    description: "Graph Intelligence query catalog and mode-to-tool mapping",
+    fields: {
+      categories: "array \u2014 query categories",
+      queries: "array \u2014 query definitions with prompt templates and tools",
+      quickQueries: "array \u2014 recommended one-click query presets",
+      publicToolNamesByMode: "object \u2014 public tool names available to each Graph Intelligence mode"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var RUN_GRAPH_INTELLIGENCE_QUERY = {
+  name: "run_graph_intelligence_query",
+  description: "Run a named Graph Intelligence query against a tenant topic graph. Returns the selected query, prompt, deterministic graph-analysis bundle, graph context, and public tool plan for model synthesis.",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" },
+    queryId: {
+      type: "string",
+      description: "Graph Intelligence query ID, such as confirmation-bias, pre-mortem, or thesis-summary"
+    },
+    prompt: {
+      type: "string",
+      description: "Optional custom prompt for custom analysis runs"
+    },
+    input: {
+      type: "string",
+      description: "Optional entity, theme, belief, company, or search text for input-driven queries"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode override: core, bias, stress, operational, alpha, semantic, or evidence"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum graph context rows to return"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Graph Intelligence query result bundle ready for model or prompt-library synthesis",
+    fields: {
+      query: "object \u2014 selected query definition",
+      prompt: "string \u2014 resolved prompt template",
+      toolPlan: "array \u2014 public tools and args the model can call next",
+      analysis: "object \u2014 structure, coverage, gap, and confirmation-bias analysis",
+      context: "object \u2014 sampled beliefs, questions, evidence, edges, and contradictions"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var GET_FALSIFICATION_QUESTIONS = {
+  name: "get_falsification_questions",
+  description: "Generate Popperian falsification questions for beliefs. Like `git test` \u2014 identifies the questions most likely to disprove current beliefs. Karl Popper as a tool: surfaces what would need to be true to invalidate each belief.",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" },
+    beliefIds: { type: "array", description: "Specific beliefs to target" }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Questions with falsification potential scores and target beliefs",
+    fields: {
+      questions: "array \u2014 { questionText, falsificationPotential, targetBeliefId, targetBeliefText }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "question",
+  tier: "showcase"
+};
+var SEARCH_EVIDENCE = {
+  name: "search_evidence",
+  description: "Search for evidence across the reasoning graph. Like `git grep` \u2014 returns the evidence records that best match a textual query. Results share the same canonical semantics as the HTTP and SDK evidence search surface.",
+  parameters: {
+    q: { type: "string", description: "Search text" },
+    topicId: { type: "string", description: "Topic scope filter" },
+    targetId: {
+      type: "string",
+      description: "Optional belief or question identifier to scope the search"
+    },
+    limit: { type: "number", description: "Max results" },
+    cursor: { type: "string", description: "Pagination cursor" }
+  },
+  required: ["q"],
+  response: {
+    description: "Canonical evidence search results page",
+    fields: {
+      results: "array \u2014 { evidenceId, nodeId, globalId?, text, source?, kind?, relevanceScore }",
+      nextCursor: "string | null"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse"
+};
+var CREATE_EVIDENCE = {
+  name: "create_evidence",
+  description: "Commit evidence to the reasoning graph. Like `git commit` \u2014 creates a traceable evidence record with canonical public IDs. Optionally links the evidence to a belief or question in the same operation.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    text: { type: "string", description: "Canonical evidence text" },
+    source: { type: "string", description: "Source URL or source label" },
+    targetId: {
+      type: "string",
+      description: "Optional belief or question identifier to link immediately"
+    },
+    weight: {
+      type: "number",
+      description: "Support weight: -1.0 (contradicts) to +1.0 (supports)"
+    },
+    metadata: {
+      type: "object",
+      description: "Optional metadata merged into the canonical evidence node"
+    },
+    rationale: {
+      type: "string",
+      description: "Why this evidence should enter the reasoning graph"
+    },
+    title: { type: "string", description: "Optional short title" },
+    content: { type: "string", description: "Optional long-form content" },
+    contentType: {
+      type: "string",
+      description: "Optional content format or MIME hint"
+    },
+    kind: { type: "string", description: "Optional evidence kind" }
+  },
+  required: ["text", "rationale"],
+  response: {
+    description: "The created canonical evidence record",
+    fields: {
+      id: "string \u2014 canonical evidence ID",
+      nodeId: "string \u2014 canonical evidence ID",
+      evidenceId: "string \u2014 canonical evidence ID",
+      text: "string",
+      topicId: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse"
+};
+var GET_EVIDENCE = {
+  name: "get_evidence",
+  description: "Read one evidence record by ID. Like `git show` \u2014 resolves the canonical evidence payload for a single identifier.",
+  parameters: {
+    id: { type: "string", description: "Canonical evidence ID" }
+  },
+  required: ["id"],
+  response: {
+    description: "The canonical evidence record",
+    fields: {
+      id: "string \u2014 canonical evidence ID",
+      nodeId: "string \u2014 canonical evidence ID",
+      evidenceId: "string \u2014 canonical evidence ID",
+      text: "string",
+      topicId: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse"
+};
+var LIST_EVIDENCE = {
+  name: "list_evidence",
+  description: "List evidence records within a topic or linked to a target. Like `git log -- path` \u2014 returns the canonical evidence page for a topic, belief, or question scope.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope filter" },
+    targetId: {
+      type: "string",
+      description: "Optional belief or question identifier to scope by linkage"
+    },
+    limit: { type: "number", description: "Max results" },
+    cursor: { type: "string", description: "Pagination cursor" }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Canonical evidence page",
+    fields: {
+      evidence: "array \u2014 canonical evidence records",
+      nextCursor: "string | null"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse"
+};
+var LINK_EVIDENCE = {
+  name: "link_evidence",
+  description: "Link evidence to a belief or question. Like `git notes add` \u2014 attaches a supporting or contradicting edge without rewriting the evidence itself.",
+  parameters: {
+    evidenceId: { type: "string", description: "Canonical evidence ID" },
+    targetId: {
+      type: "string",
+      description: "Canonical belief or question ID"
+    },
+    weight: {
+      type: "number",
+      description: "Support weight: -1.0 (contradicts) to +1.0 (supports)"
+    },
+    rationale: { type: "string", description: "Why this link exists" }
+  },
+  required: ["evidenceId", "targetId"],
+  response: {
+    description: "The created canonical evidence edge summary",
+    fields: {
+      edgeId: "string",
+      evidenceId: "string",
+      targetId: "string",
+      targetType: "string \u2014 belief | question",
+      weight: "number"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "edge",
+  tier: "workhorse"
+};
+var LINK_EVIDENCE_TO_BELIEF = {
+  name: "link_evidence_to_belief",
+  description: "Link evidence to a belief with a support weight. Like `git add` \u2014 stages evidence in support of (or against) a belief. The weight ranges from -1.0 (strongly contradicts) to +1.0 (strongly supports).",
+  parameters: {
+    evidenceId: { type: "string", description: "The evidence node ID" },
+    beliefId: { type: "string", description: "The belief node ID" },
+    weight: {
+      type: "number",
+      description: "Support weight: -1.0 (contradicts) to +1.0 (supports)"
+    },
+    rationale: { type: "string", description: "Why this evidence is relevant" }
+  },
+  required: ["evidenceId", "beliefId", "weight"],
+  response: {
+    description: "The created edge linking evidence to belief",
+    fields: {
+      edgeId: "string",
+      evidenceId: "string",
+      beliefId: "string",
+      weight: "number"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "edge",
+  tier: "workhorse"
+};
+
+export { CREATE_EVIDENCE, DETECT_CONFIRMATION_BIAS, GET_EVIDENCE, GET_FALSIFICATION_QUESTIONS, GET_GRAPH_STRUCTURE_ANALYSIS, LINK_EVIDENCE, LINK_EVIDENCE_TO_BELIEF, LIST_EVIDENCE, LIST_GRAPH_INTELLIGENCE_QUERIES, RUN_GRAPH_INTELLIGENCE_QUERY, SEARCH_EVIDENCE };
+//# sourceMappingURL=tool-contracts.intelligence-evidence.js.map
+//# sourceMappingURL=tool-contracts.intelligence-evidence.js.map

package/dist/tool-contracts.intelligence-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-contracts.intelligence-evidence.ts"],"names":[],"mappings":"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","file":"tool-contracts.intelligence-evidence.js","sourcesContent":["import type { McpToolContract } from \"./tool-contracts.types\";\n\nexport const DETECT_CONFIRMATION_BIAS: McpToolContract = {\n  name: \"detect_confirmation_bias\",\n  description:\n    \"Detect confirmation bias in the evidence graph. \" +\n    \"Like `git diff --stat` for reasoning — analyzes the ratio of supporting vs challenging evidence \" +\n    \"per belief and flags beliefs where the evidence is suspiciously one-sided. \" +\n    \"Returns risk classification (critical/high/moderate/healthy).\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic to analyze\" },\n    threshold: {\n      type: \"number\",\n      description: \"Bias threshold (0-1, default 0.7)\",\n    },\n  },\n  required: [\"topicId\"],\n  response: {\n    description: \"Beliefs with bias scores, risk levels, and evidence counts\",\n    fields: {\n      beliefs:\n        \"array — { nodeId, biasScore, riskLevel, supportingCount, challengingCount }\",\n    },\n  },\n  ownerModule: \"graph-search\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const GET_GRAPH_STRUCTURE_ANALYSIS: McpToolContract = {\n  name: \"get_graph_structure_analysis\",\n  description:\n    \"Run comprehensive structural analysis on the knowledge graph. \" +\n    \"Like `git fsck` combined with PageRank — runs 14 algorithmic detectors including \" +\n    \"PageRank centrality, Louvain community detection, Tarjan SCC, Fiedler vector spectral analysis, \" +\n    \"Bayesian surprise, and overconfidence detection.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic to analyze\" },\n  },\n  required: [\"topicId\"],\n  response: {\n    description:\n      \"Structural analysis with detector results and recommendations\",\n    fields: {\n      topicId: \"string — canonical topic scope\",\n      metric: \"string — analysis metric identifier\",\n      payload: \"object — detector results, recommendations, graph metrics\",\n    },\n  },\n  ownerModule: \"graph-search\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const LIST_GRAPH_INTELLIGENCE_QUERIES: McpToolContract = {\n  name: \"list_graph_intelligence_queries\",\n  description:\n    \"List the Graph Intelligence query catalog that powers structural graph analysis experiences. \" +\n    \"Returns categories, query IDs, prompt templates, modes, and the public tool plan each query can use.\",\n  parameters: {\n    categoryId: {\n      type: \"string\",\n      description: \"Optional category filter, such as problems or strategic\",\n    },\n    mode: {\n      type: \"string\",\n      description:\n        \"Optional mode filter: core, bias, stress, operational, alpha, semantic, or evidence\",\n    },\n  },\n  required: [],\n  response: {\n    description:\n      \"Graph Intelligence query catalog and mode-to-tool mapping\",\n    fields: {\n      categories: \"array — query categories\",\n      queries: \"array — query definitions with prompt templates and tools\",\n      quickQueries: \"array — recommended one-click query presets\",\n      publicToolNamesByMode:\n        \"object — public tool names available to each Graph Intelligence mode\",\n    },\n  },\n  ownerModule: \"graph-intelligence\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const RUN_GRAPH_INTELLIGENCE_QUERY: McpToolContract = {\n  name: \"run_graph_intelligence_query\",\n  description:\n    \"Run a named Graph Intelligence query against a tenant topic graph. \" +\n    \"Returns the selected query, prompt, deterministic graph-analysis bundle, graph context, and public tool plan for model synthesis.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic to analyze\" },\n    queryId: {\n      type: \"string\",\n      description:\n        \"Graph Intelligence query ID, such as confirmation-bias, pre-mortem, or thesis-summary\",\n    },\n    prompt: {\n      type: \"string\",\n      description: \"Optional custom prompt for custom analysis runs\",\n    },\n    input: {\n      type: \"string\",\n      description:\n        \"Optional entity, theme, belief, company, or search text for input-driven queries\",\n    },\n    mode: {\n      type: \"string\",\n      description:\n        \"Optional mode override: core, bias, stress, operational, alpha, semantic, or evidence\",\n    },\n    limit: {\n      type: \"number\",\n      description: \"Maximum graph context rows to return\",\n    },\n  },\n  required: [\"topicId\"],\n  response: {\n    description:\n      \"Graph Intelligence query result bundle ready for model or prompt-library synthesis\",\n    fields: {\n      query: \"object — selected query definition\",\n      prompt: \"string — resolved prompt template\",\n      toolPlan: \"array — public tools and args the model can call next\",\n      analysis:\n        \"object — structure, coverage, gap, and confirmation-bias analysis\",\n      context: \"object — sampled beliefs, questions, evidence, edges, and contradictions\",\n    },\n  },\n  ownerModule: \"graph-intelligence\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const GET_FALSIFICATION_QUESTIONS: McpToolContract = {\n  name: \"get_falsification_questions\",\n  description:\n    \"Generate Popperian falsification questions for beliefs. \" +\n    \"Like `git test` — identifies the questions most likely to disprove current beliefs. \" +\n    \"Karl Popper as a tool: surfaces what would need to be true to invalidate each belief.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic to analyze\" },\n    beliefIds: { type: \"array\", description: \"Specific beliefs to target\" },\n  },\n  required: [\"topicId\"],\n  response: {\n    description:\n      \"Questions with falsification potential scores and target beliefs\",\n    fields: {\n      questions:\n        \"array — { questionText, falsificationPotential, targetBeliefId, targetBeliefText }\",\n    },\n  },\n  ownerModule: \"graph-search\",\n  ontologyPrimitive: \"question\",\n  tier: \"showcase\",\n};\n\n// =============================================================================\n// EVIDENCE OPERATION TOOLS\n// =============================================================================\n\nexport const SEARCH_EVIDENCE: McpToolContract = {\n  name: \"search_evidence\",\n  description:\n    \"Search for evidence across the reasoning graph. \" +\n    \"Like `git grep` — returns the evidence records that best match a textual query. \" +\n    \"Results share the same canonical semantics as the HTTP and SDK evidence search surface.\",\n  parameters: {\n    q: { type: \"string\", description: \"Search text\" },\n    topicId: { type: \"string\", description: \"Topic scope filter\" },\n    targetId: {\n      type: \"string\",\n      description: \"Optional belief or question identifier to scope the search\",\n    },\n    limit: { type: \"number\", description: \"Max results\" },\n    cursor: { type: \"string\", description: \"Pagination cursor\" },\n  },\n  required: [\"q\"],\n  response: {\n    description: \"Canonical evidence search results page\",\n    fields: {\n      results:\n        \"array — { evidenceId, nodeId, globalId?, text, source?, kind?, relevanceScore }\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"graph-search\",\n  ontologyPrimitive: \"evidence\",\n  tier: \"workhorse\",\n};\n\nexport const CREATE_EVIDENCE: McpToolContract = {\n  name: \"create_evidence\",\n  description:\n    \"Commit evidence to the reasoning graph. \" +\n    \"Like `git commit` — creates a traceable evidence record with canonical public IDs. \" +\n    \"Optionally links the evidence to a belief or question in the same operation.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic scope\" },\n    text: { type: \"string\", description: \"Canonical evidence text\" },\n    source: { type: \"string\", description: \"Source URL or source label\" },\n    targetId: {\n      type: \"string\",\n      description: \"Optional belief or question identifier to link immediately\",\n    },\n    weight: {\n      type: \"number\",\n      description: \"Support weight: -1.0 (contradicts) to +1.0 (supports)\",\n    },\n    metadata: {\n      type: \"object\",\n      description: \"Optional metadata merged into the canonical evidence node\",\n    },\n    rationale: {\n      type: \"string\",\n      description: \"Why this evidence should enter the reasoning graph\",\n    },\n    title: { type: \"string\", description: \"Optional short title\" },\n    content: { type: \"string\", description: \"Optional long-form content\" },\n    contentType: {\n      type: \"string\",\n      description: \"Optional content format or MIME hint\",\n    },\n    kind: { type: \"string\", description: \"Optional evidence kind\" },\n  },\n  required: [\"text\", \"rationale\"],\n  response: {\n    description: \"The created canonical evidence record\",\n    fields: {\n      id: \"string — canonical evidence ID\",\n      nodeId: \"string — canonical evidence ID\",\n      evidenceId: \"string — canonical evidence ID\",\n      text: \"string\",\n      topicId: \"string\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"evidence\",\n  tier: \"workhorse\",\n};\n\nexport const GET_EVIDENCE: McpToolContract = {\n  name: \"get_evidence\",\n  description:\n    \"Read one evidence record by ID. \" +\n    \"Like `git show` — resolves the canonical evidence payload for a single identifier.\",\n  parameters: {\n    id: { type: \"string\", description: \"Canonical evidence ID\" },\n  },\n  required: [\"id\"],\n  response: {\n    description: \"The canonical evidence record\",\n    fields: {\n      id: \"string — canonical evidence ID\",\n      nodeId: \"string — canonical evidence ID\",\n      evidenceId: \"string — canonical evidence ID\",\n      text: \"string\",\n      topicId: \"string\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"evidence\",\n  tier: \"workhorse\",\n};\n\nexport const LIST_EVIDENCE: McpToolContract = {\n  name: \"list_evidence\",\n  description:\n    \"List evidence records within a topic or linked to a target. \" +\n    \"Like `git log -- path` — returns the canonical evidence page for a topic, belief, or question scope.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Topic scope filter\" },\n    targetId: {\n      type: \"string\",\n      description: \"Optional belief or question identifier to scope by linkage\",\n    },\n    limit: { type: \"number\", description: \"Max results\" },\n    cursor: { type: \"string\", description: \"Pagination cursor\" },\n  },\n  required: [\"topicId\"],\n  response: {\n    description: \"Canonical evidence page\",\n    fields: {\n      evidence: \"array — canonical evidence records\",\n      nextCursor: \"string | null\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"evidence\",\n  tier: \"workhorse\",\n};\n\nexport const LINK_EVIDENCE: McpToolContract = {\n  name: \"link_evidence\",\n  description:\n    \"Link evidence to a belief or question. \" +\n    \"Like `git notes add` — attaches a supporting or contradicting edge without rewriting the evidence itself.\",\n  parameters: {\n    evidenceId: { type: \"string\", description: \"Canonical evidence ID\" },\n    targetId: {\n      type: \"string\",\n      description: \"Canonical belief or question ID\",\n    },\n    weight: {\n      type: \"number\",\n      description: \"Support weight: -1.0 (contradicts) to +1.0 (supports)\",\n    },\n    rationale: { type: \"string\", description: \"Why this link exists\" },\n  },\n  required: [\"evidenceId\", \"targetId\"],\n  response: {\n    description: \"The created canonical evidence edge summary\",\n    fields: {\n      edgeId: \"string\",\n      evidenceId: \"string\",\n      targetId: \"string\",\n      targetType: \"string — belief | question\",\n      weight: \"number\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"edge\",\n  tier: \"workhorse\",\n};\n\nexport const LINK_EVIDENCE_TO_BELIEF: McpToolContract = {\n  name: \"link_evidence_to_belief\",\n  description:\n    \"Link evidence to a belief with a support weight. \" +\n    \"Like `git add` — stages evidence in support of (or against) a belief. \" +\n    \"The weight ranges from -1.0 (strongly contradicts) to +1.0 (strongly supports).\",\n  parameters: {\n    evidenceId: { type: \"string\", description: \"The evidence node ID\" },\n    beliefId: { type: \"string\", description: \"The belief node ID\" },\n    weight: {\n      type: \"number\",\n      description: \"Support weight: -1.0 (contradicts) to +1.0 (supports)\",\n    },\n    rationale: { type: \"string\", description: \"Why this evidence is relevant\" },\n  },\n  required: [\"evidenceId\", \"beliefId\", \"weight\"],\n  response: {\n    description: \"The created edge linking evidence to belief\",\n    fields: {\n      edgeId: \"string\",\n      evidenceId: \"string\",\n      beliefId: \"string\",\n      weight: \"number\",\n    },\n  },\n  ownerModule: \"graph-primitives\",\n  ontologyPrimitive: \"edge\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// QUESTION OPERATION TOOLS\n// =============================================================================\n"]}