@lucern/contracts 0.1.0 → 0.1.2-alpha.1

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

@@ -1,32 +1,37 @@
+import { EpistemicLayer, BeliefStatus, ConfidenceTrigger, ForkReason, ContradictionSeverity, DefeatType, ReasoningMethod, MergeOutcome, JudgmentType, BranchStatus, PullRequestStatus } from './api-enums.contract.js';
+import { ContextRankingProfile, PublicCompiledContext } from './context-pack.contract.js';
+
 /**
  * SDK Method Contract Definitions
  *
  * Canonical method signatures for the Lucern TypeScript SDK.
  * DERIVED from API contracts — not independently authored.
  *
- * These types define the public API of the SDK packages:
- *   @lucern/sdk-core   — client initialization
- *   @lucern/sdk-graph  — belief, evidence, edge, contradiction operations
- *   @lucern/sdk-workflows — branch, worktree, merge, push, pull request lifecycle
+ * These types define the public API of `@lucern/sdk`, covering:
+ *   - client initialization (formerly @lucern/sdk-core)
+ *   - belief, evidence, edge, contradiction operations (formerly @lucern/sdk-graph)
+ *   - branch, worktree, merge, push, pull request lifecycle (formerly @lucern/sdk-workflows)
+ *
+ * Historical note: T7.3.2 (2026-04-18) deleted the three sdk-alpha shim
+ * packages; all surfaces now ship in the single `@lucern/sdk` package.
  *
  * CONTRACT SURFACE: Method signatures are semver-bound.
  * Adding optional parameters is non-breaking.
  * Changing required parameters or return types is BREAKING.
  */
-import type { BeliefStatus, BranchStatus, ConfidenceTrigger, ContradictionSeverity, DefeatType, EpistemicLayer, ForkReason, JudgmentType, MergeOutcome, PullRequestStatus, ReasoningMethod } from "./api-enums.contract";
-import type { ContextRankingProfile, PublicCompiledContext } from "./context-pack.contract";
-export type LucernClientConfig = {
+
+type LucernClientConfig = {
     apiKey: string;
     environment: "sandbox" | "production";
     /** Optional base URL override for self-hosted deployments */
     baseUrl?: string;
 };
-export type LucernClient = {
+type LucernClient = {
     /** The authenticated client instance */
     readonly config: LucernClientConfig;
 };
 /** Input to createBelief() */
-export type CreateBeliefInput = {
+type CreateBeliefInput = {
     canonicalText: string;
     topicId: string;
     /** @deprecated Use topicId. */
@@ -36,7 +41,7 @@ export type CreateBeliefInput = {
     nodeType?: string;
 };
 /** Result of createBelief() */
-export type BeliefResult = {
+type BeliefResult = {
     nodeId: string;
     globalId: string;
     canonicalText: string;
@@ -44,37 +49,37 @@ export type BeliefResult = {
     createdAt: number;
 };
 /** Input to refineBelief() */
-export type RefineBeliefInput = {
+type RefineBeliefInput = {
     canonicalText: string;
     rationale?: string;
 };
 /** Input to modulateConfidence() */
-export type ModulateConfidenceInput = {
+type ModulateConfidenceInput = {
     confidence: number;
     trigger: ConfidenceTrigger;
     rationale: string;
 };
 /** Result of modulateConfidence() */
-export type ConfidenceResult = {
+type ConfidenceResult = {
     nodeId: string;
     newConfidence: number;
     previousConfidence: number | null;
     trigger: ConfidenceTrigger;
 };
 /** Input to forkBelief() */
-export type ForkBeliefInput = {
+type ForkBeliefInput = {
     newFormulation: string;
     forkReason: ForkReason;
 };
 /** Result of forkBelief() */
-export type ForkResult = {
+type ForkResult = {
     nodeId: string;
     parentNodeId: string;
     forkReason: ForkReason;
     canonicalText: string;
 };
 /** Input to addEvidence() */
-export type AddEvidenceInput = {
+type AddEvidenceInput = {
     canonicalText: string;
     topicId: string;
     /** @deprecated Use topicId. */
@@ -87,13 +92,13 @@ export type AddEvidenceInput = {
     };
 };
 /** Result of addEvidence() */
-export type EvidenceResult = {
+type EvidenceResult = {
     nodeId: string;
     globalId: string;
     edgeId?: string;
 };
 /** Input to flagContradiction() */
-export type FlagContradictionInput = {
+type FlagContradictionInput = {
     beliefA: string;
     beliefB: string;
     description: string;
@@ -104,7 +109,7 @@ export type FlagContradictionInput = {
     defeatType?: DefeatType;
 };
 /** Result of flagContradiction() */
-export type ContradictionResult = {
+type ContradictionResult = {
     contradictionId: string;
     status: "unresolved";
     beliefA: string;
@@ -112,7 +117,7 @@ export type ContradictionResult = {
     defeatType?: DefeatType;
 };
 /** Input to createEdge() */
-export type CreateEdgeInput = {
+type CreateEdgeInput = {
     sourceId: string;
     targetId: string;
     edgeType: string;
@@ -121,18 +126,18 @@ export type CreateEdgeInput = {
     reasoningMethod?: ReasoningMethod;
 };
 /** Result of createEdge() */
-export type EdgeResult = {
+type EdgeResult = {
     globalId: string;
     edgeType: string;
     fromLayer: EpistemicLayer;
     toLayer: EpistemicLayer;
 };
 /** Input to queryLineage() */
-export type QueryLineageInput = {
+type QueryLineageInput = {
     depth?: number;
 };
 /** Result of queryLineage() */
-export type LineageResult = {
+type LineageResult = {
     chain: Array<{
         nodeId: string;
         canonicalText: string;
@@ -144,7 +149,7 @@ export type LineageResult = {
     depth: number;
 };
 /** Input to searchBeliefs() */
-export type SearchBeliefsInput = {
+type SearchBeliefsInput = {
     query: string;
     status?: BeliefStatus;
     minConfidence?: number;
@@ -154,7 +159,7 @@ export type SearchBeliefsInput = {
     limit?: number;
 };
 /** Input to context.compile() */
-export type CompileContextInput = {
+type CompileContextInput = {
     query?: string;
     budget?: number;
     ranking?: ContextRankingProfile;
@@ -163,9 +168,9 @@ export type CompileContextInput = {
     includeEntities?: boolean;
 };
 /** Result of context.compile() */
-export type CompiledContextResult = PublicCompiledContext;
+type CompiledContextResult = PublicCompiledContext;
 /** Input to addWorktree() — like git worktree add <branch> */
-export type AddWorktreeInput = {
+type AddWorktreeInput = {
     title: string;
     topicId: string;
     /** @deprecated Use topicId. */
@@ -182,7 +187,7 @@ export type AddWorktreeInput = {
     gate?: string;
 };
 /** Result of addWorktree() */
-export type WorktreeResult = {
+type WorktreeResult = {
     worktreeId: string;
     title: string;
     status: string;
@@ -192,7 +197,7 @@ export type WorktreeResult = {
     autoShapeApplied?: boolean;
 };
 /** Input to merge() */
-export type MergeInput = {
+type MergeInput = {
     outcomes: Array<{
         beliefId: string;
         confidence: number;
@@ -201,14 +206,14 @@ export type MergeInput = {
     summary?: string;
 };
 /** Result of merge() */
-export type MergeResult = {
+type MergeResult = {
     worktreeId: string;
     status: "merged";
     outcome: MergeOutcome;
     beliefsScored: number;
 };
 /** Input to recordJudgment() */
-export type RecordJudgmentInput = {
+type RecordJudgmentInput = {
     title: string;
     rationale: string;
     topicId: string;
@@ -219,13 +224,13 @@ export type RecordJudgmentInput = {
     judgmentType?: JudgmentType;
 };
 /** Result of recordJudgment() */
-export type JudgmentResult = {
+type JudgmentResult = {
     judgmentId: string;
     title: string;
     status: "issued";
 };
 /** Input to createBranch() */
-export type CreateBranchInput = {
+type CreateBranchInput = {
     name: string;
     topicId: string;
     /** @deprecated Use topicId. */
@@ -233,36 +238,36 @@ export type CreateBranchInput = {
     description?: string;
 };
 /** Result of createBranch() */
-export type BranchResult = {
+type BranchResult = {
     branchId: string;
     name: string;
     status: BranchStatus;
     createdAt: number;
 };
 /** Input to push() */
-export type PushInput = {
+type PushInput = {
     targetContext: string;
     beliefIds?: string[];
 };
 /** Result of push() */
-export type PushResult = {
+type PushResult = {
     pushedCount: number;
     targetContext: string;
     pushedAt: number;
 };
 /** Input to openPullRequest() */
-export type OpenPullRequestInput = {
+type OpenPullRequestInput = {
     reviewers?: string[];
     summary: string;
 };
 /** Result of openPullRequest() */
-export type PullRequestResult = {
+type PullRequestResult = {
     pullRequestId: string;
     worktreeId: string;
     status: PullRequestStatus;
 };
 /** Input to bisectConfidence() */
-export type BisectConfidenceInput = {
+type BisectConfidenceInput = {
     expectedDirection: "overconfident" | "underconfident";
     timeRange?: {
         start: number;
@@ -270,7 +275,7 @@ export type BisectConfidenceInput = {
     };
 };
 /** Result of bisectConfidence() */
-export type BisectResult = {
+type BisectResult = {
     inflectionEntry: {
         confidence: number;
         trigger: ConfidenceTrigger;
@@ -282,12 +287,12 @@ export type BisectResult = {
     confidenceAfter: number;
 };
 /**
- * @lucern/sdk-graph method signatures.
+ * @lucern/sdk (graph) method signatures.
  *
  * These define the public API. Implementation must match these signatures.
  * Parameters are the source of truth — generated from API contracts.
  */
-export type LucernGraphMethods = {
+type LucernGraphMethods = {
     createBelief(client: LucernClient, input: CreateBeliefInput): Promise<BeliefResult>;
     refineBelief(client: LucernClient, nodeId: string, input: RefineBeliefInput): Promise<BeliefResult>;
     modulateConfidence(client: LucernClient, nodeId: string, input: ModulateConfidenceInput): Promise<ConfidenceResult>;
@@ -341,16 +346,17 @@ export type LucernGraphMethods = {
     recordJudgment(client: LucernClient, input: RecordJudgmentInput): Promise<JudgmentResult>;
 };
 /**
- * @lucern/sdk-workflows method signatures.
+ * @lucern/sdk (workflows) method signatures.
  *
  * Lifecycle: createBranch (git branch) → addWorktree (git worktree add) →
  *   openPullRequest (git pull request) → merge (git merge) → push (git push)
  */
-export type LucernWorkflowMethods = {
+type LucernWorkflowMethods = {
     createBranch(client: LucernClient, input: CreateBranchInput): Promise<BranchResult>;
     addWorktree(client: LucernClient, input: AddWorktreeInput): Promise<WorktreeResult>;
     merge(client: LucernClient, worktreeId: string, input: MergeInput): Promise<MergeResult>;
     openPullRequest(client: LucernClient, worktreeId: string, input: OpenPullRequestInput): Promise<PullRequestResult>;
     push(client: LucernClient, worktreeId: string, input: PushInput): Promise<PushResult>;
 };
-//# sourceMappingURL=sdk-methods.contract.d.ts.map
+
+export type { AddEvidenceInput, AddWorktreeInput, BeliefResult, BisectConfidenceInput, BisectResult, BranchResult, CompileContextInput, CompiledContextResult, ConfidenceResult, ContradictionResult, CreateBeliefInput, CreateBranchInput, CreateEdgeInput, EdgeResult, EvidenceResult, FlagContradictionInput, ForkBeliefInput, ForkResult, JudgmentResult, LineageResult, LucernClient, LucernClientConfig, LucernGraphMethods, LucernWorkflowMethods, MergeInput, MergeResult, ModulateConfidenceInput, OpenPullRequestInput, PullRequestResult, PushInput, PushResult, QueryLineageInput, RecordJudgmentInput, RefineBeliefInput, SearchBeliefsInput, WorktreeResult };

package/dist/sdk-methods.contract.js

@@ -1,17 +1,3 @@
-/**
- * SDK Method Contract Definitions
- *
- * Canonical method signatures for the Lucern TypeScript SDK.
- * DERIVED from API contracts — not independently authored.
- *
- * These types define the public API of the SDK packages:
- *   @lucern/sdk-core   — client initialization
- *   @lucern/sdk-graph  — belief, evidence, edge, contradiction operations
- *   @lucern/sdk-workflows — branch, worktree, merge, push, pull request lifecycle
- *
- * CONTRACT SURFACE: Method signatures are semver-bound.
- * Adding optional parameters is non-breaking.
- * Changing required parameters or return types is BREAKING.
- */
-export {};
+
+//# sourceMappingURL=sdk-methods.contract.js.map
 //# sourceMappingURL=sdk-methods.contract.js.map

package/dist/sdk-methods.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-methods.contract.js","sourceRoot":"","sources":["../src/sdk-methods.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"sdk-methods.contract.js"}

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

@@ -0,0 +1,150 @@
+import { M as McpToolContract } from './mcp-tools.contract-D8kXcP6d.js';
+
+/**
+ * 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)
+ */
+
+/** SDK-only tool contract — same shape as MCP but with sdk-only tier marker */
+interface SdkToolContract extends Omit<McpToolContract, "tier"> {
+    tier: "sdk-only";
+}
+declare const START_WORKTREE: SdkToolContract;
+declare const UPDATE_WORKTREE_PHASE: SdkToolContract;
+declare const ADVANCE_WORKTREE_PHASE: SdkToolContract;
+declare const ADD_NOTE_TO_WORKTREE: SdkToolContract;
+declare const LINK_DOCUMENT_TO_WORKTREE: SdkToolContract;
+declare const LINK_EVIDENCE_TO_WORKTREE: SdkToolContract;
+declare const LINK_QUESTION_TO_WORKTREE: SdkToolContract;
+declare const LINK_BELIEF_TO_WORKTREE: SdkToolContract;
+declare const CREATE_SYNTHESIZED_BELIEF: SdkToolContract;
+declare const COMPLETE_HYPOTHESIS_FORMATION: SdkToolContract;
+declare const COMPLETE_EVIDENCE_REVIEW: SdkToolContract;
+declare const REFINE_WORKTREE_BELIEF: SdkToolContract;
+declare const TRACE_PROVENANCE: SdkToolContract;
+declare const GET_BELIEF_RELATIONSHIPS: SdkToolContract;
+declare const GET_BELIEF_SUPPORT_CHAIN: SdkToolContract;
+declare const EXPLORE_CONNECTIONS: SdkToolContract;
+declare const GET_DEEP_LINEAGE: SdkToolContract;
+declare const GRAPH_AWARE_SEARCH: SdkToolContract;
+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 LIST_TASKS: SdkToolContract;
+declare const UPDATE_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 GET_PRIVILEGED_EVIDENCE: SdkToolContract;
+declare const GET_PRIVILEGED_SIGNALS: 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;
+/** All SDK-only tool contracts, indexed by name */
+declare const SDK_ONLY_TOOL_CONTRACTS: Record<string, SdkToolContract>;
+/** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
+declare const ALL_SDK_TOOL_CONTRACTS: Record<string, McpToolContract | SdkToolContract>;
+/** All SDK-only tool names */
+declare const SDK_ONLY_TOOL_NAMES: string[];
+/** All tool names across the complete SDK surface */
+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.
+ */
+declare function validateSdkGitSemantics(tool: SdkToolContract): {
+    valid: boolean;
+    reason?: string;
+};
+
+declare const sdkTools_contract_ADD_NOTE_TO_WORKTREE: typeof ADD_NOTE_TO_WORKTREE;
+declare const sdkTools_contract_ADD_RESEARCH_ACTION: typeof ADD_RESEARCH_ACTION;
+declare const sdkTools_contract_ADVANCE_WORKTREE_PHASE: typeof ADVANCE_WORKTREE_PHASE;
+declare const sdkTools_contract_ALL_SDK_TOOL_CONTRACTS: typeof ALL_SDK_TOOL_CONTRACTS;
+declare const sdkTools_contract_ALL_SDK_TOOL_NAMES: typeof ALL_SDK_TOOL_NAMES;
+declare const sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES: typeof ANALYZE_BELIEF_CLUSTER_CANDIDATES;
+declare const sdkTools_contract_ANALYZE_BELIEF_CRITICALITY: typeof ANALYZE_BELIEF_CRITICALITY;
+declare const sdkTools_contract_ANALYZE_REASONING_DEPTH: typeof ANALYZE_REASONING_DEPTH;
+declare const sdkTools_contract_COMPLETE_EVIDENCE_REVIEW: typeof COMPLETE_EVIDENCE_REVIEW;
+declare const sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION: typeof COMPLETE_HYPOTHESIS_FORMATION;
+declare const sdkTools_contract_CREATE_BELIEF_CONDITIONAL: typeof CREATE_BELIEF_CONDITIONAL;
+declare const sdkTools_contract_CREATE_EVIDENCE_TASK: typeof CREATE_EVIDENCE_TASK;
+declare const sdkTools_contract_CREATE_SYNTHESIZED_BELIEF: typeof CREATE_SYNTHESIZED_BELIEF;
+declare const sdkTools_contract_DETECT_ANCHORING_BIAS: typeof DETECT_ANCHORING_BIAS;
+declare const sdkTools_contract_DETECT_SOURCE_CONCENTRATION: typeof DETECT_SOURCE_CONCENTRATION;
+declare const sdkTools_contract_EXPLORE_CONNECTIONS: typeof EXPLORE_CONNECTIONS;
+declare const sdkTools_contract_FIND_SEMANTIC_BRIDGES: typeof FIND_SEMANTIC_BRIDGES;
+declare const sdkTools_contract_FIND_SEMANTIC_ORPHANS: typeof FIND_SEMANTIC_ORPHANS;
+declare const sdkTools_contract_FIND_SOFT_CONTRADICTIONS: typeof FIND_SOFT_CONTRADICTIONS;
+declare const sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS: typeof GET_BELIEFS_BY_EPISTEMIC_STATUS;
+declare const sdkTools_contract_GET_BELIEF_RELATIONSHIPS: typeof GET_BELIEF_RELATIONSHIPS;
+declare const sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN: typeof GET_BELIEF_SUPPORT_CHAIN;
+declare const sdkTools_contract_GET_CAUSAL_CHAINS: typeof GET_CAUSAL_CHAINS;
+declare const sdkTools_contract_GET_CHALLENGED_BELIEFS: typeof GET_CHALLENGED_BELIEFS;
+declare const sdkTools_contract_GET_COLLECTION_CONVICTION: typeof GET_COLLECTION_CONVICTION;
+declare const sdkTools_contract_GET_CONVICTION_TREND: typeof GET_CONVICTION_TREND;
+declare const sdkTools_contract_GET_DEEP_LINEAGE: typeof GET_DEEP_LINEAGE;
+declare const sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY: typeof GET_EVIDENCE_BY_METHODOLOGY;
+declare const sdkTools_contract_GET_NECESSARY_EVIDENCE: typeof GET_NECESSARY_EVIDENCE;
+declare const sdkTools_contract_GET_NON_CONSENSUS_BELIEFS: typeof GET_NON_CONSENSUS_BELIEFS;
+declare const sdkTools_contract_GET_PREDICTIONS: typeof GET_PREDICTIONS;
+declare const sdkTools_contract_GET_PRIVILEGED_EVIDENCE: typeof GET_PRIVILEGED_EVIDENCE;
+declare const sdkTools_contract_GET_PRIVILEGED_SIGNALS: typeof GET_PRIVILEGED_SIGNALS;
+declare const sdkTools_contract_GET_SURPRISE_DETECTION: typeof GET_SURPRISE_DETECTION;
+declare const sdkTools_contract_GET_TASK_COUNTS: typeof GET_TASK_COUNTS;
+declare const sdkTools_contract_GRAPH_AWARE_SEARCH: typeof GRAPH_AWARE_SEARCH;
+declare const sdkTools_contract_LINK_BELIEF_TO_WORKTREE: typeof LINK_BELIEF_TO_WORKTREE;
+declare const sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE: typeof LINK_DOCUMENT_TO_WORKTREE;
+declare const sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE: typeof LINK_EVIDENCE_TO_WORKTREE;
+declare const sdkTools_contract_LINK_QUESTION_TO_WORKTREE: typeof LINK_QUESTION_TO_WORKTREE;
+declare const sdkTools_contract_LIST_TASKS: typeof LIST_TASKS;
+declare const sdkTools_contract_REFINE_WORKTREE_BELIEF: typeof REFINE_WORKTREE_BELIEF;
+declare const sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS: typeof SDK_ONLY_TOOL_CONTRACTS;
+declare const sdkTools_contract_SDK_ONLY_TOOL_NAMES: typeof SDK_ONLY_TOOL_NAMES;
+declare const sdkTools_contract_START_WORKTREE: typeof START_WORKTREE;
+type sdkTools_contract_SdkToolContract = SdkToolContract;
+declare const sdkTools_contract_TRACE_PROVENANCE: typeof TRACE_PROVENANCE;
+declare const sdkTools_contract_UPDATE_TASK: typeof UPDATE_TASK;
+declare const sdkTools_contract_UPDATE_WORKTREE_PHASE: typeof UPDATE_WORKTREE_PHASE;
+declare const sdkTools_contract_validateSdkGitSemantics: typeof validateSdkGitSemantics;
+declare namespace sdkTools_contract {
+  export { sdkTools_contract_ADD_NOTE_TO_WORKTREE as ADD_NOTE_TO_WORKTREE, sdkTools_contract_ADD_RESEARCH_ACTION as ADD_RESEARCH_ACTION, sdkTools_contract_ADVANCE_WORKTREE_PHASE as ADVANCE_WORKTREE_PHASE, sdkTools_contract_ALL_SDK_TOOL_CONTRACTS as ALL_SDK_TOOL_CONTRACTS, sdkTools_contract_ALL_SDK_TOOL_NAMES as ALL_SDK_TOOL_NAMES, sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES as ANALYZE_BELIEF_CLUSTER_CANDIDATES, sdkTools_contract_ANALYZE_BELIEF_CRITICALITY as ANALYZE_BELIEF_CRITICALITY, sdkTools_contract_ANALYZE_REASONING_DEPTH as ANALYZE_REASONING_DEPTH, sdkTools_contract_COMPLETE_EVIDENCE_REVIEW as COMPLETE_EVIDENCE_REVIEW, sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION as COMPLETE_HYPOTHESIS_FORMATION, sdkTools_contract_CREATE_BELIEF_CONDITIONAL as CREATE_BELIEF_CONDITIONAL, sdkTools_contract_CREATE_EVIDENCE_TASK as CREATE_EVIDENCE_TASK, sdkTools_contract_CREATE_SYNTHESIZED_BELIEF as CREATE_SYNTHESIZED_BELIEF, sdkTools_contract_DETECT_ANCHORING_BIAS as DETECT_ANCHORING_BIAS, sdkTools_contract_DETECT_SOURCE_CONCENTRATION as DETECT_SOURCE_CONCENTRATION, sdkTools_contract_EXPLORE_CONNECTIONS as EXPLORE_CONNECTIONS, sdkTools_contract_FIND_SEMANTIC_BRIDGES as FIND_SEMANTIC_BRIDGES, sdkTools_contract_FIND_SEMANTIC_ORPHANS as FIND_SEMANTIC_ORPHANS, sdkTools_contract_FIND_SOFT_CONTRADICTIONS as FIND_SOFT_CONTRADICTIONS, sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS as GET_BELIEFS_BY_EPISTEMIC_STATUS, sdkTools_contract_GET_BELIEF_RELATIONSHIPS as GET_BELIEF_RELATIONSHIPS, sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN as GET_BELIEF_SUPPORT_CHAIN, sdkTools_contract_GET_CAUSAL_CHAINS as GET_CAUSAL_CHAINS, sdkTools_contract_GET_CHALLENGED_BELIEFS as GET_CHALLENGED_BELIEFS, sdkTools_contract_GET_COLLECTION_CONVICTION as GET_COLLECTION_CONVICTION, sdkTools_contract_GET_CONVICTION_TREND as GET_CONVICTION_TREND, sdkTools_contract_GET_DEEP_LINEAGE as GET_DEEP_LINEAGE, sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY as GET_EVIDENCE_BY_METHODOLOGY, sdkTools_contract_GET_NECESSARY_EVIDENCE as GET_NECESSARY_EVIDENCE, sdkTools_contract_GET_NON_CONSENSUS_BELIEFS as GET_NON_CONSENSUS_BELIEFS, sdkTools_contract_GET_PREDICTIONS as GET_PREDICTIONS, sdkTools_contract_GET_PRIVILEGED_EVIDENCE as GET_PRIVILEGED_EVIDENCE, sdkTools_contract_GET_PRIVILEGED_SIGNALS as GET_PRIVILEGED_SIGNALS, sdkTools_contract_GET_SURPRISE_DETECTION as GET_SURPRISE_DETECTION, sdkTools_contract_GET_TASK_COUNTS as GET_TASK_COUNTS, sdkTools_contract_GRAPH_AWARE_SEARCH as GRAPH_AWARE_SEARCH, sdkTools_contract_LINK_BELIEF_TO_WORKTREE as LINK_BELIEF_TO_WORKTREE, sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE as LINK_DOCUMENT_TO_WORKTREE, sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE as LINK_EVIDENCE_TO_WORKTREE, sdkTools_contract_LINK_QUESTION_TO_WORKTREE as LINK_QUESTION_TO_WORKTREE, sdkTools_contract_LIST_TASKS as LIST_TASKS, sdkTools_contract_REFINE_WORKTREE_BELIEF as REFINE_WORKTREE_BELIEF, sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS as SDK_ONLY_TOOL_CONTRACTS, sdkTools_contract_SDK_ONLY_TOOL_NAMES as SDK_ONLY_TOOL_NAMES, sdkTools_contract_START_WORKTREE as START_WORKTREE, type sdkTools_contract_SdkToolContract as SdkToolContract, sdkTools_contract_TRACE_PROVENANCE as TRACE_PROVENANCE, sdkTools_contract_UPDATE_TASK as UPDATE_TASK, sdkTools_contract_UPDATE_WORKTREE_PHASE as UPDATE_WORKTREE_PHASE, sdkTools_contract_validateSdkGitSemantics as validateSdkGitSemantics };
+}
+
+export { ADVANCE_WORKTREE_PHASE as A, GET_CHALLENGED_BELIEFS as B, CREATE_SYNTHESIZED_BELIEF as C, GET_CAUSAL_CHAINS as D, EXPLORE_CONNECTIONS as E, GET_NON_CONSENSUS_BELIEFS as F, GET_BELIEF_RELATIONSHIPS as G, GET_BELIEFS_BY_EPISTEMIC_STATUS as H, GET_PRIVILEGED_EVIDENCE as I, GET_PRIVILEGED_SIGNALS as J, DETECT_ANCHORING_BIAS as K, LINK_DOCUMENT_TO_WORKTREE as L, DETECT_SOURCE_CONCENTRATION as M, FIND_SOFT_CONTRADICTIONS as N, FIND_SEMANTIC_BRIDGES as O, FIND_SEMANTIC_ORPHANS as P, SDK_ONLY_TOOL_CONTRACTS as Q, REFINE_WORKTREE_BELIEF as R, type SdkToolContract as S, TRACE_PROVENANCE as T, UPDATE_WORKTREE_PHASE as U, ALL_SDK_TOOL_CONTRACTS as V, SDK_ONLY_TOOL_NAMES as W, ALL_SDK_TOOL_NAMES as X, validateSdkGitSemantics as Y, START_WORKTREE as a, ADD_NOTE_TO_WORKTREE as b, LINK_EVIDENCE_TO_WORKTREE as c, LINK_QUESTION_TO_WORKTREE as d, LINK_BELIEF_TO_WORKTREE as e, COMPLETE_HYPOTHESIS_FORMATION as f, COMPLETE_EVIDENCE_REVIEW as g, GET_BELIEF_SUPPORT_CHAIN as h, GET_DEEP_LINEAGE as i, GRAPH_AWARE_SEARCH as j, GET_COLLECTION_CONVICTION as k, GET_CONVICTION_TREND as l, ANALYZE_BELIEF_CRITICALITY as m, ANALYZE_BELIEF_CLUSTER_CANDIDATES as n, CREATE_BELIEF_CONDITIONAL as o, GET_NECESSARY_EVIDENCE as p, ANALYZE_REASONING_DEPTH as q, GET_EVIDENCE_BY_METHODOLOGY as r, sdkTools_contract as s, CREATE_EVIDENCE_TASK as t, LIST_TASKS as u, UPDATE_TASK as v, GET_TASK_COUNTS as w, ADD_RESEARCH_ACTION as x, GET_PREDICTIONS as y, GET_SURPRISE_DETECTION as z };

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

@@ -1,93 +1,2 @@
-/**
- * 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
+import './mcp-tools.contract-D8kXcP6d.js';
+export { b as ADD_NOTE_TO_WORKTREE, x as ADD_RESEARCH_ACTION, A as ADVANCE_WORKTREE_PHASE, V as ALL_SDK_TOOL_CONTRACTS, X as ALL_SDK_TOOL_NAMES, n as ANALYZE_BELIEF_CLUSTER_CANDIDATES, m as ANALYZE_BELIEF_CRITICALITY, q as ANALYZE_REASONING_DEPTH, g as COMPLETE_EVIDENCE_REVIEW, f as COMPLETE_HYPOTHESIS_FORMATION, o as CREATE_BELIEF_CONDITIONAL, t as CREATE_EVIDENCE_TASK, C as CREATE_SYNTHESIZED_BELIEF, K as DETECT_ANCHORING_BIAS, M as DETECT_SOURCE_CONCENTRATION, E as EXPLORE_CONNECTIONS, O as FIND_SEMANTIC_BRIDGES, P as FIND_SEMANTIC_ORPHANS, N as FIND_SOFT_CONTRADICTIONS, H as GET_BELIEFS_BY_EPISTEMIC_STATUS, G as GET_BELIEF_RELATIONSHIPS, h as GET_BELIEF_SUPPORT_CHAIN, D as GET_CAUSAL_CHAINS, B as GET_CHALLENGED_BELIEFS, k as GET_COLLECTION_CONVICTION, l as GET_CONVICTION_TREND, i as GET_DEEP_LINEAGE, r as GET_EVIDENCE_BY_METHODOLOGY, p as GET_NECESSARY_EVIDENCE, F as GET_NON_CONSENSUS_BELIEFS, y as GET_PREDICTIONS, I as GET_PRIVILEGED_EVIDENCE, J as GET_PRIVILEGED_SIGNALS, z as GET_SURPRISE_DETECTION, w as GET_TASK_COUNTS, j as GRAPH_AWARE_SEARCH, e as LINK_BELIEF_TO_WORKTREE, L as LINK_DOCUMENT_TO_WORKTREE, c as LINK_EVIDENCE_TO_WORKTREE, d as LINK_QUESTION_TO_WORKTREE, u as LIST_TASKS, R as REFINE_WORKTREE_BELIEF, Q as SDK_ONLY_TOOL_CONTRACTS, W as SDK_ONLY_TOOL_NAMES, a as START_WORKTREE, S as SdkToolContract, T as TRACE_PROVENANCE, v as UPDATE_TASK, U as UPDATE_WORKTREE_PHASE, Y as validateSdkGitSemantics } from './sdk-tools.contract-BnV0hKLp.js';