@lucern/contracts 0.1.0-alpha.1

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

@@ -0,0 +1,93 @@
+/**
+ * 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 type { McpToolContract } from "./mcp-tools.contract";
+/** SDK-only tool contract — same shape as MCP but with sdk-only tier marker */
+export interface SdkToolContract extends Omit<McpToolContract, "tier"> {
+    tier: "sdk-only";
+}
+export declare const START_WORKTREE: SdkToolContract;
+export declare const UPDATE_WORKTREE_PHASE: SdkToolContract;
+export declare const ADVANCE_WORKTREE_PHASE: SdkToolContract;
+export declare const ADD_NOTE_TO_WORKTREE: SdkToolContract;
+export declare const LINK_DOCUMENT_TO_WORKTREE: SdkToolContract;
+export declare const LINK_EVIDENCE_TO_WORKTREE: SdkToolContract;
+export declare const LINK_QUESTION_TO_WORKTREE: SdkToolContract;
+export declare const LINK_BELIEF_TO_WORKTREE: SdkToolContract;
+export declare const CREATE_SYNTHESIZED_BELIEF: SdkToolContract;
+export declare const COMPLETE_HYPOTHESIS_FORMATION: SdkToolContract;
+export declare const COMPLETE_EVIDENCE_REVIEW: SdkToolContract;
+export declare const REFINE_WORKTREE_BELIEF: SdkToolContract;
+export declare const TRACE_PROVENANCE: SdkToolContract;
+export declare const GET_BELIEF_RELATIONSHIPS: SdkToolContract;
+export declare const GET_BELIEF_SUPPORT_CHAIN: SdkToolContract;
+export declare const EXPLORE_CONNECTIONS: SdkToolContract;
+export declare const GET_DEEP_LINEAGE: SdkToolContract;
+export declare const GRAPH_AWARE_SEARCH: SdkToolContract;
+export declare const GET_COLLECTION_CONVICTION: SdkToolContract;
+export declare const GET_CONVICTION_TREND: SdkToolContract;
+export declare const ANALYZE_BELIEF_CRITICALITY: SdkToolContract;
+export declare const ANALYZE_BELIEF_CLUSTER_CANDIDATES: SdkToolContract;
+export declare const CREATE_BELIEF_CONDITIONAL: SdkToolContract;
+export declare const GET_NECESSARY_EVIDENCE: SdkToolContract;
+export declare const ANALYZE_REASONING_DEPTH: SdkToolContract;
+export declare const GET_EVIDENCE_BY_METHODOLOGY: SdkToolContract;
+export declare const CREATE_EVIDENCE_TASK: SdkToolContract;
+export declare const LIST_TASKS: SdkToolContract;
+export declare const UPDATE_TASK: SdkToolContract;
+export declare const GET_TASK_COUNTS: SdkToolContract;
+export declare const ADD_RESEARCH_ACTION: SdkToolContract;
+export declare const GET_PREDICTIONS: SdkToolContract;
+export declare const GET_SURPRISE_DETECTION: SdkToolContract;
+export declare const GET_CHALLENGED_BELIEFS: SdkToolContract;
+export declare const GET_CAUSAL_CHAINS: SdkToolContract;
+export declare const GET_NON_CONSENSUS_BELIEFS: SdkToolContract;
+export declare const GET_BELIEFS_BY_EPISTEMIC_STATUS: SdkToolContract;
+export declare const GET_PRIVILEGED_EVIDENCE: SdkToolContract;
+export declare const GET_PRIVILEGED_SIGNALS: SdkToolContract;
+export declare const DETECT_ANCHORING_BIAS: SdkToolContract;
+export declare const DETECT_SOURCE_CONCENTRATION: SdkToolContract;
+export declare const FIND_SOFT_CONTRADICTIONS: SdkToolContract;
+export declare const FIND_SEMANTIC_BRIDGES: SdkToolContract;
+export declare const FIND_SEMANTIC_ORPHANS: SdkToolContract;
+/** All SDK-only tool contracts, indexed by name */
+export declare const SDK_ONLY_TOOL_CONTRACTS: Record<string, SdkToolContract>;
+/** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
+export declare const ALL_SDK_TOOL_CONTRACTS: Record<string, McpToolContract | SdkToolContract>;
+/** All SDK-only tool names */
+export declare const SDK_ONLY_TOOL_NAMES: string[];
+/** All tool names across the complete SDK surface */
+export declare const ALL_SDK_TOOL_NAMES: string[];
+/**
+ * Lint validation: every SDK tool description must contain "Like `git" reference.
+ * Reuses the same git-semantic validation rule as MCP tools.
+ */
+export declare function validateSdkGitSemantics(tool: SdkToolContract): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=sdk-tools.contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-tools.contract.d.ts","sourceRoot":"","sources":["../src/sdk-tools.contract.ts"],"names":[],"mappings":"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"}