@lucern/contracts 0.1.0 → 0.1.1-alpha.1

package/dist/sdk-tools.contract.js

@@ -1,1399 +0,0 @@
-/**
- * SDK-Only Tool Contract Definitions
- *
- * Tools available in @lucern/sdk but NOT in the MCP gateway.
- * The SDK unfolds deeper capabilities after the MCP gateway shows developers what's possible.
- *
- * Total SDK surface = MCP tools (44) + SDK-only tools (44) = 88 tools
- *
- * These tools are organized into capability tiers:
- * - Advanced workflow & phase management (12 tools)
- * - Deeper graph navigation (6 tools)
- * - Conviction & analytics (7 tools)
- * - Extended question & evidence analytics (1 tool; core lifecycle promoted to MCP)
- * - Task lifecycle (5 tools)
- * - Domain analytics (8 tools)
- * - Bias detection suite (5 tools)
- *
- * CONTRACT SURFACE: These definitions are the external API for SDK consumers.
- * Renaming a tool or changing its description is a BREAKING CHANGE.
- *
- * Git-native naming rules (same as MCP, enforced by lint):
- *   1. Workflow tools use git verbs directly
- *   2. Knowledge tools use epistemic verbs
- *   3. First sentence of description includes the git analog verb
- *   4. Description includes "Like `git X`" parenthetical
- *   5. Parameter names use domain terms (canonicalText, nodeId, confidence)
- */
-import { MCP_TOOL_CONTRACTS } from "./mcp-tools.contract";
-// =============================================================================
-// 3.1 ADVANCED WORKFLOW & PHASE MANAGEMENT (12 tools)
-// =============================================================================
-export const START_WORKTREE = {
-    name: "start_worktree",
-    description: "Transition a draft worktree to active. " +
-        "Like `git checkout -b` — the branch becomes your working context. " +
-        "A worktree must be started before beliefs can be committed to it.",
-    parameters: {
-        worktreeId: {
-            type: "string",
-            description: "The draft worktree to activate",
-        },
-    },
-    required: ["worktreeId"],
-    response: {
-        description: "The activated worktree",
-        fields: {
-            worktreeId: "string",
-            status: "string — 'active'",
-            startedAt: "number",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const UPDATE_WORKTREE_PHASE = {
-    name: "update_worktree_phase",
-    description: "Set a worktree's phase explicitly. " +
-        "Like `git config` for workflow state — manually sets the current investigation phase. " +
-        "Phases: hypothesis_formation, evidence_collection, evidence_review, synthesis, scoring.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to update" },
-        phase: {
-            type: "string",
-            description: "Target phase",
-            enum: [
-                "hypothesis_formation",
-                "evidence_collection",
-                "evidence_review",
-                "synthesis",
-                "scoring",
-            ],
-        },
-        reason: { type: "string", description: "Why the phase is being set" },
-    },
-    required: ["worktreeId", "phase"],
-    response: {
-        description: "Updated worktree phase",
-        fields: {
-            worktreeId: "string",
-            previousPhase: "string",
-            newPhase: "string",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const ADVANCE_WORKTREE_PHASE = {
-    name: "advance_worktree_phase",
-    description: "Auto-advance a worktree to the next phase after requirements pass. " +
-        "Like `git hooks` post-commit — automatic progression when phase gates are satisfied. " +
-        "Validates that all phase requirements are met before advancing.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to advance" },
-    },
-    required: ["worktreeId"],
-    response: {
-        description: "Phase advancement result",
-        fields: {
-            worktreeId: "string",
-            previousPhase: "string",
-            newPhase: "string",
-            requirementsMet: "boolean",
-            failedRequirements: "array | null — requirements that blocked advancement",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const ADD_NOTE_TO_WORKTREE = {
-    name: "add_note_to_worktree",
-    description: "Attach contextual metadata to a worktree. " +
-        "Like `git notes` — annotations that don't change the commit itself. " +
-        "Notes persist across phase transitions and appear in the audit trail.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to annotate" },
-        content: { type: "string", description: "Note content" },
-        noteType: {
-            type: "string",
-            description: "Note category",
-            enum: ["observation", "decision", "risk", "context"],
-        },
-    },
-    required: ["worktreeId", "content"],
-    response: {
-        description: "The created note",
-        fields: { noteId: "string", worktreeId: "string", createdAt: "number" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const LINK_DOCUMENT_TO_WORKTREE = {
-    name: "link_document_to_worktree",
-    description: "Attach a source document to a worktree. " +
-        "Like `git submodule add` — external references tracked within the worktree context. " +
-        "Documents become available as evidence sources for the investigation.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to link to" },
-        documentUrl: {
-            type: "string",
-            description: "URL or ID of the source document",
-        },
-        title: { type: "string", description: "Document title for display" },
-        documentType: {
-            type: "string",
-            description: "Document category",
-            enum: ["report", "transcript", "filing", "article", "dataset"],
-        },
-    },
-    required: ["worktreeId", "documentUrl", "title"],
-    response: {
-        description: "The document link",
-        fields: { linkId: "string", worktreeId: "string", documentUrl: "string" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const LINK_EVIDENCE_TO_WORKTREE = {
-    name: "link_evidence_to_worktree",
-    description: "Stage evidence in a worktree for later processing. " +
-        "Like `git stash` — evidence waiting to be committed into the belief graph. " +
-        "Staged evidence is visible in the worktree but not yet linked to beliefs.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to stage in" },
-        evidenceId: { type: "string", description: "The evidence node to stage" },
-        rationale: {
-            type: "string",
-            description: "Why this evidence is relevant to the worktree",
-        },
-    },
-    required: ["worktreeId", "evidenceId"],
-    response: {
-        description: "The staged evidence link",
-        fields: { linkId: "string", worktreeId: "string", evidenceId: "string" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const LINK_QUESTION_TO_WORKTREE = {
-    name: "link_question_to_worktree",
-    description: "Attach a question to a worktree for tracking. " +
-        "Like `git issue link` — associates an open question with an active investigation. " +
-        "Questions linked to a worktree guide evidence collection within that scope.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to link to" },
-        questionId: { type: "string", description: "The question to attach" },
-    },
-    required: ["worktreeId", "questionId"],
-    response: {
-        description: "The question-worktree link",
-        fields: { linkId: "string", worktreeId: "string", questionId: "string" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const LINK_BELIEF_TO_WORKTREE = {
-    name: "link_belief_to_worktree",
-    description: "Attach beliefs to a worktree for investigation. " +
-        "Like `git cherry-pick` — selecting specific beliefs to investigate in this branch. " +
-        "Linked beliefs become the target of evidence collection and scoring.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree to link to" },
-        beliefId: { type: "string", description: "The belief to attach" },
-        role: {
-            type: "string",
-            description: "Role of the belief in this worktree",
-            enum: ["primary", "supporting", "challenging"],
-        },
-    },
-    required: ["worktreeId", "beliefId"],
-    response: {
-        description: "The belief-worktree link",
-        fields: {
-            linkId: "string",
-            worktreeId: "string",
-            beliefId: "string",
-            role: "string",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const CREATE_SYNTHESIZED_BELIEF = {
-    name: "create_synthesized_belief",
-    description: "Consolidate draft artifacts into a synthesized belief. " +
-        "Like `git squash` — combining multiple commits into a single coherent unit. " +
-        "Takes multiple draft beliefs, evidence, and notes and produces one synthesized belief.",
-    parameters: {
-        worktreeId: {
-            type: "string",
-            description: "The worktree context for synthesis",
-        },
-        sourceBeliefIds: {
-            type: "array",
-            description: "Draft beliefs to consolidate",
-        },
-        canonicalText: {
-            type: "string",
-            description: "The synthesized belief statement",
-        },
-        synthesisRationale: {
-            type: "string",
-            description: "How the synthesis was derived",
-        },
-    },
-    required: ["worktreeId", "sourceBeliefIds", "canonicalText"],
-    response: {
-        description: "The synthesized belief",
-        fields: {
-            nodeId: "string",
-            sourceCount: "number",
-            synthesisRationale: "string",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const COMPLETE_HYPOTHESIS_FORMATION = {
-    name: "complete_hypothesis_formation",
-    description: "Phase gate for hypothesis formation completion. " +
-        "Like `git tag` marking a milestone — certifies that the hypothesis formation phase is done. " +
-        "Validates that the worktree has a testable hypothesis and linked beliefs.",
-    parameters: {
-        worktreeId: {
-            type: "string",
-            description: "The worktree completing hypothesis formation",
-        },
-        summary: { type: "string", description: "Summary of hypotheses formed" },
-    },
-    required: ["worktreeId"],
-    response: {
-        description: "Phase gate result",
-        fields: {
-            worktreeId: "string",
-            passed: "boolean",
-            newPhase: "string",
-            failedChecks: "array | null",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const COMPLETE_EVIDENCE_REVIEW = {
-    name: "complete_evidence_review",
-    description: "Phase gate for evidence review completion. " +
-        "Like `git tag` marking evidence collection complete — certifies that sufficient evidence " +
-        "has been gathered and reviewed for the worktree to proceed to synthesis.",
-    parameters: {
-        worktreeId: {
-            type: "string",
-            description: "The worktree completing evidence review",
-        },
-        summary: { type: "string", description: "Summary of evidence reviewed" },
-    },
-    required: ["worktreeId"],
-    response: {
-        description: "Phase gate result",
-        fields: {
-            worktreeId: "string",
-            passed: "boolean",
-            newPhase: "string",
-            evidenceCount: "number",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "worktree",
-    tier: "sdk-only",
-};
-export const REFINE_WORKTREE_BELIEF = {
-    name: "refine_worktree_belief",
-    description: "Amend a belief within a worktree context. " +
-        "Like `git commit --amend` on a feature branch — rewrites draft belief text " +
-        "while maintaining worktree context and linked evidence.",
-    parameters: {
-        worktreeId: { type: "string", description: "The worktree context" },
-        beliefId: { type: "string", description: "The belief to refine" },
-        canonicalText: { type: "string", description: "Updated belief statement" },
-        rationale: { type: "string", description: "Why the refinement was made" },
-    },
-    required: ["worktreeId", "beliefId", "canonicalText"],
-    response: {
-        description: "The refined belief within worktree context",
-        fields: { beliefId: "string", worktreeId: "string", updatedAt: "number" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-// =============================================================================
-// 3.2 DEEPER GRAPH NAVIGATION (6 tools)
-// =============================================================================
-export const TRACE_PROVENANCE = {
-    name: "trace_provenance",
-    description: "Fast lineage trace for any node type in the reasoning graph. " +
-        "Like `git log --follow` — tracks renames, forks, and full ancestry chain. " +
-        "Works on beliefs, evidence, questions, and judgments alike.",
-    parameters: {
-        nodeId: { type: "string", description: "The node to trace provenance for" },
-        depth: {
-            type: "number",
-            description: "Maximum ancestry depth (default: 10)",
-        },
-        includeEdgeTypes: {
-            type: "array",
-            description: "Filter to specific edge types",
-        },
-    },
-    required: ["nodeId"],
-    response: {
-        description: "Provenance chain with typed ancestry",
-        fields: {
-            chain: "array — ancestry nodes",
-            edges: "array — connecting edges",
-            totalDepth: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-export const GET_BELIEF_RELATIONSHIPS = {
-    name: "get_belief_relationships",
-    description: "Get structured cluster-edge map for a belief, grouped by relationship type. " +
-        "Like `git show --stat` — a relationship summary showing all connections. " +
-        "Returns evidence, questions, contradictions, forks, and dependent judgments.",
-    parameters: {
-        nodeId: { type: "string", description: "The belief to analyze" },
-    },
-    required: ["nodeId"],
-    response: {
-        description: "Relationships grouped by type",
-        fields: {
-            evidence: "array — linked evidence nodes",
-            questions: "array — testing questions",
-            contradictions: "array — flagged contradictions",
-            forks: "array — child forks",
-            judgments: "array — dependent judgments",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const GET_BELIEF_SUPPORT_CHAIN = {
-    name: "get_belief_support_chain",
-    description: "Full Neo4j traversal: Belief <- Question <- Evidence support chain. " +
-        "Like `git log --graph --all` — the richest evidence retrieval path. " +
-        "Returns the complete support structure showing how evidence flows through questions to beliefs.",
-    parameters: {
-        nodeId: { type: "string", description: "The belief to trace support for" },
-        includeWeights: {
-            type: "boolean",
-            description: "Include edge weights in response",
-        },
-    },
-    required: ["nodeId"],
-    response: {
-        description: "Full support chain from evidence through questions to belief",
-        fields: {
-            belief: "object — the target belief",
-            questions: "array — testing questions with their evidence",
-            totalEvidenceCount: "number",
-            netSupportWeight: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const EXPLORE_CONNECTIONS = {
-    name: "explore_connections",
-    description: "Multi-hop neighbor exploration via Neo4j graph traversal. " +
-        "Like `git log --all --oneline` — broad discovery of connected nodes. " +
-        "Explores outward from a starting node across multiple hops, returning the discovered subgraph.",
-    parameters: {
-        nodeId: { type: "string", description: "Starting node for exploration" },
-        hops: {
-            type: "number",
-            description: "Number of hops to explore (default: 2, max: 5)",
-        },
-        nodeTypes: { type: "array", description: "Filter to specific node types" },
-    },
-    required: ["nodeId"],
-    response: {
-        description: "Discovered subgraph with nodes and edges",
-        fields: {
-            nodes: "array — discovered nodes",
-            edges: "array — connecting edges",
-            hopsTraversed: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-export const GET_DEEP_LINEAGE = {
-    name: "get_deep_lineage",
-    description: "10-level Neo4j ancestry traversal for deep history. " +
-        "Like `git log -10 --graph` — traces deep fork chains, supersedes edges, and confidence evolution. " +
-        "Returns the full ancestor tree with fork reasons and scoring history at each level.",
-    parameters: {
-        nodeId: {
-            type: "string",
-            description: "The node to trace deep lineage for",
-        },
-        maxDepth: {
-            type: "number",
-            description: "Maximum depth (default: 10, max: 20)",
-        },
-    },
-    required: ["nodeId"],
-    response: {
-        description: "Deep lineage tree with fork reasons and scoring history",
-        fields: {
-            tree: "object — nested ancestry tree",
-            totalDepth: "number",
-            forkCount: "number",
-            oldestAncestor: "object — the root ancestor",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-export const GRAPH_AWARE_SEARCH = {
-    name: "graph_aware_search",
-    description: "Vector search enhanced with graph context expansion. " +
-        "Like `git grep` combined with graph neighborhood — finds semantically similar nodes " +
-        "then expands results by following graph edges to include structurally related context.",
-    parameters: {
-        query: { type: "string", description: "Semantic search query" },
-        topicId: { type: "string", description: "Topic scope" },
-        projectId: {
-            type: "string",
-            description: "Deprecated legacy alias for topic scope",
-        },
-        expansionHops: {
-            type: "number",
-            description: "Graph expansion depth after vector search (default: 1)",
-        },
-        limit: { type: "number", description: "Maximum results (default: 10)" },
-    },
-    required: ["query", "topicId"],
-    response: {
-        description: "Search results with graph-expanded context",
-        fields: {
-            results: "array — { nodeId, canonicalText, score, graphContext }",
-            expandedNodes: "number — additional nodes from graph expansion",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-// =============================================================================
-// 3.3 CONVICTION & ANALYTICS (7 tools)
-// =============================================================================
-export const GET_COLLECTION_CONVICTION = {
-    name: "get_collection_conviction",
-    description: "Aggregate conviction score across a set of beliefs. " +
-        "Like `git shortlog` — 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 — confidence histogram",
-            beliefCount: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const GET_CONVICTION_TREND = {
-    name: "get_conviction_trend",
-    description: "Time-series conviction analysis with pillar-level breakdown. " +
-        "Like `git log --graph --stat` over time — 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 — { timestamp, averageConfidence, beliefCount, scoringEvents }",
-            pillarBreakdown: "object — per-domain conviction trends",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const ANALYZE_BELIEF_CRITICALITY = {
-    name: "analyze_belief_criticality",
-    description: "Criticality scoring for belief validation prioritization. " +
-        "Like `git bisect` for importance — 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 — { nodeId, canonicalText, criticalityScore, dependentCount, centralityScore }",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const ANALYZE_BELIEF_CLUSTER_CANDIDATES = {
-    name: "analyze_belief_cluster_candidates",
-    description: "Cross-project deduplication and similarity discovery. " +
-        "Like `git cherry` — 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 — { beliefs: array, similarityScore: number, suggestedAction: string }",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const CREATE_BELIEF_CONDITIONAL = {
-    name: "create_belief_conditional",
-    description: "Create prerequisite or falsifier dependency edges between beliefs. " +
-        "Like `git config` for conditional logic — 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: "graph-primitives",
-    ontologyPrimitive: "edge",
-    tier: "sdk-only",
-};
-export const GET_NECESSARY_EVIDENCE = {
-    name: "get_necessary_evidence",
-    description: "Identify evidence requirements for merge readiness. " +
-        "Like `git status` before merge — 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 — beliefs without supporting evidence",
-            unansweredQuestions: "array — open questions",
-            weakSupport: "array — beliefs with insufficient evidence weight",
-            mergeReadiness: "number — 0-1 readiness score",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-export const ANALYZE_REASONING_DEPTH = {
-    name: "analyze_reasoning_depth",
-    description: "Per-belief evidence grounding depth analysis. " +
-        "Like `git log --graph` depth analysis — 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 — { nodeId, depth, evidenceCount, sourceCount, groundingScore }",
-            averageDepth: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-// =============================================================================
-// 3.4 EXTENDED QUESTION & EVIDENCE ANALYTICS (1 SDK-only tool; core lifecycle moved to MCP)
-// =============================================================================
-export const GET_EVIDENCE_BY_METHODOLOGY = {
-    name: "get_evidence_by_methodology",
-    description: "Evidence grouped by collection methodology. " +
-        "Like `git log --format` with custom grouping — 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 — { methodology: array of evidence nodes }",
-            totalCount: "number",
-            methodologyCoverage: "object — percentage breakdown",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-// =============================================================================
-// 3.5 TASK LIFECYCLE (5 tools)
-// =============================================================================
-export const CREATE_EVIDENCE_TASK = {
-    name: "create_evidence_task",
-    description: "Create an evidence-focused work item with structured collection template. " +
-        "Like `git task` with evidence template — 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 — 'pending'",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "task",
-    tier: "sdk-only",
-};
-export const LIST_TASKS = {
-    name: "list_tasks",
-    description: "List tasks with filters for status, type, and assignment. " +
-        "Like `git task list` — returns work items with their current state, " +
-        "linked questions, and completion status.",
-    parameters: {
-        topicId: { type: "string", description: "Topic scope" },
-        projectId: {
-            type: "string",
-            description: "Deprecated legacy alias for topic scope",
-        },
-        status: {
-            type: "string",
-            description: "Filter by status",
-            enum: ["pending", "in_progress", "completed", "cancelled"],
-        },
-        taskType: {
-            type: "string",
-            description: "Filter by type",
-            enum: ["research", "interview", "analysis", "data_collection"],
-        },
-        worktreeId: { type: "string", description: "Filter to worktree scope" },
-    },
-    required: ["topicId"],
-    response: {
-        description: "Task list with metadata",
-        fields: {
-            tasks: "array — { taskId, title, status, taskType, linkedQuestionId, createdAt }",
-        },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "task",
-    tier: "sdk-only",
-};
-export const UPDATE_TASK = {
-    name: "update_task",
-    description: "Amend a task's details, status, or linked entities. " +
-        "Like `git task update` — updates task metadata, status transitions, reassignment, or relinks to a different worktree/belief/question. " +
-        "All changes are logged in the audit trail.",
-    parameters: {
-        taskId: { type: "string", description: "The task to update" },
-        linkedWorktreeId: {
-            type: "string",
-            description: "Reassign this task to a different worktree",
-        },
-        linkedBeliefId: {
-            type: "string",
-            description: "Link or relink this task to a belief node",
-        },
-        linkedQuestionId: {
-            type: "string",
-            description: "Link or relink this task to a question node",
-        },
-        title: { type: "string", description: "Updated title" },
-        description: {
-            type: "string",
-            description: "Updated task description",
-        },
-        priority: {
-            type: "string",
-            description: "Updated priority",
-            enum: ["critical", "high", "medium", "low"],
-        },
-        status: {
-            type: "string",
-            description: "New status",
-            enum: ["pending", "in_progress", "completed", "cancelled"],
-        },
-        notes: { type: "string", description: "Additional notes" },
-    },
-    required: ["taskId"],
-    response: {
-        description: "The updated task",
-        fields: { taskId: "string", status: "string", updatedAt: "number" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "task",
-    tier: "sdk-only",
-};
-export const GET_TASK_COUNTS = {
-    name: "get_task_counts",
-    description: "Dashboard aggregate counts for task status distribution. " +
-        "Like `git shortlog -s` for tasks — 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 — { group: number }", total: "number" },
-    },
-    ownerModule: "workflow-engine",
-    ontologyPrimitive: "task",
-    tier: "sdk-only",
-};
-export const ADD_RESEARCH_ACTION = {
-    name: "add_research_action",
-    description: "Append a concrete next action to a task. " +
-        "Like `git notes append` for tasks — 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",
-};
-// =============================================================================
-// 3.6 DOMAIN ANALYTICS (8 tools)
-// =============================================================================
-export const GET_PREDICTIONS = {
-    name: "get_predictions",
-    description: "Calibration tracking for prediction-bearing beliefs. " +
-        "Like `git tag --verify` for prediction accuracy — 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 — { beliefId, prediction, statedConfidence, outcome, calibrationDelta }",
-            overallCalibration: "number — Brier score or equivalent",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const GET_SURPRISE_DETECTION = {
-    name: "get_surprise_detection",
-    description: "Analysis of ignored vs integrated surprise findings. " +
-        "Like `git diff --stat` for unexpected findings — 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 — { evidenceId, surpriseScore, integrated, affectedBeliefs }",
-            ignoredCount: "number",
-            integratedCount: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-export const GET_CHALLENGED_BELIEFS = {
-    name: "get_challenged_beliefs",
-    description: "Find beliefs downstream of contradiction detection. " +
-        "Like `git log --grep=conflict` — 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 — { nodeId, canonicalText, challengeCount, contradictions, negativeEvidence }",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const GET_CAUSAL_CHAINS = {
-    name: "get_causal_chains",
-    description: "Trace cause/effect lineage through the reasoning graph. " +
-        "Like `git log --ancestry-path` — 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 — { path: array, strength: number, chainType: string }",
-            totalChains: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-export const GET_NON_CONSENSUS_BELIEFS = {
-    name: "get_non_consensus_beliefs",
-    description: "Detect contrarian positions in the belief graph. " +
-        "Like `git log --no-merges` — 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 — { nodeId, canonicalText, consensusScore, dissentingSources, supportingSources }",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const 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 — 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 — { nodeId, canonicalText, confidence, epistemicStatus, lastModulated }",
-            count: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const GET_PRIVILEGED_EVIDENCE = {
-    name: "get_privileged_evidence",
-    description: "Retrieve high-value evidence with access characteristics. " +
-        "Like `git log --author` filtering for key sources — identifies evidence from privileged access: " +
-        "primary interviews, proprietary data, non-public filings, expert networks.",
-    parameters: {
-        topicId: { type: "string", description: "Topic scope" },
-        projectId: {
-            type: "string",
-            description: "Deprecated legacy alias for topic scope",
-        },
-        accessType: {
-            type: "string",
-            description: "Filter by access type",
-            enum: [
-                "primary_interview",
-                "proprietary_data",
-                "non_public",
-                "expert_network",
-                "field_research",
-            ],
-        },
-    },
-    required: ["topicId"],
-    response: {
-        description: "Privileged evidence items",
-        fields: {
-            evidence: "array — { nodeId, canonicalText, accessType, sourceDescription, linkedBeliefs }",
-            totalCount: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-export const GET_PRIVILEGED_SIGNALS = {
-    name: "get_privileged_signals",
-    description: "Aggregate high-signal patterns across evidence. " +
-        "Like `git shortlog --summary` for signal strength — identifies recurring patterns " +
-        "across privileged evidence sources that may indicate strong conviction drivers.",
-    parameters: {
-        topicId: { type: "string", description: "Topic scope" },
-        projectId: {
-            type: "string",
-            description: "Deprecated legacy alias for topic scope",
-        },
-        minSignalStrength: {
-            type: "number",
-            description: "Minimum signal score (0-1, default: 0.7)",
-        },
-    },
-    required: ["topicId"],
-    response: {
-        description: "Aggregated signal patterns",
-        fields: {
-            signals: "array — { pattern, signalStrength, evidenceCount, sources, affectedBeliefs }",
-            totalSignals: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-// =============================================================================
-// 3.7 BIAS DETECTION SUITE (5 tools)
-// detect_confirmation_bias is in the MCP surface
-// =============================================================================
-export const DETECT_ANCHORING_BIAS = {
-    name: "detect_anchoring_bias",
-    description: "Detect old unchallenged beliefs that may anchor reasoning. " +
-        "Like `git log --before` — 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 — { nodeId, canonicalText, daysSinceLastEvidence, originalConfidence, currentConfidence }",
-            riskLevel: "string — overall anchoring risk",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const DETECT_SOURCE_CONCENTRATION = {
-    name: "detect_source_concentration",
-    description: "Detect single-source evidence risk across beliefs. " +
-        "Like `git shortlog` showing only one contributor — 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 — { nodeId, canonicalText, dominantSource, concentrationRatio, uniqueSourceCount }",
-            highRiskCount: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "evidence",
-    tier: "sdk-only",
-};
-export const 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 — 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 — { beliefA, beliefB, tensionScore, tensionDescription }",
-            totalPairs: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "belief",
-    tier: "sdk-only",
-};
-export const FIND_SEMANTIC_BRIDGES = {
-    name: "find_semantic_bridges",
-    description: "Find semantically similar but graph-distant nodes. " +
-        "Like `git cherry` — 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 — { nodeA, nodeB, semanticSimilarity, graphDistance, suggestedEdgeType }",
-            totalBridges: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-export const FIND_SEMANTIC_ORPHANS = {
-    name: "find_semantic_orphans",
-    description: "Find structurally connected but semantically distant nodes. " +
-        "Like `git fsck --lost-found` — 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 — { nodeId, connectedTo, semanticSimilarity, edgeType, suggestedAction }",
-            totalOrphans: "number",
-        },
-    },
-    ownerModule: "graph-search",
-    ontologyPrimitive: "graph",
-    tier: "sdk-only",
-};
-// =============================================================================
-// SDK-ONLY TOOL REGISTRY
-// =============================================================================
-/** All SDK-only tool contracts, indexed by name */
-export const SDK_ONLY_TOOL_CONTRACTS = {
-    // 3.1 Advanced workflow & phase management
-    start_worktree: START_WORKTREE,
-    update_worktree_phase: UPDATE_WORKTREE_PHASE,
-    advance_worktree_phase: ADVANCE_WORKTREE_PHASE,
-    add_note_to_worktree: ADD_NOTE_TO_WORKTREE,
-    link_document_to_worktree: LINK_DOCUMENT_TO_WORKTREE,
-    link_evidence_to_worktree: LINK_EVIDENCE_TO_WORKTREE,
-    link_question_to_worktree: LINK_QUESTION_TO_WORKTREE,
-    link_belief_to_worktree: LINK_BELIEF_TO_WORKTREE,
-    create_synthesized_belief: CREATE_SYNTHESIZED_BELIEF,
-    complete_hypothesis_formation: COMPLETE_HYPOTHESIS_FORMATION,
-    complete_evidence_review: COMPLETE_EVIDENCE_REVIEW,
-    refine_worktree_belief: REFINE_WORKTREE_BELIEF,
-    // 3.2 Deeper graph navigation
-    trace_provenance: TRACE_PROVENANCE,
-    get_belief_relationships: GET_BELIEF_RELATIONSHIPS,
-    get_belief_support_chain: GET_BELIEF_SUPPORT_CHAIN,
-    explore_connections: EXPLORE_CONNECTIONS,
-    get_deep_lineage: GET_DEEP_LINEAGE,
-    graph_aware_search: GRAPH_AWARE_SEARCH,
-    // 3.3 Conviction & analytics
-    get_collection_conviction: GET_COLLECTION_CONVICTION,
-    get_conviction_trend: GET_CONVICTION_TREND,
-    analyze_belief_criticality: ANALYZE_BELIEF_CRITICALITY,
-    analyze_belief_cluster_candidates: ANALYZE_BELIEF_CLUSTER_CANDIDATES,
-    create_belief_conditional: CREATE_BELIEF_CONDITIONAL,
-    get_necessary_evidence: GET_NECESSARY_EVIDENCE,
-    analyze_reasoning_depth: ANALYZE_REASONING_DEPTH,
-    // 3.4 Extended question & evidence analytics
-    get_evidence_by_methodology: GET_EVIDENCE_BY_METHODOLOGY,
-    // 3.5 Task lifecycle (list_tasks + update_task are MCP tools, not SDK-only)
-    create_evidence_task: CREATE_EVIDENCE_TASK,
-    get_task_counts: GET_TASK_COUNTS,
-    add_research_action: ADD_RESEARCH_ACTION,
-    // 3.6 Domain analytics
-    get_predictions: GET_PREDICTIONS,
-    get_surprise_detection: GET_SURPRISE_DETECTION,
-    get_challenged_beliefs: GET_CHALLENGED_BELIEFS,
-    get_causal_chains: GET_CAUSAL_CHAINS,
-    get_non_consensus_beliefs: GET_NON_CONSENSUS_BELIEFS,
-    get_beliefs_by_epistemic_status: GET_BELIEFS_BY_EPISTEMIC_STATUS,
-    get_privileged_evidence: GET_PRIVILEGED_EVIDENCE,
-    get_privileged_signals: GET_PRIVILEGED_SIGNALS,
-    // 3.7 Bias detection suite (detect_confirmation_bias is in MCP)
-    detect_anchoring_bias: DETECT_ANCHORING_BIAS,
-    detect_source_concentration: DETECT_SOURCE_CONCENTRATION,
-    find_soft_contradictions: FIND_SOFT_CONTRADICTIONS,
-    find_semantic_bridges: FIND_SEMANTIC_BRIDGES,
-    find_semantic_orphans: FIND_SEMANTIC_ORPHANS,
-};
-// =============================================================================
-// MERGED SDK SURFACE
-// =============================================================================
-/** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
-export const ALL_SDK_TOOL_CONTRACTS = {
-    ...MCP_TOOL_CONTRACTS,
-    ...SDK_ONLY_TOOL_CONTRACTS,
-};
-/** All SDK-only tool names */
-export const SDK_ONLY_TOOL_NAMES = Object.keys(SDK_ONLY_TOOL_CONTRACTS);
-/** All tool names across the complete SDK surface */
-export const ALL_SDK_TOOL_NAMES = Object.keys(ALL_SDK_TOOL_CONTRACTS);
-/**
- * Lint validation: every SDK tool description must contain "Like `git" reference.
- * Reuses the same git-semantic validation rule as MCP tools.
- */
-export function validateSdkGitSemantics(tool) {
-    const desc = tool.description;
-    const hasGitReference = /Like (`git |a `git |a merge conflict|opening a `git)/.test(desc);
-    if (!hasGitReference) {
-        return {
-            valid: false,
-            reason: `SDK tool "${tool.name}" description missing git-semantic reference`,
-        };
-    }
-    return { valid: true };
-}
-//# sourceMappingURL=sdk-tools.contract.js.map