@lucern/sdk 1.0.16 → 1.0.18

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.18] - 2026-06-02
+- Release notes pending.
+
+## [1.0.17] - 2026-06-01
+- Release notes pending.
+
 ## [1.0.16] - 2026-06-01
 - Release notes pending.
 
@@ -18,7 +24,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

@@ -22,6 +22,7 @@ export declare function createLucernClient(config?: LucernClientConfig): {
         checkPermission(input: import("./functionSurface").FunctionSurfaceInput): any;
         listAccessibleTopics(input?: Parameters<(...args: any[]) => any>[0]): any;
         filterByPermission(input: import("./functionSurface").FunctionSurfaceInput): any;
+        compileCapabilitySlice(input: Parameters<any>[0], idempotencyKey?: string): any;
         manageWritePolicy(input: import("./functionSurface").FunctionSurfaceInput, idempotencyKey?: string): any;
         raw: Record<string, (...args: any[]) => any> & {
             create: (...args: any[]) => any;
@@ -437,9 +438,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/clientPlatformNamespaces.d.ts

@@ -17,6 +17,7 @@ export declare function createClientPlatformNamespaces(ctx: ClientNamespaceConte
         checkPermission(input: FunctionSurfaceInput): any;
         listAccessibleTopics(input?: Parameters<(...args: any[]) => any>[0]): any;
         filterByPermission(input: FunctionSurfaceInput): any;
+        compileCapabilitySlice(input: Parameters<any>[0], idempotencyKey?: string): any;
         manageWritePolicy(input: FunctionSurfaceInput, idempotencyKey?: string): any;
         raw: Record<string, (...args: any[]) => any> & {
             create: (...args: any[]) => any;

package/dist/clientPlatformNamespaces.js

@@ -51,6 +51,9 @@ export function createClientPlatformNamespaces(ctx) {
                     principalId: typeof input.principalId === "string" ? input.principalId : undefined,
                 });
             },
+            compileCapabilitySlice(input, idempotencyKey) {
+                return functionSurfaceClient.compileCapabilitySlice(input, idempotencyKey);
+            },
             // Backward compatibility shim: keep the policy namespace exposing the
             // historical manageWritePolicy entry point.
             manageWritePolicy(input, idempotencyKey) {

package/dist/contextTypes.d.ts

@@ -96,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;
@@ -104,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;

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.queryAnchorHistory", "edges.queryLineage", "edges.removeEdge", "edges.removeEdgesBetween", "edges.updateEdge", "embeddings.getByNodeIds", "embeddings.listMissingForTopic", "embeddings.markEmbeddingBackfillQueued", "embeddings.vectorSearchByTopic", "evidence.addEvidence", "evidence.archiveEvidence", "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.compileCapabilitySlice", "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.listWorktreesByBelief", "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,11 +12,13 @@ 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>;
     archiveBelief(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     archiveEpistemicNode(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    archiveEvidence(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     archiveOntology(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     archiveQuestion(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     batchCreateEdges(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -26,6 +28,7 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     broadcastMessage(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     checkPermission(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     claimFiles(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    compileCapabilitySlice(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     compileContext(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     completeTask(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     createAnswer(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -102,16 +105,17 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     listTasks(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     listTopics(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     listWorktrees(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    listWorktreesByBelief(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     lucernOrient(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     manageWritePolicy(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     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>;
     push(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    queryAnchorHistory(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     queryLineage(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     markEmbeddingBackfillQueued(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     recordAttempt(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",
@@ -44,6 +44,7 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "coordination.sendAgentMessage",
     "edges.batchCreateEdges",
     "edges.createEdge",
+    "edges.queryAnchorHistory",
     "edges.queryLineage",
     "edges.removeEdge",
     "edges.removeEdgesBetween",
@@ -53,6 +54,7 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "embeddings.markEmbeddingBackfillQueued",
     "embeddings.vectorSearchByTopic",
     "evidence.addEvidence",
+    "evidence.archiveEvidence",
     "evidence.createEvidence",
     "evidence.getEvidence",
     "evidence.linkEvidence",
@@ -106,6 +108,7 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "ontologies.publishOntologyVersion",
     "ontologies.resolveEffectiveOntology",
     "ontologies.updateOntology",
+    "policy.compileCapabilitySlice",
     "policy.manageWritePolicy",
     "questions.archiveQuestion",
     "questions.createQuestion",
@@ -134,6 +137,7 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "worktrees.listAllWorktrees",
     "worktrees.listCampaigns",
     "worktrees.listWorktrees",
+    "worktrees.listWorktreesByBelief",
     "worktrees.merge",
     "worktrees.openPullRequest",
     "worktrees.pipelineSnapshot",
@@ -148,11 +152,13 @@ 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" },
     "archive_belief": { method: "DELETE", path: "/beliefs", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
     "archive_epistemic_node": { method: "POST", path: "/nodes/archive", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
+    "archive_evidence": { method: "DELETE", path: "/evidence", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
     "archive_ontology": { method: "DELETE", path: "/ontologies", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
     "archive_question": { method: "DELETE", path: "/questions", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
     "batch_create_edges": { method: "POST", path: "/edges/batch", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
@@ -162,6 +168,7 @@ const CONTRACTS = {
     "broadcast_message": { method: "POST", path: "/coordination/messages/broadcast", kind: "mutation", idempotent: true, surfaceIntent: "system" },
     "check_permission": { method: "POST", path: "/identity/check-permission", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "claim_files": { method: "POST", path: "/coordination/file-claims", kind: "mutation", idempotent: true, surfaceIntent: "system" },
+    "compile_capability_slice": { method: "POST", path: "/policy/capability-slice", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "compile_context": { method: "POST", path: "/context/compile", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "complete_task": { method: "POST", path: "/tasks/complete", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
     "create_answer": { method: "POST", path: "/answers", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
@@ -203,7 +210,7 @@ const CONTRACTS = {
     "get_epistemic_node": { method: "GET", path: "/nodes/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_evidence": { method: "GET", path: "/evidence/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_failure_log": { method: "POST", path: "/coding/failure-log", kind: "query", idempotent: false, surfaceIntent: "system" },
-    "get_falsification_questions": { method: "POST", path: "/questions/falsification", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
+    "get_falsification_questions": { method: "POST", path: "/questions/falsification", kind: "action", idempotent: true, surfaceIntent: "mcp_core" },
     "get_graph_gaps": { method: "POST", path: "/graph/gaps", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "get_graph_neighborhood": { method: "POST", path: "/graph/neighborhood", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "get_graph_structure_analysis": { method: "POST", path: "/graph/structure-analysis", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
@@ -238,16 +245,17 @@ const CONTRACTS = {
     "list_tasks": { method: "GET", path: "/tasks", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
     "list_topics": { method: "GET", path: "/topics", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "list_worktrees": { method: "GET", path: "/worktrees", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
+    "list_worktrees_by_belief": { method: "GET", path: "/worktrees/by-belief", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
     "lucern_orient": { method: "POST", path: "/context/orient", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "manage_write_policy": { method: "POST", path: "/policy/write-policy/manage", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
     "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" },
     "push": { method: "POST", path: "/worktrees/push", kind: "mutation", idempotent: true, surfaceIntent: "system" },
+    "query_anchor_history": { method: "POST", path: "/edges/anchor-history", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "query_lineage": { method: "POST", path: "/edges/lineage", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "queue_embedding_backfill": { method: "POST", path: "/embeddings/backfill-queued", kind: "mutation", idempotent: true, surfaceIntent: "mcp_analysis" },
     "record_attempt": { method: "POST", path: "/coding/attempts", kind: "mutation", idempotent: true, surfaceIntent: "system" },
@@ -345,6 +353,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);
         },
@@ -360,6 +371,9 @@ export function createFunctionSurfaceClient(config = {}) {
         archiveEpistemicNode(input = {}, idempotencyKey) {
             return execute("archive_epistemic_node", input, idempotencyKey);
         },
+        archiveEvidence(input = {}, idempotencyKey) {
+            return execute("archive_evidence", input, idempotencyKey);
+        },
         archiveOntology(input = {}, idempotencyKey) {
             return execute("archive_ontology", input, idempotencyKey);
         },
@@ -387,6 +401,9 @@ export function createFunctionSurfaceClient(config = {}) {
         claimFiles(input = {}, idempotencyKey) {
             return execute("claim_files", input, idempotencyKey);
         },
+        compileCapabilitySlice(input = {}, idempotencyKey) {
+            return execute("compile_capability_slice", input, idempotencyKey);
+        },
         compileContext(input = {}, idempotencyKey) {
             return execute("compile_context", input, idempotencyKey);
         },
@@ -615,6 +632,9 @@ export function createFunctionSurfaceClient(config = {}) {
         listWorktrees(input = {}, idempotencyKey) {
             return execute("list_worktrees", input, idempotencyKey);
         },
+        listWorktreesByBelief(input = {}, idempotencyKey) {
+            return execute("list_worktrees_by_belief", input, idempotencyKey);
+        },
         lucernOrient(input = {}, idempotencyKey) {
             return execute("lucern_orient", input, idempotencyKey);
         },
@@ -630,9 +650,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);
         },
@@ -645,6 +662,9 @@ export function createFunctionSurfaceClient(config = {}) {
         push(input = {}, idempotencyKey) {
             return execute("push", input, idempotencyKey);
         },
+        queryAnchorHistory(input = {}, idempotencyKey) {
+            return execute("query_anchor_history", input, idempotencyKey);
+        },
         queryLineage(input = {}, idempotencyKey) {
             return execute("query_lineage", input, idempotencyKey);
         },

package/dist/policyClient.d.ts

@@ -82,14 +82,38 @@ export type TenantPolicyPermission = {
     resource: string;
     actions: string[];
 };
+export type TenantPolicyKind = "role" | "object_classification";
+export type TenantPolicyExternalAccess = "allowed" | "summaries" | "omitted";
+export type TenantPolicyClassificationFields = {
+    policyKind?: TenantPolicyKind;
+    profileKey?: string;
+    objectTypes?: string[];
+    accessTier?: string;
+    exportClass?: string;
+    classificationKey?: string;
+    classificationLabels?: string[];
+    policyTags?: string[];
+    externalAccess?: TenantPolicyExternalAccess;
+    requiredGroupKey?: string;
+};
 export type TenantPolicyRecord = {
     id?: string;
     tenantId: string;
     workspaceId?: string;
+    policyKind?: TenantPolicyKind;
     roleName: string;
     description?: string;
     permissions: TenantPolicyPermission[];
     groupBindings: string[];
+    profileKey?: string;
+    objectTypes?: string[];
+    accessTier?: string;
+    exportClass?: string;
+    classificationKey?: string;
+    classificationLabels?: string[];
+    policyTags?: string[];
+    externalAccess?: TenantPolicyExternalAccess;
+    requiredGroupKey?: string;
     createdAt?: number;
     updatedAt?: number;
     createdBy?: string;
@@ -210,7 +234,7 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
     /**
      * Create a tenant role policy.
      */
-    createRolePolicy(input: GatewayScope & {
+    createRolePolicy(input: GatewayScope & TenantPolicyClassificationFields & {
         roleName: string;
         description?: string;
         permissions: TenantPolicyPermission[];
@@ -227,7 +251,7 @@ export declare function createPolicyClient(config?: PolicyClientConfig): {
     /**
      * Update a tenant role policy by identifier.
      */
-    updateRolePolicy(id: string, input: GatewayScope & {
+    updateRolePolicy(id: string, input: GatewayScope & TenantPolicyClassificationFields & {
         roleName: string;
         description?: string;
         permissions: TenantPolicyPermission[];

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": 1780319940570
+  "signedAt": 1780432640939
 }

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;
@@ -50,8 +59,11 @@ export type PlatformBeliefRecord = {
     canonicalText?: string;
     formulation?: string;
     status?: string;
+    beliefStatus?: string;
+    epistemicStatus?: string;
     confidence?: number | null;
     topicId?: string;
+    topicGlobalId?: string;
     title?: string;
     subtype?: string;
     domain?: string;
@@ -68,21 +80,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.
@@ -102,6 +106,8 @@ export type PlatformGraphNode = {
     title?: string;
     subtype?: string;
     status?: string;
+    beliefStatus?: string;
+    epistemicStatus?: string;
     confidence?: number | null;
     topicId?: string;
     sourceType?: string;
@@ -342,6 +348,7 @@ export type WorkflowBranchRecord = {
  */
 export type WorkflowWorktreeRecord = {
     worktreeId?: string;
+    nodeId?: string;
     topicId?: string;
     branchId?: string;
     title?: string;

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/sdk",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "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.16",
-    "@lucern/reasoning-kernel": "1.0.16",
-    "@lucern/secrets": "1.0.16",
-    "@lucern/transport-core": "1.0.16",
+    "@lucern/contracts": "1.0.18",
+    "@lucern/reasoning-kernel": "1.0.18",
+    "@lucern/secrets": "1.0.18",
+    "@lucern/transport-core": "1.0.18",
     "effect": "^3.21.2",
     "zod": "^3.25.76"
   },