@lucern/sdk 1.0.15 → 1.0.17

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 ## [Unreleased]
 - No unreleased changes yet.
 
+## [1.0.17] - 2026-06-01
+- Release notes pending.
+
+## [1.0.16] - 2026-06-01
+- Release notes pending.
+
 ## [1.0.15] - 2026-06-01
 - Release notes pending.
 
@@ -15,7 +21,7 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 - Exposes the Campaign 1 closeout headless surface: MCP output-schema
   metadata, richer retrieval receipts, synthesis narrative coverage, and
   evidence relation fields for supporting or contradicting belief links.
-- Deprecates direct public confidence modulation in favor of evidence-backed
+- Deprecates direct public SL scoring in favor of evidence-backed
   Subjective Logic accumulation.
 
 ## [1.0.12] - 2026-05-31

package/README.md

@@ -194,49 +194,51 @@ const performanceTopic = await lucern.topics.create({
   type: "theme",
   parentTopicId: codeQuality.data.topicId,
 });
+
+const topicGlobalId =
+  securityTopic.data.topicGlobalId ?? securityTopic.data.globalId;
+const topicId = topicGlobalId; // Compatibility projection for read/query APIs.
 ```
 
 ### 2. Populate the Graph With What You Know
 
-Beliefs represent understanding at different epistemic levels: facts (verified), beliefs (confident), hypotheses (testing), and assumptions (untested).
+Beliefs move through deterministic lifecycle states: `assumption` when raw, `hypothesis` when testable, `active` once evidence attaches, then `superseded`, `resolved_true`, or `resolved_false` as evidence and time settle the claim.
 
 ```typescript
-const topicId = securityTopic.data.topicId;
-
 // A fact — verified and anchored
 const sqlFact = await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "Parameterized queries prevent SQL injection in all major database drivers",
   beliefType: "fact",
 });
 const sqlFactEvidence = await lucern.evidence.create({
-  topicId,
+  topicId: topicGlobalId,
   text: "OWASP SQL Injection Prevention guidance identifies parameterized queries as the primary defense.",
   sourceUrl: "https://owasp.org/www-community/attacks/SQL_Injection",
   targetId: sqlFact.data.nodeId,
   evidenceRelation: "supports",
-  confidence: 0.95,
+  weight: 0.95,
   rationale: "OWASP verified, industry standard for 20+ years",
 });
 
 // A belief — confident from observation
 const patternBelief = await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "Most security vulnerabilities in our codebase come from unvalidated user input at API boundaries, not from cryptographic weaknesses",
 });
 const patternEvidence = await lucern.evidence.create({
-  topicId,
+  topicId: topicGlobalId,
   text: "Last 6 months of security audits found 14 input validation issues and 1 cryptographic issue.",
   sourceUrl: "audit://security/findings-last-6-months",
   targetId: patternBelief.data.nodeId,
   evidenceRelation: "supports",
-  confidence: 0.82,
+  weight: 0.82,
   rationale: "Last 6 months of security audits: 14 input validation issues, 1 crypto issue",
 });
 
 // A hypothesis — under active testing
 const hypothesis = await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "Automated static analysis catches fewer than 30% of the input validation vulnerabilities that human reviewers find",
   beliefType: "hypothesis",
 });
@@ -245,7 +247,7 @@ const hypothesis = await lucern.beliefs.create({
 
 // An assumption — untested but used as a basis for decisions
 const assumption = await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "Our CI pipeline runs all static analysis rules on every PR",
   beliefType: "assumption",
 });
@@ -365,7 +367,6 @@ await lucern.evidence.linkToBelief({
   beliefId: hypothesis.data.nodeId,
   weight: -0.8,
   evidenceRelation: "contradicts",
-  confidence: 0.8,
   rationale: "Static analysis catches 53% overall, not <30%. But the category breakdown reveals something more important.",
 });
 
@@ -380,13 +381,12 @@ await lucern.evidence.linkToBelief({
   beliefId: evolved.data.nodeId,
   weight: 0.88,
   evidenceRelation: "supports",
-  confidence: 0.88,
   rationale: "Direct comparison data: 0/7 business logic flaws caught, 0/2 race conditions caught, while input validation catch rate was 12/22 (55%)",
 });
 
 // This creates a new actionable belief
 const actionable = await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "Human code review should focus on business logic and concurrency — the categories where static analysis provides zero coverage",
   beliefType: "belief",
 });
@@ -397,7 +397,7 @@ await lucern.evidence.create({
   sourceUrl: `worktree://${investigation.data.worktreeId}`,
   targetId: actionable.data.nodeId,
   evidenceRelation: "supports",
-  confidence: 0.85,
+  weight: 0.85,
   rationale: "Direct implication of the comparison study findings",
 });
 
@@ -741,7 +741,7 @@ Record what you learned:
 \`\`\`typescript
 // Create a belief for decisions made
 await lucern.beliefs.create({
-  topicId,
+  topicGlobalId,
   canonicalText: "<what you now believe to be true>",
 });
 
@@ -825,18 +825,8 @@ When the investigation is complete, merge findings into the main graph:
 ```typescript
 await lucern.worktrees.merge(worktreeId, {
   summary: "Static analysis catches 53% of vulns overall but has zero coverage for business logic flaws",
-  outcomes: [
-    {
-      beliefId: hypothesis.data.nodeId,
-      confidence: 0.2,
-      rationale: "Overall catch rate was 53%, not <30% — but the category breakdown is more important",
-    },
-    {
-      beliefId: evolved.data.nodeId,
-      confidence: 0.88,
-      rationale: "Direct comparison data confirms the coverage gap hypothesis at category level",
-    },
-  ],
+  rationale:
+    "Contradicting evidence is attached to the old belief and supporting evidence is attached to the forked belief before merge.",
 });
 ```
 

package/dist/beliefs/index.d.ts

@@ -21,8 +21,6 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
         rationale?: string;
     }, rationale?: string) => any;
     forkBelief: (nodeId: string, input: import("../clientConfig").BeliefsCompatForkInput) => any;
-    /** @deprecated Attach supporting or contradicting evidence instead. */
-    modulateBeliefConfidence(): never;
     archiveBelief: (nodeId: string, input?: string | {
         reason?: string;
         rationale?: string;
@@ -36,9 +34,6 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
             text: string;
             rationale?: string;
         }, rationale?: string): any;
-        updateConfidence(nodeId: string, input: import("../clientConfig").BeliefsCompatUpdateConfidenceInput): any;
-        modulateConfidence(nodeId: string, input: import("../clientConfig").BeliefsCompatUpdateConfidenceInput): any;
-        updateStatus(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         updateRationale(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         linkBeliefs(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         unlinkEvidence(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;

package/dist/beliefs/index.js

@@ -11,10 +11,6 @@ export function createBeliefsClient(config = {}) {
         searchBeliefs: beliefs.search,
         refineBelief: beliefs.refine,
         forkBelief: beliefs.fork,
-        /** @deprecated Attach supporting or contradicting evidence instead. */
-        modulateBeliefConfidence() {
-            throw new Error("Belief confidence is SL-derived. Use lucern.evidence.create(...) or lucern.evidence.linkToBelief(...) with evidenceRelation instead.");
-        },
         archiveBelief: beliefs.archive,
         getBeliefLineage: beliefs.lineage,
         getBeliefConfidenceHistory: beliefs.confidenceHistory,

package/dist/beliefsClient.d.ts

@@ -1,9 +1,8 @@
 import { type GatewayClientConfig, LucernApiError, type PlatformGatewaySuccess } from "./coreClient";
-import { type Opinion } from "./opinion";
-import type { ForkBeliefResponse, JsonObject, ModulateConfidenceResponse } from "./types";
+import type { ForkBeliefResponse, JsonObject } from "./types";
 export { LucernApiError };
 export type { PlatformGatewaySuccess } from "./coreClient";
-export type { CreateBeliefResponse, ForkBeliefResponse, ModulateConfidenceResponse, } from "./types";
+export type { CreateBeliefResponse, ForkBeliefResponse, } from "./types";
 export type { Opinion } from "./opinion";
 /** Configuration for the beliefs client. Inherits gateway transport settings. */
 export type BeliefsClientConfig = GatewayClientConfig;
@@ -34,6 +33,11 @@ export declare function mapOpinionHistoryEntriesFromGatewayData(payload: Gateway
  * `baseRate` defaults to the canonical neutral prior `0.5`.
  */
 export type CreateBeliefInput = {
+    /** Required topic epistemicNodes globalId. */
+    topicGlobalId?: string;
+    /** Optional internal epistemicNodes _id for the topic anchor. */
+    topicNodeId?: string;
+    /** @deprecated Use topicGlobalId. Must identify a topic epistemicNode, not a legacy topics-table row. */
     topicId?: string;
     /** Preferred belief statement alias. */
     text?: string;
@@ -67,43 +71,17 @@ export type RefineBeliefInput = {
     rationale?: string;
     title?: string;
 };
-type BeliefConfidenceTrigger = "evidence_added" | "evidence_removed" | "contradiction_detected" | "contradiction_resolved" | "agent_assessment" | "worktree_outcome" | "worktree_completed" | "fusion" | "discount" | "deduction";
-type ModulateConfidenceInputBase = {
-    trigger: BeliefConfidenceTrigger;
-    rationale: string;
-    triggeringEvidenceId?: string;
-    triggeringQuestionId?: string;
-    triggeringAnswerId?: string;
-    triggeringContradictionId?: string;
-    triggeringWorktreeId?: string;
-    maxInlinePropagationTargets?: number;
-};
-/**
- * @deprecated Public callers should not submit confidence tuples directly.
- * Attach supporting or contradicting evidence and let the kernel derive the
- * next subjective-logic opinion.
- */
-export type ModulateConfidenceOpinionInput = ModulateConfidenceInputBase & {
-    opinion: Opinion;
-};
-export type ModulateConfidenceInput = ModulateConfidenceOpinionInput;
 /**
- * Input for forking a scored belief into a new formulation.
- * Scored beliefs are immutable — fork to evolve understanding.
+ * Input for forking an evidence-bearing belief into a new formulation.
+ * Every fork must cite evidence already attached to the parent through SL.
  */
 export type ForkBeliefInput = {
     newFormulation: string;
-    forkReason?: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse" | "manual";
+    forkReason: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse";
+    forkMode?: "supersede" | "branch";
+    triggeringEvidenceId: string;
     rationale?: string;
 };
-/** Input for changing a belief's lifecycle status. */
-export type UpdateBeliefStatusInput = {
-    id?: string;
-    nodeId?: string;
-    beliefId?: string;
-    status: "active" | "superseded" | "archived";
-    reason?: string;
-};
 /** Input for updating a belief's rationale without refining its text. */
 export type UpdateBeliefRationaleInput = {
     id?: string;
@@ -168,10 +146,6 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
      * Refine a draft belief in place.
      */
     refineBelief(beliefId: string, input: RefineBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<import("./types").PlatformBeliefRecord>>;
-    /**
-     * Record a confidence change for an existing belief.
-     */
-    modulateConfidence: (beliefId: string, input: ModulateConfidenceOpinionInput, idempotencyKey?: string) => Promise<PlatformGatewaySuccess<ModulateConfidenceResponse>>;
     /**
      * Returns the belief's confidence trajectory as a chronological array.
      *
@@ -192,10 +166,6 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
      * Fork a scored belief into a new formulation.
      */
     forkBelief(beliefId: string, input: ForkBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<ForkBeliefResponse>>;
-    /**
-     * Update a belief's lifecycle status.
-     */
-    updateBeliefStatus(input: UpdateBeliefStatusInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
     /**
      * Update a belief's rationale without changing its text.
      */

package/dist/beliefsClient.js

@@ -101,13 +101,6 @@ export function createBeliefsClient(config = {}) {
         }
         return normalized;
     }
-    /** @deprecated Use evidence.create or evidence.linkToBelief with evidenceRelation. */
-    const modulateConfidence = async (beliefId, input, idempotencyKey) => {
-        void beliefId;
-        void input;
-        void idempotencyKey;
-        throw new Error("Belief confidence is SL-derived. Use lucern.evidence.create({ targetId, evidenceRelation: 'supports'|'contradicts', confidence, rationale }) or lucern.evidence.linkToBelief(...) instead.");
-    };
     const getOpinionHistory = async (beliefId) => {
         const response = await gateway.request({
             path: `/api/platform/v1/beliefs/${encodeURIComponent(beliefId)}/confidence-history`,
@@ -141,10 +134,6 @@ export function createBeliefsClient(config = {}) {
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
             });
         },
-        /**
-         * Record a confidence change for an existing belief.
-         */
-        modulateConfidence,
         /**
          * Returns the belief's confidence trajectory as a chronological array.
          *
@@ -172,17 +161,6 @@ export function createBeliefsClient(config = {}) {
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
             });
         },
-        /**
-         * Update a belief's lifecycle status.
-         */
-        async updateBeliefStatus(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/beliefs/update-status",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
         /**
          * Update a belief's rationale without changing its text.
          */

package/dist/client.d.ts

@@ -437,9 +437,6 @@ export declare function createLucernClient(config?: LucernClientConfig): {
             text: string;
             rationale?: string;
         }, rationale?: string): any;
-        updateConfidence(nodeId: string, input: import("./clientConfig").BeliefsCompatUpdateConfidenceInput): any;
-        modulateConfidence(nodeId: string, input: import("./clientConfig").BeliefsCompatUpdateConfidenceInput): any;
-        updateStatus(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         updateRationale(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         linkBeliefs(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         unlinkEvidence(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;

package/dist/clientConfig.d.ts

@@ -2,7 +2,7 @@ import type { AdminClientConfig } from "./adminClient";
 import type { AnswersClientConfig } from "./answersClient";
 import type { AudiencesClientConfig } from "./audiencesClient";
 import type { AuditClientConfig } from "./auditClient";
-import type { BeliefsClientConfig, ModulateConfidenceInput } from "./beliefsClient";
+import type { BeliefsClientConfig } from "./beliefsClient";
 import type { ContextClientConfig } from "./contextClient";
 import type { ControlPlaneIdentityClientConfig } from "./control-plane";
 import type { DecisionsClientConfig } from "./decisionsClient";
@@ -58,10 +58,11 @@ export type BeliefsCompatForkInput = {
     text?: string;
     newFormulation?: string;
     formulation?: string;
-    forkReason?: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse" | "manual";
+    forkReason: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse";
+    forkMode?: "supersede" | "branch";
+    triggeringEvidenceId: string;
     rationale?: string;
 };
-export type BeliefsCompatUpdateConfidenceInput = ModulateConfidenceInput;
 /**
  * Configuration for the high-level Lucern SDK client.
  *

package/dist/clientKnowledgeNamespaces.d.ts

@@ -1,5 +1,5 @@
 import type { ClientNamespaceContext } from "./clientAssemblyTypes";
-import type { BeliefsCompatCreateInput, BeliefsCompatForkInput, BeliefsCompatUpdateConfidenceInput } from "./clientConfig";
+import type { BeliefsCompatCreateInput, BeliefsCompatForkInput } from "./clientConfig";
 import type { FunctionSurfaceInput } from "./generated/functionSurface";
 import type { JsonObject } from "./types";
 export declare function createClientKnowledgeNamespaces(ctx: ClientNamespaceContext): {
@@ -20,9 +20,6 @@ export declare function createClientKnowledgeNamespaces(ctx: ClientNamespaceCont
             text: string;
             rationale?: string;
         }, rationale?: string): any;
-        updateConfidence(nodeId: string, input: BeliefsCompatUpdateConfidenceInput): any;
-        modulateConfidence(nodeId: string, input: BeliefsCompatUpdateConfidenceInput): any;
-        updateStatus(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         updateRationale(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         linkBeliefs(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
         unlinkEvidence(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;

package/dist/clientKnowledgeNamespaces.js

@@ -41,17 +41,6 @@ export function createClientKnowledgeNamespaces(ctx) {
                 const payload = buildBeliefsRefinePayload(textOrInput, rationale);
                 return beliefsFacade.refine(nodeId, payload).then(exposeGatewayData);
             },
-            updateConfidence(nodeId, input) {
-                return beliefsFacade.updateConfidence(nodeId, input).then(exposeGatewayData);
-            },
-            modulateConfidence(nodeId, input) {
-                return beliefsFacade.updateConfidence(nodeId, input).then(exposeGatewayData);
-            },
-            updateStatus(input, idempotencyKey) {
-                return beliefsFacade
-                    .updateStatus(input, idempotencyKey)
-                    .then(exposeGatewayData);
-            },
             updateRationale(input, idempotencyKey) {
                 return beliefsFacade
                     .updateRationale(input, idempotencyKey)
@@ -87,6 +76,8 @@ export function createClientKnowledgeNamespaces(ctx) {
                     .fork(nodeId, {
                     text: requireText(input),
                     forkReason: input.forkReason,
+                    forkMode: input.forkMode,
+                    triggeringEvidenceId: input.triggeringEvidenceId,
                     rationale: input.rationale,
                 })
                     .then(exposeGatewayData);

package/dist/contextTypes.d.ts

@@ -29,6 +29,13 @@ export type CompileContextInput = {
     packWeightOverrides?: PackWeightOverride[];
     tokenBudget?: number;
     rankingProfile?: ContextRankingProfile;
+    /**
+     * Dimension-seeded compiles synthesize every scoped worktree but bound raw
+     * belief/question/evidence enrichment to a ranked carrier-topic sample.
+     * Raise this, up to the hosted maximum, when callers need denser raw
+     * enrichment in the returned pack.
+     */
+    contentTopicLimit?: number;
 };
 export type PublicContextBelief = {
     beliefId: string;
@@ -89,7 +96,28 @@ export type PublicContextInjectionPolicy = {
         score: number;
     }>;
 };
+export type PublicContextNarrativeBlock = {
+    kind: string;
+    text: string;
+    recordsNamed?: number;
+};
+export type PublicContextSupportingObjects = {
+    invariants?: PublicContextBelief[];
+    activeBeliefs?: PublicContextBelief[];
+    openQuestions?: PublicContextQuestion[];
+    recentEvidence?: PublicContextEvidence[];
+    contradictions?: PublicContextContradiction[];
+    relatedEntities?: PublicContextEntity[];
+    worktrees?: unknown[];
+    lanes?: string[];
+    entities?: unknown[];
+};
 export type PublicCompiledContext = {
+    contextNarrative: Array<string | PublicContextNarrativeBlock>;
+    narrativeCoverage?: Record<string, unknown>;
+    synthesisLints?: Array<Record<string, unknown>>;
+    retrievalReceipt?: Record<string, unknown>;
+    supportingObjects?: PublicContextSupportingObjects;
     schemaVersion: string;
     topicId: string;
     topicName: string;
@@ -97,13 +125,12 @@ export type PublicCompiledContext = {
     generatedAt: number;
     ranking: ContextRankingProfile;
     summary: Record<string, unknown>;
-    invariants: PublicContextBelief[];
-    activeBeliefs: PublicContextBelief[];
-    openQuestions: PublicContextQuestion[];
-    recentEvidence: PublicContextEvidence[];
-    contradictions: PublicContextContradiction[];
+    invariants?: PublicContextBelief[];
+    activeBeliefs?: PublicContextBelief[];
+    openQuestions?: PublicContextQuestion[];
+    recentEvidence?: PublicContextEvidence[];
+    contradictions?: PublicContextContradiction[];
     relatedEntities?: PublicContextEntity[];
-    contextNarrative: string[];
     injectionPolicy: PublicContextInjectionPolicy;
     diagnostics: Record<string, unknown>;
     compilationMode?: string;

package/dist/contracts/context-pack.contract.d.ts

@@ -349,7 +349,28 @@ export type PublicContextInjectionPolicy = {
         score: number;
     }>;
 };
+export type PublicContextNarrativeBlock = {
+    kind: string;
+    text: string;
+    recordsNamed?: number;
+};
+export type PublicContextSupportingObjects = {
+    invariants?: PublicContextBelief[];
+    activeBeliefs?: PublicContextBelief[];
+    openQuestions?: PublicContextQuestion[];
+    recentEvidence?: PublicContextEvidence[];
+    contradictions?: PublicContextContradiction[];
+    relatedEntities?: PublicContextEntity[];
+    worktrees?: unknown[];
+    lanes?: string[];
+    entities?: unknown[];
+};
 export type PublicCompiledContext = {
+    contextNarrative: Array<string | PublicContextNarrativeBlock>;
+    narrativeCoverage?: Record<string, unknown>;
+    synthesisLints?: Array<Record<string, unknown>>;
+    retrievalReceipt?: Record<string, unknown>;
+    supportingObjects?: PublicContextSupportingObjects;
     schemaVersion: string;
     topicId: string;
     topicName: string;
@@ -357,13 +378,12 @@ export type PublicCompiledContext = {
     generatedAt: number;
     ranking: ContextRankingProfile;
     summary: Record<string, unknown>;
-    invariants: PublicContextBelief[];
-    activeBeliefs: PublicContextBelief[];
-    openQuestions: PublicContextQuestion[];
-    recentEvidence: PublicContextEvidence[];
-    contradictions: PublicContextContradiction[];
+    invariants?: PublicContextBelief[];
+    activeBeliefs?: PublicContextBelief[];
+    openQuestions?: PublicContextQuestion[];
+    recentEvidence?: PublicContextEvidence[];
+    contradictions?: PublicContextContradiction[];
     relatedEntities?: PublicContextEntity[];
-    contextNarrative: string[];
     injectionPolicy: PublicContextInjectionPolicy;
     diagnostics: Record<string, unknown>;
     compilationMode?: string;
@@ -475,6 +495,12 @@ export type ContextPackRequestV1 = {
     sessionId?: string;
     /** Pack weight overrides from domain pack binding (RS-2). */
     packWeightOverrides?: PackWeightOverride[];
+    /**
+     * Maximum carrier topics to enrich with raw belief/question/evidence rows for
+     * explicit dimension-seeded compiles. The full dimension is still synthesized
+     * through worktrees and receipts; this only bounds raw content fan-out.
+     */
+    contentTopicLimit?: number;
 };
 /**
  * Question statuses that are considered "resolved" (not open).

package/dist/gatewayFacades.d.ts

@@ -1,5 +1,4 @@
 import { type GatewayClientConfig, type PlatformGatewaySuccess } from "./coreClient";
-import type { ModulateConfidenceInput } from "./beliefsClient";
 import { type TopicCoverageQuery, type TopicTreeQuery, type TopicUpdateInput } from "./topicsClient";
 import type { GraphAnalyticsMetric, JsonObject } from "./types";
 export type GatewayRecord = Record<string, unknown>;
@@ -108,10 +107,11 @@ export type BeliefRefineInput = {
 };
 export type BeliefForkInput = {
     text: string;
-    forkReason?: string;
+    forkReason: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse";
+    forkMode?: "supersede" | "branch";
+    triggeringEvidenceId: string;
     rationale?: string;
 };
-export type BeliefConfidenceInput = ModulateConfidenceInput;
 export type BeliefArchiveInput = {
     reason?: string;
     rationale?: string;

package/dist/gatewayFacades.factories.d.ts

@@ -1,20 +1,12 @@
 import { type GatewayClientConfig, type PlatformGatewaySuccess } from "./coreClient";
 import { type OntologyBindingInput } from "./ontologyClient";
-import type { BeliefArchiveInput, BeliefBisectInput, BeliefConfidenceInput, BeliefContractInput, BeliefCreateInput, BeliefForkInput, BeliefRecord, BeliefsLineageResult, BeliefsListQuery, BeliefsListResult, BeliefRefineInput, ContradictionsListResult, EdgeCreateInput, EdgeListQuery, EdgeTraverseInput, EvidenceCreateInput, EvidenceCreateResult, EvidenceListQuery, EvidenceLinkInput, EvidenceLinkResult, EvidenceSearchInput, EventsListQuery, EventsListResult, GatewayList, GatewayRecord, GraphFalsifyInput, GraphNeighborhoodInput, OntologyMatchInput, QuestionAnswerInput, QuestionArchiveInput, QuestionCreateInput, QuestionRefineInput, QuestionStatusInput, QuestionsListQuery, QuestionsListResult, ReplayEventsInput } from "./gatewayFacades";
+import type { BeliefArchiveInput, BeliefBisectInput, BeliefContractInput, BeliefCreateInput, BeliefForkInput, BeliefRecord, BeliefsLineageResult, BeliefsListQuery, BeliefsListResult, BeliefRefineInput, ContradictionsListResult, EdgeCreateInput, EdgeListQuery, EdgeTraverseInput, EvidenceCreateInput, EvidenceCreateResult, EvidenceListQuery, EvidenceLinkInput, EvidenceLinkResult, EvidenceSearchInput, EventsListQuery, EventsListResult, GatewayList, GatewayRecord, GraphFalsifyInput, GraphNeighborhoodInput, OntologyMatchInput, QuestionAnswerInput, QuestionArchiveInput, QuestionCreateInput, QuestionRefineInput, QuestionStatusInput, QuestionsListQuery, QuestionsListResult, ReplayEventsInput } from "./gatewayFacades";
 export declare function createBeliefsFacade(config?: GatewayClientConfig): {
     create(input: BeliefCreateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<BeliefRecord>>;
     get(id: string): Promise<PlatformGatewaySuccess<BeliefRecord>>;
     list(query: BeliefsListQuery): Promise<PlatformGatewaySuccess<BeliefsListResult>>;
     refine(id: string, input: BeliefRefineInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<BeliefRecord>>;
     fork(id: string, input: BeliefForkInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<BeliefRecord>>;
-    updateConfidence(id: string, input: BeliefConfidenceInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
-    updateStatus(input: {
-        id?: string;
-        nodeId?: string;
-        beliefId?: string;
-        status: "active" | "superseded" | "archived";
-        reason?: string;
-    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GatewayRecord>>;
     updateRationale(input: {
         id?: string;
         nodeId?: string;

package/dist/gatewayFacades.factories.js

@@ -49,20 +49,6 @@ export function createBeliefsFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async updateConfidence(id, input, idempotencyKey = randomIdempotencyKey()) {
-            void id;
-            void input;
-            void idempotencyKey;
-            throw new Error("Belief confidence is SL-derived. Use lucern.evidence.create({ targetId, evidenceRelation: 'supports'|'contradicts', confidence, rationale }) or lucern.evidence.linkToBelief(...) instead.");
-        },
-        async updateStatus(input, idempotencyKey = randomIdempotencyKey()) {
-            return gateway.request({
-                path: "/api/platform/v1/beliefs/update-status",
-                method: "POST",
-                body: input,
-                idempotencyKey,
-            });
-        },
         async updateRationale(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/beliefs/update-rationale",

package/dist/gatewayFacades.js

@@ -1,22 +1,5 @@
 import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { createTopicsClient, } from "./topicsClient.js";
-function normalizeBeliefConfidenceInput(input) {
-    const opinion = input.opinion;
-    return {
-        belief: opinion.b,
-        disbelief: opinion.d,
-        uncertainty: opinion.u,
-        baseRate: opinion.a,
-        trigger: input.trigger,
-        rationale: input.rationale,
-        triggeringEvidenceId: input.triggeringEvidenceId,
-        triggeringQuestionId: input.triggeringQuestionId,
-        triggeringAnswerId: input.triggeringAnswerId,
-        triggeringContradictionId: input.triggeringContradictionId,
-        triggeringWorktreeId: input.triggeringWorktreeId,
-        maxInlinePropagationTargets: input.maxInlinePropagationTargets,
-    };
-}
 function serializeTypes(types) {
     return Array.isArray(types) && types.length > 0 ? types.join(",") : undefined;
 }

package/dist/generated/functionSurface.d.ts

@@ -3,7 +3,7 @@ import type { JsonObject } from "../types";
 export type FunctionSurfaceClientConfig = GatewayClientConfig;
 export type FunctionSurfaceInput = JsonObject;
 export type FunctionSurfaceResult<T = unknown> = Promise<PlatformGatewaySuccess<T>>;
-export declare const FUNCTION_SURFACE_METHOD_PATHS: readonly ["answers.answerQuestion", "answers.createAnswer", "answers.getAnswer", "beliefs.archiveBelief", "beliefs.bisectConfidence", "beliefs.createBelief", "beliefs.forkBelief", "beliefs.getBelief", "beliefs.getConfidenceHistory", "beliefs.listBeliefs", "beliefs.modulateConfidence", "beliefs.refineBelief", "beliefs.searchBeliefs", "bootstrap.generateSessionHandoff", "coding.getChangeHistory", "coding.getCodeContext", "coding.getFailureLog", "coding.recordAttempt", "context.analyzeTopicDensity", "context.applyAutoBranching", "context.compileContext", "context.discover", "context.discoverEntityConnections", "context.getLatticeCoverage", "context.lucernOrient", "context.recordScopeLearning", "context.seedBeliefLattice", "context.triggerBeliefReview", "contracts.createEpistemicContract", "contracts.evaluateContract", "contracts.getContractStatus", "contradictions.flagContradiction", "controlPlane.identity.resolveInteractivePrincipal", "coordination.broadcastMessage", "coordination.claimFiles", "coordination.endSession", "coordination.getAgentInbox", "coordination.heartbeatSession", "coordination.listActiveSessions", "coordination.registerSession", "coordination.sendAgentMessage", "edges.batchCreateEdges", "edges.createEdge", "edges.queryLineage", "edges.removeEdge", "edges.removeEdgesBetween", "edges.updateEdge", "embeddings.getByNodeIds", "embeddings.listMissingForTopic", "embeddings.markEmbeddingBackfillQueued", "embeddings.vectorSearchByTopic", "evidence.addEvidence", "evidence.createEvidence", "evidence.getEvidence", "evidence.linkEvidence", "evidence.linkEvidenceToBelief", "evidence.linkEvidenceToQuestion", "evidence.listEvidence", "evidence.searchEvidence", "graph.detectConfirmationBias", "graph.findContradictions", "graph.getGraphGaps", "graph.getGraphNeighborhood", "graph.getGraphStructureAnalysis", "graph.getTopicCoverage", "graph.traceEntityImpact", "graph.traverseGraph", "graphAnalysis.listGraphIntelligenceQueries", "graphAnalysis.runGraphIntelligenceQuery", "hybrid.analyzeGraphImpact", "hybrid.detectGraphDrift", "hybrid.expandGraphNeighborhood", "hybrid.findRelatedNodes", "hybrid.hybridDiscover", "hybrid.resolveTopicSemantic", "identity.checkPermission", "identity.filterByPermission", "identity.whoami", "judgments.getAuditTrail", "judgments.recordJudgment", "lenses.applyLensToTopic", "lenses.createLens", "lenses.listLenses", "lenses.removeLensFromTopic", "nodes.archiveEpistemicNode", "nodes.batchCreateEpistemicNodes", "nodes.createEpistemicNode", "nodes.getEpistemicNode", "nodes.listEpistemicNodes", "nodes.supersedeEpistemicNode", "nodes.updateEpistemicNode", "nodes.verifyEpistemicNode", "observations.getObservationContext", "observations.ingestObservation", "ontologies.applyOntology", "ontologies.archiveOntology", "ontologies.createOntology", "ontologies.createOntologyVersion", "ontologies.deprecateOntologyVersion", "ontologies.getOntology", "ontologies.listOntologies", "ontologies.matchEntityType", "ontologies.publishOntologyVersion", "ontologies.resolveEffectiveOntology", "ontologies.updateOntology", "policy.manageWritePolicy", "questions.archiveQuestion", "questions.createQuestion", "questions.findMissingQuestions", "questions.getFalsificationQuestions", "questions.getHighPriorityQuestions", "questions.getQuestion", "questions.listQuestions", "questions.refineQuestion", "questions.updateQuestionStatus", "tasks.completeTask", "tasks.createTask", "tasks.listTasks", "tasks.updateTask", "topics.createTopic", "topics.getTopic", "topics.getTopicGraphSpine", "topics.getTopicTree", "topics.listTopics", "topics.materializeTopicGraph", "topics.updateTopic", "worktrees.activateWorktree", "worktrees.addWorktree", "worktrees.beginBuildSession", "worktrees.getWorktree", "worktrees.listAllWorktrees", "worktrees.listCampaigns", "worktrees.listWorktrees", "worktrees.merge", "worktrees.openPullRequest", "worktrees.pipelineSnapshot", "worktrees.push", "worktrees.updateWorktreeMetadata", "worktrees.updateWorktreeTargets"];
+export declare const FUNCTION_SURFACE_METHOD_PATHS: readonly ["answers.answerQuestion", "answers.createAnswer", "answers.getAnswer", "beliefs.appendSlScoring", "beliefs.archiveBelief", "beliefs.bisectConfidence", "beliefs.createBelief", "beliefs.forkBelief", "beliefs.getBelief", "beliefs.getConfidenceHistory", "beliefs.listBeliefs", "beliefs.refineBelief", "beliefs.searchBeliefs", "bootstrap.generateSessionHandoff", "coding.getChangeHistory", "coding.getCodeContext", "coding.getFailureLog", "coding.recordAttempt", "context.analyzeTopicDensity", "context.applyAutoBranching", "context.compileContext", "context.discover", "context.discoverEntityConnections", "context.getLatticeCoverage", "context.lucernOrient", "context.recordScopeLearning", "context.seedBeliefLattice", "context.triggerBeliefReview", "contracts.createEpistemicContract", "contracts.evaluateContract", "contracts.getContractStatus", "contradictions.flagContradiction", "controlPlane.identity.resolveInteractivePrincipal", "coordination.broadcastMessage", "coordination.claimFiles", "coordination.endSession", "coordination.getAgentInbox", "coordination.heartbeatSession", "coordination.listActiveSessions", "coordination.registerSession", "coordination.sendAgentMessage", "edges.batchCreateEdges", "edges.createEdge", "edges.queryLineage", "edges.removeEdge", "edges.removeEdgesBetween", "edges.updateEdge", "embeddings.getByNodeIds", "embeddings.listMissingForTopic", "embeddings.markEmbeddingBackfillQueued", "embeddings.vectorSearchByTopic", "evidence.addEvidence", "evidence.createEvidence", "evidence.getEvidence", "evidence.linkEvidence", "evidence.linkEvidenceToBelief", "evidence.linkEvidenceToQuestion", "evidence.listEvidence", "evidence.searchEvidence", "graph.detectConfirmationBias", "graph.findContradictions", "graph.getGraphGaps", "graph.getGraphNeighborhood", "graph.getGraphStructureAnalysis", "graph.getTopicCoverage", "graph.traceEntityImpact", "graph.traverseGraph", "graphAnalysis.listGraphIntelligenceQueries", "graphAnalysis.runGraphIntelligenceQuery", "hybrid.analyzeGraphImpact", "hybrid.detectGraphDrift", "hybrid.expandGraphNeighborhood", "hybrid.findRelatedNodes", "hybrid.hybridDiscover", "hybrid.resolveTopicSemantic", "identity.checkPermission", "identity.filterByPermission", "identity.whoami", "judgments.getAuditTrail", "judgments.recordJudgment", "lenses.applyLensToTopic", "lenses.createLens", "lenses.listLenses", "lenses.removeLensFromTopic", "nodes.archiveEpistemicNode", "nodes.batchCreateEpistemicNodes", "nodes.createEpistemicNode", "nodes.getEpistemicNode", "nodes.listEpistemicNodes", "nodes.supersedeEpistemicNode", "nodes.updateEpistemicNode", "nodes.verifyEpistemicNode", "observations.getObservationContext", "observations.ingestObservation", "ontologies.applyOntology", "ontologies.archiveOntology", "ontologies.createOntology", "ontologies.createOntologyVersion", "ontologies.deprecateOntologyVersion", "ontologies.getOntology", "ontologies.listOntologies", "ontologies.matchEntityType", "ontologies.publishOntologyVersion", "ontologies.resolveEffectiveOntology", "ontologies.updateOntology", "policy.manageWritePolicy", "questions.archiveQuestion", "questions.createQuestion", "questions.findMissingQuestions", "questions.getFalsificationQuestions", "questions.getHighPriorityQuestions", "questions.getQuestion", "questions.listQuestions", "questions.refineQuestion", "questions.updateQuestionStatus", "tasks.completeTask", "tasks.createTask", "tasks.listTasks", "tasks.updateTask", "topics.createTopic", "topics.getTopic", "topics.getTopicGraphSpine", "topics.getTopicTree", "topics.listTopics", "topics.materializeTopicGraph", "topics.updateTopic", "worktrees.activateWorktree", "worktrees.addWorktree", "worktrees.beginBuildSession", "worktrees.getWorktree", "worktrees.listAllWorktrees", "worktrees.listCampaigns", "worktrees.listWorktrees", "worktrees.merge", "worktrees.openPullRequest", "worktrees.pipelineSnapshot", "worktrees.push", "worktrees.updateWorktreeMetadata", "worktrees.updateWorktreeTargets"];
 export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClientConfig): {
     sessionId: string;
     activateWorktree(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -12,6 +12,7 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     analyzeGraphImpact(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     analyzeTopicDensity(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     answerQuestion(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    appendSlScoring(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     applyAutoBranching(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     applyLensToTopic(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     applyOntology(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -107,7 +108,6 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     matchEntityType(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     materializeTopicGraph(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     merge(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
-    modulateConfidence(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     openPullRequest(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     pipelineSnapshot(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     publishOntologyVersion(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;

package/dist/generated/functionSurface.js

@@ -4,6 +4,7 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "answers.answerQuestion",
     "answers.createAnswer",
     "answers.getAnswer",
+    "beliefs.appendSlScoring",
     "beliefs.archiveBelief",
     "beliefs.bisectConfidence",
     "beliefs.createBelief",
@@ -11,7 +12,6 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "beliefs.getBelief",
     "beliefs.getConfidenceHistory",
     "beliefs.listBeliefs",
-    "beliefs.modulateConfidence",
     "beliefs.refineBelief",
     "beliefs.searchBeliefs",
     "bootstrap.generateSessionHandoff",
@@ -148,6 +148,7 @@ const CONTRACTS = {
     "analyze_graph_impact": { method: "POST", path: "/hybrid/impact", kind: "action", idempotent: false, surfaceIntent: "mcp_analysis" },
     "analyze_topic_density": { method: "POST", path: "/scope/topic-density", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "answer_question": { method: "POST", path: "/questions/answer", kind: "mutation", idempotent: true, surfaceIntent: "compatibility" },
+    "append_sl_scoring": { method: "POST", path: "/beliefs/sl-scoring", kind: "mutation", idempotent: true, surfaceIntent: "system" },
     "apply_auto_branching": { method: "POST", path: "/scope/auto-branching", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
     "apply_lens_to_topic": { method: "POST", path: "/lenses/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
     "apply_ontology": { method: "POST", path: "/ontologies/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
@@ -243,7 +244,6 @@ const CONTRACTS = {
     "match_entity_type": { method: "POST", path: "/ontologies/match-entity-type", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
     "materialize_topic_graph": { method: "POST", path: "/topics/materialize-graph", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
     "merge": { method: "POST", path: "/worktrees/merge", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
-    "modulate_confidence": { method: "POST", path: "/beliefs/confidence", kind: "mutation", idempotent: true, surfaceIntent: "system" },
     "open_pull_request": { method: "POST", path: "/worktrees/open-pull-request", kind: "mutation", idempotent: true, surfaceIntent: "system" },
     "pipeline_snapshot": { method: "POST", path: "/worktrees/pipeline-snapshot", kind: "query", idempotent: false, surfaceIntent: "system" },
     "publish_ontology_version": { method: "POST", path: "/ontologies/versions/publish", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
@@ -345,6 +345,9 @@ export function createFunctionSurfaceClient(config = {}) {
         answerQuestion(input = {}, idempotencyKey) {
             return execute("answer_question", input, idempotencyKey);
         },
+        appendSlScoring(input = {}, idempotencyKey) {
+            return execute("append_sl_scoring", input, idempotencyKey);
+        },
         applyAutoBranching(input = {}, idempotencyKey) {
             return execute("apply_auto_branching", input, idempotencyKey);
         },
@@ -630,9 +633,6 @@ export function createFunctionSurfaceClient(config = {}) {
         merge(input = {}, idempotencyKey) {
             return execute("merge", input, idempotencyKey);
         },
-        modulateConfidence(input = {}, idempotencyKey) {
-            return execute("modulate_confidence", input, idempotencyKey);
-        },
         openPullRequest(input = {}, idempotencyKey) {
             return execute("open_pull_request", input, idempotencyKey);
         },

package/dist/proof-attestation.json

@@ -31,15 +31,15 @@
     }
   ],
   "contractsCovered": [
+    "append_sl_scoring",
     "create_evidence",
     "list_beliefs",
-    "list_tasks",
-    "modulate_confidence"
+    "list_tasks"
   ],
   "emittersUsed": [
     "typescript-types",
     "convex-validators",
     "proof-attestation"
   ],
-  "signedAt": 1780312208587
+  "signedAt": 1780348749569
 }

package/dist/sdkSurface.d.ts

@@ -2,6 +2,8 @@ import type { PlatformGatewaySuccess } from "./coreClient";
 import type { JsonObject, ListResult } from "./types";
 type TopicScopedValue = {
     topicId?: string;
+    topicGlobalId?: string;
+    topicNodeId?: string;
 };
 type TextScopedValue = {
     text?: string;

package/dist/sdkSurface.js

@@ -29,7 +29,9 @@ function cloneWith(value, patch) {
  * Resolve the canonical topic identifier.
  */
 export function resolveTopicId(value) {
-    return cleanString(value.topicId);
+    return (cleanString(value.topicGlobalId) ??
+        cleanString(value.topicNodeId) ??
+        cleanString(value.topicId));
 }
 /**
  * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.
@@ -73,6 +75,9 @@ export function normalizeNodeWriteInput(value) {
     const next = { ...value };
     if (topicId) {
         next.topicId = topicId;
+        if (!cleanString(next.topicGlobalId)) {
+            next.topicGlobalId = topicId;
+        }
     }
     if (text) {
         next.text = text;

package/dist/types.d.ts

@@ -17,6 +17,15 @@ export type JsonValue = null | boolean | number | string | JsonArray | JsonObjec
  * Canonical scope identifiers for SDK inputs and records.
  */
 export type TopicIdentifierInput = {
+    /**
+     * Preferred write anchor for belief creation: the globalId of a topic
+     * epistemicNode. `topicId` remains a compatibility projection for read/query
+     * surfaces and must already refer to that same topic node when used for
+     * belief writes.
+     */
+    topicGlobalId?: string;
+    /** Optional internal epistemicNodes _id for a topic node. */
+    topicNodeId?: string;
     topicId?: string;
 };
 /**
@@ -40,8 +49,8 @@ export type ListResult<T, LegacyKey extends string = never> = {
  * Atomic knowledge unit in the reasoning graph.
  *
  * A belief carries a confidence score, belongs to a topic scope, and follows
- * the knowledge-as-code lifecycle: unscored (draft) -> scored (immutable) -> forked (evolved).
- * Confidence is always modulated via the append-only credence log, never overwritten.
+ * the knowledge-as-code lifecycle: assumption -> hypothesis -> active -> resolved/superseded.
+ * Confidence is derived from supporting or contradicting evidence through SL scoring, never set by callers.
  */
 export type PlatformBeliefRecord = {
     nodeId: string;
@@ -52,6 +61,7 @@ export type PlatformBeliefRecord = {
     status?: string;
     confidence?: number | null;
     topicId?: string;
+    topicGlobalId?: string;
     title?: string;
     subtype?: string;
     domain?: string;
@@ -68,21 +78,13 @@ export type PlatformBeliefRecord = {
 };
 /** Response returned after creating a new belief node. */
 export type CreateBeliefResponse = PlatformBeliefRecord;
-/** Response returned after an append-only confidence modulation on a belief. */
-export type ModulateConfidenceResponse = {
-    nodeId: string;
-    newConfidence?: number;
-    previousConfidence?: number | null;
-    confidence?: number;
-    trigger?: string;
-    rationale?: string;
-    certainty?: number;
-    recordedAt?: number;
-};
-/** Response returned after forking a scored belief into a new formulation. The new node carries a `supersedes` edge to the parent. */
+/** Response returned after forking an evidence-bearing belief into a new formulation. */
 export interface ForkBeliefResponse extends PlatformBeliefRecord {
     parentNodeId?: string;
     forkReason?: string;
+    forkMode?: "supersede" | "branch";
+    triggeringEvidenceId?: string;
+    triggeringEvidenceRelation?: "supports" | "contradicts";
 }
 /**
  * Generic graph node spanning L1-L4 epistemic layers.

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export declare const LUCERN_SDK_VERSION = "1.0.15";
+export declare const LUCERN_SDK_VERSION = "1.0.17";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export const LUCERN_SDK_VERSION = "1.0.15";
+export const LUCERN_SDK_VERSION = "1.0.17";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/sdk",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -113,10 +113,10 @@
     "typecheck": "tsc --project tsconfig.typecheck.json --noEmit"
   },
   "dependencies": {
-    "@lucern/contracts": "1.0.15",
-    "@lucern/reasoning-kernel": "1.0.15",
-    "@lucern/secrets": "1.0.15",
-    "@lucern/transport-core": "1.0.15",
+    "@lucern/contracts": "1.0.17",
+    "@lucern/reasoning-kernel": "1.0.17",
+    "@lucern/secrets": "1.0.17",
+    "@lucern/transport-core": "1.0.17",
     "effect": "^3.21.2",
     "zod": "^3.25.76"
   },