@lucern/contracts 1.0.0 → 1.0.1

package/dist/sdk-tools.contract.analytics.d.ts

@@ -0,0 +1,27 @@
+import { SdkToolContract } from './sdk-tools.contract.types.js';
+import './tool-contracts.types.js';
+
+declare const GET_COLLECTION_CONVICTION: SdkToolContract;
+declare const GET_CONVICTION_TREND: SdkToolContract;
+declare const ANALYZE_BELIEF_CRITICALITY: SdkToolContract;
+declare const ANALYZE_BELIEF_CLUSTER_CANDIDATES: SdkToolContract;
+declare const CREATE_BELIEF_CONDITIONAL: SdkToolContract;
+declare const GET_NECESSARY_EVIDENCE: SdkToolContract;
+declare const ANALYZE_REASONING_DEPTH: SdkToolContract;
+declare const GET_EVIDENCE_BY_METHODOLOGY: SdkToolContract;
+declare const CREATE_EVIDENCE_TASK: SdkToolContract;
+declare const GET_TASK_COUNTS: SdkToolContract;
+declare const ADD_RESEARCH_ACTION: SdkToolContract;
+declare const GET_PREDICTIONS: SdkToolContract;
+declare const GET_SURPRISE_DETECTION: SdkToolContract;
+declare const GET_CHALLENGED_BELIEFS: SdkToolContract;
+declare const GET_CAUSAL_CHAINS: SdkToolContract;
+declare const GET_NON_CONSENSUS_BELIEFS: SdkToolContract;
+declare const GET_BELIEFS_BY_EPISTEMIC_STATUS: SdkToolContract;
+declare const DETECT_ANCHORING_BIAS: SdkToolContract;
+declare const DETECT_SOURCE_CONCENTRATION: SdkToolContract;
+declare const FIND_SOFT_CONTRADICTIONS: SdkToolContract;
+declare const FIND_SEMANTIC_BRIDGES: SdkToolContract;
+declare const FIND_SEMANTIC_ORPHANS: SdkToolContract;
+
+export { ADD_RESEARCH_ACTION, ANALYZE_BELIEF_CLUSTER_CANDIDATES, ANALYZE_BELIEF_CRITICALITY, ANALYZE_REASONING_DEPTH, CREATE_BELIEF_CONDITIONAL, CREATE_EVIDENCE_TASK, DETECT_ANCHORING_BIAS, DETECT_SOURCE_CONCENTRATION, FIND_SEMANTIC_BRIDGES, FIND_SEMANTIC_ORPHANS, FIND_SOFT_CONTRADICTIONS, GET_BELIEFS_BY_EPISTEMIC_STATUS, GET_CAUSAL_CHAINS, GET_CHALLENGED_BELIEFS, GET_COLLECTION_CONVICTION, GET_CONVICTION_TREND, GET_EVIDENCE_BY_METHODOLOGY, GET_NECESSARY_EVIDENCE, GET_NON_CONSENSUS_BELIEFS, GET_PREDICTIONS, GET_SURPRISE_DETECTION, GET_TASK_COUNTS };

package/dist/sdk-tools.contract.analytics.js

@@ -0,0 +1,616 @@
+// src/sdk-tools.contract.analytics.ts
+var GET_COLLECTION_CONVICTION = {
+  name: "get_collection_conviction",
+  description: "Aggregate conviction score across a set of beliefs. Like `git shortlog` \u2014 summary statistics for a belief collection. Computes weighted average, min, max, and distribution of confidence across the set.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    beliefIds: {
+      type: "array",
+      description: "Specific beliefs to aggregate (default: all project beliefs)"
+    },
+    groupBy: {
+      type: "string",
+      description: "Grouping dimension",
+      enum: ["domain", "branch", "worktree", "none"]
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Aggregate conviction metrics",
+    fields: {
+      averageConfidence: "number",
+      minConfidence: "number",
+      maxConfidence: "number",
+      distribution: "object \u2014 confidence histogram",
+      beliefCount: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var GET_CONVICTION_TREND = {
+  name: "get_conviction_trend",
+  description: "Time-series conviction analysis with pillar-level breakdown. Like `git log --graph --stat` over time \u2014 tracks how conviction evolves across scoring events. Returns data points suitable for charting conviction trajectory.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    timeRange: {
+      type: "object",
+      description: "Time range: { start: number, end: number }"
+    },
+    granularity: {
+      type: "string",
+      description: "Time bucket size",
+      enum: ["day", "week", "month"]
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Time-series conviction data",
+    fields: {
+      dataPoints: "array \u2014 { timestamp, averageConfidence, beliefCount, scoringEvents }",
+      pillarBreakdown: "object \u2014 per-domain conviction trends"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var ANALYZE_BELIEF_CRITICALITY = {
+  name: "analyze_belief_criticality",
+  description: "Criticality scoring for belief validation prioritization. Like `git bisect` for importance \u2014 identifies which beliefs are most critical to validate based on dependent judgments, downstream beliefs, and graph centrality.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum beliefs to score (default: 20)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Beliefs ranked by criticality score",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, criticalityScore, dependentCount, centralityScore }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var ANALYZE_BELIEF_CLUSTER_CANDIDATES = {
+  name: "analyze_belief_cluster_candidates",
+  description: "Cross-project deduplication and similarity discovery. Like `git cherry` \u2014 finding equivalent commits across branches. Identifies beliefs that are semantically similar across projects or domains for potential merging.",
+  parameters: {
+    topicId: { type: "string", description: "Primary topic to analyze" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    crossProjectIds: {
+      type: "array",
+      description: "Other projects to compare against"
+    },
+    similarityThreshold: {
+      type: "number",
+      description: "Minimum similarity score (0-1, default: 0.8)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Cluster candidates with similarity scores",
+    fields: {
+      clusters: "array \u2014 { beliefs: array, similarityScore: number, suggestedAction: string }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var CREATE_BELIEF_CONDITIONAL = {
+  name: "create_belief_conditional",
+  description: "Create prerequisite or falsifier dependency edges between beliefs. Like `git config` for conditional logic \u2014 declares that one belief depends on or is falsified by another. These edges drive automated confidence cascading when conditions change.",
+  parameters: {
+    sourceBeliefId: { type: "string", description: "The dependent belief" },
+    targetBeliefId: {
+      type: "string",
+      description: "The prerequisite or falsifier belief"
+    },
+    conditionType: {
+      type: "string",
+      description: "Dependency type",
+      enum: ["prerequisite", "falsifier", "strengthener"]
+    },
+    rationale: { type: "string", description: "Why this dependency exists" }
+  },
+  required: ["sourceBeliefId", "targetBeliefId", "conditionType"],
+  response: {
+    description: "The conditional edge",
+    fields: {
+      edgeId: "string",
+      conditionType: "string",
+      sourceBeliefId: "string",
+      targetBeliefId: "string"
+    }
+  },
+  ownerModule: "edges",
+  ontologyPrimitive: "edge",
+  tier: "sdk-only"
+};
+var GET_NECESSARY_EVIDENCE = {
+  name: "get_necessary_evidence",
+  description: "Identify evidence requirements for merge readiness. Like `git status` before merge \u2014 shows what evidence is missing, what questions are unanswered, and what gaps need filling before a worktree can be confidently merged.",
+  parameters: {
+    worktreeId: { type: "string", description: "The worktree to evaluate" }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "Evidence requirements and gaps",
+    fields: {
+      missingEvidence: "array \u2014 beliefs without supporting evidence",
+      unansweredQuestions: "array \u2014 open questions",
+      weakSupport: "array \u2014 beliefs with insufficient evidence weight",
+      mergeReadiness: "number \u2014 0-1 readiness score"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "evidence",
+  tier: "sdk-only"
+};
+var ANALYZE_REASONING_DEPTH = {
+  name: "analyze_reasoning_depth",
+  description: "Per-belief evidence grounding depth analysis. Like `git log --graph` depth analysis \u2014 measures how deeply each belief is grounded in evidence layers, from L1 sources through L2 evidence to L3 beliefs.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    beliefIds: {
+      type: "array",
+      description: "Specific beliefs to analyze (default: all)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Reasoning depth metrics per belief",
+    fields: {
+      beliefs: "array \u2014 { nodeId, depth, evidenceCount, sourceCount, groundingScore }",
+      averageDepth: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var GET_EVIDENCE_BY_METHODOLOGY = {
+  name: "get_evidence_by_methodology",
+  description: "Evidence grouped by collection methodology. Like `git log --format` with custom grouping \u2014 organizes evidence by how it was gathered: primary research, secondary analysis, expert interview, quantitative data, etc.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    methodology: {
+      type: "string",
+      description: "Filter to specific methodology"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Evidence organized by methodology",
+    fields: {
+      groups: "object \u2014 { methodology: array of evidence nodes }",
+      totalCount: "number",
+      methodologyCoverage: "object \u2014 percentage breakdown"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "evidence",
+  tier: "sdk-only"
+};
+var CREATE_EVIDENCE_TASK = {
+  name: "create_evidence_task",
+  description: "Create an evidence-focused work item with structured collection template. Like `git task` with evidence template \u2014 tracks concrete evidence-gathering actions with methodology, source requirements, and target beliefs pre-configured.",
+  parameters: {
+    title: { type: "string", description: "Task description" },
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    methodology: {
+      type: "string",
+      description: "Evidence collection method",
+      enum: [
+        "interview",
+        "survey",
+        "data_analysis",
+        "document_review",
+        "field_research"
+      ]
+    },
+    targetBeliefId: {
+      type: "string",
+      description: "Belief this evidence task aims to test"
+    },
+    targetQuestionId: {
+      type: "string",
+      description: "Question this task addresses"
+    }
+  },
+  required: ["title", "topicId", "methodology"],
+  response: {
+    description: "The created evidence task",
+    fields: {
+      taskId: "string",
+      methodology: "string",
+      status: "string \u2014 'pending'"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "task",
+  tier: "sdk-only"
+};
+var GET_TASK_COUNTS = {
+  name: "get_task_counts",
+  description: "Dashboard aggregate counts for task status distribution. Like `git shortlog -s` for tasks \u2014 returns counts grouped by status, type, and assignment. Useful for progress dashboards and workload balancing.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    groupBy: {
+      type: "string",
+      description: "Grouping dimension",
+      enum: ["status", "type", "worktree", "assignee"]
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Task count aggregates",
+    fields: { counts: "object \u2014 { group: number }", total: "number" }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "task",
+  tier: "sdk-only"
+};
+var ADD_RESEARCH_ACTION = {
+  name: "add_research_action",
+  description: "Append a concrete next action to a task. Like `git notes append` for tasks \u2014 adds specific follow-up actions without modifying the original task description.",
+  parameters: {
+    taskId: { type: "string", description: "The task to add an action to" },
+    action: { type: "string", description: "The concrete next step" },
+    priority: {
+      type: "string",
+      description: "Action priority",
+      enum: ["critical", "high", "medium", "low"]
+    }
+  },
+  required: ["taskId", "action"],
+  response: {
+    description: "The appended action",
+    fields: { actionId: "string", taskId: "string", createdAt: "number" }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "task",
+  tier: "sdk-only"
+};
+var GET_PREDICTIONS = {
+  name: "get_predictions",
+  description: "Calibration tracking for prediction-bearing beliefs. Like `git tag --verify` for prediction accuracy \u2014 tracks beliefs with testable predictions, their stated confidence, and actual outcomes for calibration scoring.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    status: {
+      type: "string",
+      description: "Prediction status filter",
+      enum: ["pending", "verified", "falsified", "expired"]
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Predictions with calibration data",
+    fields: {
+      predictions: "array \u2014 { beliefId, prediction, statedConfidence, outcome, calibrationDelta }",
+      overallCalibration: "number \u2014 Brier score or equivalent"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var GET_SURPRISE_DETECTION = {
+  name: "get_surprise_detection",
+  description: "Analysis of ignored vs integrated surprise findings. Like `git diff --stat` for unexpected findings \u2014 identifies evidence that significantly deviated from prior beliefs and tracks whether it was integrated or dismissed.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    surpriseThreshold: {
+      type: "number",
+      description: "Minimum surprise score to include (0-1, default: 0.5)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Surprise analysis",
+    fields: {
+      surprises: "array \u2014 { evidenceId, surpriseScore, integrated, affectedBeliefs }",
+      ignoredCount: "number",
+      integratedCount: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "evidence",
+  tier: "sdk-only"
+};
+var GET_CHALLENGED_BELIEFS = {
+  name: "get_challenged_beliefs",
+  description: "Find beliefs downstream of contradiction detection. Like `git log --grep=conflict` \u2014 identifies beliefs that have been challenged by contradictions, negative evidence, or confidence collapses.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    minChallengeCount: {
+      type: "number",
+      description: "Minimum number of challenges (default: 1)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Challenged beliefs with challenge details",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, challengeCount, contradictions, negativeEvidence }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var GET_CAUSAL_CHAINS = {
+  name: "get_causal_chains",
+  description: "Trace cause/effect lineage through the reasoning graph. Like `git log --ancestry-path` \u2014 follows causal edges to build chains of reasoning from root causes to downstream effects.",
+  parameters: {
+    nodeId: {
+      type: "string",
+      description: "Starting node for causal traversal"
+    },
+    direction: {
+      type: "string",
+      description: "Trace direction",
+      enum: ["causes", "effects", "both"]
+    },
+    maxDepth: {
+      type: "number",
+      description: "Maximum chain depth (default: 5)"
+    }
+  },
+  required: ["nodeId"],
+  response: {
+    description: "Causal chains with strength annotations",
+    fields: {
+      chains: "array \u2014 { path: array, strength: number, chainType: string }",
+      totalChains: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "graph",
+  tier: "sdk-only"
+};
+var GET_NON_CONSENSUS_BELIEFS = {
+  name: "get_non_consensus_beliefs",
+  description: "Detect contrarian positions in the belief graph. Like `git log --no-merges` \u2014 standalone positions that diverge from the majority view. Identifies beliefs with low consensus among evidence sources or team members.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    consensusThreshold: {
+      type: "number",
+      description: "Below this threshold marks non-consensus (default: 0.5)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Non-consensus beliefs with dissent analysis",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, consensusScore, dissentingSources, supportingSources }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var GET_BELIEFS_BY_EPISTEMIC_STATUS = {
+  name: "get_beliefs_by_epistemic_status",
+  description: "Filter beliefs by epistemic taxonomy labels. Like `git log --grep` with epistemic labels \u2014 filters beliefs by their epistemic classification: hypothesis, established, speculative, contested, retracted.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    epistemicStatus: {
+      type: "string",
+      description: "Epistemic classification",
+      enum: [
+        "hypothesis",
+        "established",
+        "speculative",
+        "contested",
+        "retracted"
+      ]
+    }
+  },
+  required: ["topicId", "epistemicStatus"],
+  response: {
+    description: "Beliefs matching the epistemic status",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, confidence, epistemicStatus, lastModulated }",
+      count: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var DETECT_ANCHORING_BIAS = {
+  name: "detect_anchoring_bias",
+  description: "Detect old unchallenged beliefs that may anchor reasoning. Like `git log --before` \u2014 finding stale commits that haven't been reviewed. Flags beliefs that were established early and have not received new evidence or challenge.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    staleThresholdDays: {
+      type: "number",
+      description: "Days without new evidence to flag as anchored (default: 30)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Potentially anchored beliefs",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, daysSinceLastEvidence, originalConfidence, currentConfidence }",
+      riskLevel: "string \u2014 overall anchoring risk"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var DETECT_SOURCE_CONCENTRATION = {
+  name: "detect_source_concentration",
+  description: "Detect single-source evidence risk across beliefs. Like `git shortlog` showing only one contributor \u2014 identifies beliefs where all supporting evidence comes from a single source or methodology.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    concentrationThreshold: {
+      type: "number",
+      description: "Max acceptable single-source ratio (0-1, default: 0.8)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Source concentration analysis",
+    fields: {
+      beliefs: "array \u2014 { nodeId, canonicalText, dominantSource, concentrationRatio, uniqueSourceCount }",
+      highRiskCount: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "evidence",
+  tier: "sdk-only"
+};
+var FIND_SOFT_CONTRADICTIONS = {
+  name: "find_soft_contradictions",
+  description: "Detect semantic and embedding-level contradictions not flagged by explicit contradiction objects. Like `git diff --word-diff` for subtle conflicts \u2014 finds beliefs that are semantically in tension even though no formal contradiction has been flagged.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    similarityThreshold: {
+      type: "number",
+      description: "Semantic similarity for contradiction detection (0-1, default: 0.7)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Soft contradiction pairs",
+    fields: {
+      pairs: "array \u2014 { beliefA, beliefB, tensionScore, tensionDescription }",
+      totalPairs: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "belief",
+  tier: "sdk-only"
+};
+var FIND_SEMANTIC_BRIDGES = {
+  name: "find_semantic_bridges",
+  description: "Find semantically similar but graph-distant nodes. Like `git cherry` \u2014 finding equivalent commits across branches that aren't connected. Identifies nodes that share semantic meaning but have no graph edges between them.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    minSemanticSimilarity: {
+      type: "number",
+      description: "Minimum embedding similarity (0-1, default: 0.75)"
+    },
+    minGraphDistance: {
+      type: "number",
+      description: "Minimum graph hops to qualify as distant (default: 3)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Potential bridge pairs",
+    fields: {
+      bridges: "array \u2014 { nodeA, nodeB, semanticSimilarity, graphDistance, suggestedEdgeType }",
+      totalBridges: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "graph",
+  tier: "sdk-only"
+};
+var FIND_SEMANTIC_ORPHANS = {
+  name: "find_semantic_orphans",
+  description: "Find structurally connected but semantically distant nodes. Like `git fsck --lost-found` \u2014 nodes that are technically connected in the graph but semantically don't belong, possibly indicating miscategorization or stale edges.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    projectId: {
+      type: "string",
+      description: "Deprecated legacy alias for topic scope"
+    },
+    maxSemanticSimilarity: {
+      type: "number",
+      description: "Maximum similarity to qualify as orphan (0-1, default: 0.3)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Semantic orphan nodes",
+    fields: {
+      orphans: "array \u2014 { nodeId, connectedTo, semanticSimilarity, edgeType, suggestedAction }",
+      totalOrphans: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "graph",
+  tier: "sdk-only"
+};
+
+export { ADD_RESEARCH_ACTION, ANALYZE_BELIEF_CLUSTER_CANDIDATES, ANALYZE_BELIEF_CRITICALITY, ANALYZE_REASONING_DEPTH, CREATE_BELIEF_CONDITIONAL, CREATE_EVIDENCE_TASK, DETECT_ANCHORING_BIAS, DETECT_SOURCE_CONCENTRATION, FIND_SEMANTIC_BRIDGES, FIND_SEMANTIC_ORPHANS, FIND_SOFT_CONTRADICTIONS, GET_BELIEFS_BY_EPISTEMIC_STATUS, GET_CAUSAL_CHAINS, GET_CHALLENGED_BELIEFS, GET_COLLECTION_CONVICTION, GET_CONVICTION_TREND, GET_EVIDENCE_BY_METHODOLOGY, GET_NECESSARY_EVIDENCE, GET_NON_CONSENSUS_BELIEFS, GET_PREDICTIONS, GET_SURPRISE_DETECTION, GET_TASK_COUNTS };
+//# sourceMappingURL=sdk-tools.contract.analytics.js.map
+//# sourceMappingURL=sdk-tools.contract.analytics.js.map