@lucern/sdk 1.0.29 → 1.0.31

package/dist/types.d.ts

@@ -1,9 +1,9 @@
+import type { DeprecatedBranchMetadata, LensPerspectiveType, LensPromptTemplateReference, LensQuestionTemplate, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "./contracts/lensWorkflow";
 import type { WorkflowAutoFixPolicy, WorkflowProofArtifact, WorkflowStaffingHint } from "./contracts/workflowRuntime";
-import type { DeprecatedBranchMetadata, LensPerspectiveType, LensPromptTemplateReference, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "./contracts/lensWorkflow";
 /** JSON-safe object whose values are recursively JSON-serializable. */
-export type JsonObject = {
+export interface JsonObject {
     [key: string]: JsonValue | undefined;
-};
+}
 /** JSON-safe array whose elements are recursively JSON-serializable. */
 export type JsonArray = JsonValue[];
 /**
@@ -16,7 +16,7 @@ export type JsonValue = null | boolean | number | string | JsonArray | JsonObjec
 /**
  * Canonical scope identifiers for SDK inputs and records.
  */
-export type TopicIdentifierInput = {
+export interface TopicIdentifierInput {
     /**
      * Preferred write anchor for belief creation: the UUIDv7 globalId of a topic
      * epistemicNode. `topicId` remains a read/query scope for non-belief-write
@@ -24,15 +24,15 @@ export type TopicIdentifierInput = {
      */
     topicGlobalId?: string;
     topicId?: string;
-};
+}
 /**
  * Canonical text aliases for belief, question, and evidence payloads.
  */
-export type TextAliasInput = {
-    text?: string;
+export interface TextAliasInput {
     /** @deprecated Use text. */
     canonicalText?: string;
-};
+    text?: string;
+}
 /**
  * Standard list envelope returned by canonical SDK list methods.
  */
@@ -49,39 +49,39 @@ export type ListResult<T, LegacyKey extends string = never> = {
  * 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;
-    globalId?: string;
-    text?: string;
-    canonicalText?: string;
-    formulation?: string;
-    status?: string;
+export interface PlatformBeliefRecord {
     beliefStatus?: string;
-    epistemicStatus?: string;
+    canonicalText?: string;
     confidence?: number | null;
-    topicId?: string;
-    topicGlobalId?: string;
-    title?: string;
-    subtype?: string;
+    content?: string;
+    contentHash?: string;
+    createdAt?: number;
+    createdBy?: string;
     domain?: string;
+    epistemicStatus?: string;
+    formulation?: string;
+    globalId?: string;
     layer?: string;
+    metadata?: JsonObject | null;
+    nodeId: string;
     sourceType?: string;
-    content?: string;
-    contentHash?: string;
+    status?: string;
+    subtype?: string;
     tags?: string[];
-    verificationStatus?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
+    text?: string;
+    title?: string;
+    topicGlobalId?: string;
+    topicId?: string;
     updatedAt?: number;
-    createdBy?: string;
-};
+    verificationStatus?: string;
+}
 /** Response returned after creating a new belief node. */
 export type CreateBeliefResponse = PlatformBeliefRecord;
 /** Response returned after forking an evidence-bearing belief into a new formulation. */
 export interface ForkBeliefResponse extends PlatformBeliefRecord {
-    parentNodeId?: string;
-    forkReason?: string;
     forkMode?: "supersede" | "branch";
+    forkReason?: string;
+    parentNodeId?: string;
     triggeringEvidenceId?: string;
     triggeringEvidenceRelation?: "supports" | "contradicts";
 }
@@ -92,28 +92,28 @@ export interface ForkBeliefResponse extends PlatformBeliefRecord {
  * The `nodeType` field discriminates the layer; `confidence` is meaningful only
  * for belief-typed nodes.
  */
-export type PlatformGraphNode = {
-    nodeId?: string;
-    globalId?: string;
-    nodeType?: string;
-    text?: string;
+export interface PlatformGraphNode {
+    beliefStatus?: string;
     canonicalText?: string;
+    confidence?: number | null;
     content?: string;
     contentHash?: string;
-    title?: string;
-    subtype?: string;
-    status?: string;
-    beliefStatus?: string;
+    createdAt?: number;
     epistemicStatus?: string;
-    confidence?: number | null;
-    topicId?: string;
+    globalId?: string;
+    metadata?: JsonObject | null;
+    nodeId?: string;
+    nodeType?: string;
     sourceType?: string;
+    status?: string;
+    subtype?: string;
     tags?: string[];
-    verificationStatus?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
+    text?: string;
+    title?: string;
+    topicId?: string;
     updatedAt?: number;
-};
+    verificationStatus?: string;
+}
 /**
  * Directed edge between two graph nodes.
  *
@@ -121,39 +121,31 @@ export type PlatformGraphNode = {
  * The `edgeType` field classifies the relationship (informs, tests, depends_on, supersedes, etc.).
  * Layer transition rules are enforced: L1 -> L3 direct edges are forbidden.
  */
-export type PlatformGraphEdge = {
+export interface PlatformGraphEdge {
+    confidence?: number;
+    context?: string;
+    createdAt?: number;
+    derivationType?: string;
     edgeId?: string;
-    globalId?: string;
-    fromNodeId?: string;
-    toNodeId?: string;
+    edgeType?: string;
     fromGlobalId?: string;
-    toGlobalId?: string;
+    fromNodeId?: string;
+    globalId?: string;
     sourceGlobalId?: string;
     targetGlobalId?: string;
-    edgeType?: string;
+    toGlobalId?: string;
+    toNodeId?: string;
     topicId?: string;
-    confidence?: number;
-    weight?: number;
-    context?: string;
-    derivationType?: string;
-    createdAt?: number;
     updatedAt?: number;
-};
+    weight?: number;
+}
 /** The resolved principal context returned by the public SDK identity surface. */
-export type SdkPrincipalContext = {
-    principalId: string;
-    principalType: "user" | "human" | "service" | "group" | "external_viewer" | "agent";
-    tenantId: string | null;
-    workspaceId: string | null;
-    scopes: string[];
-    roles: string[];
+export interface SdkPrincipalContext {
+    authMode?: string;
     clerkId?: string;
+    delegatedBy?: string;
+    expiresAt?: number;
     groupIds?: string[];
-    permittedToolNames?: string[];
-    permittedPackKeys?: string[];
-    principalStatus?: string;
-    tenantStatus?: string;
-    workspaceStatus?: string;
     isPlatformAdmin: boolean;
     isTenantAdmin: boolean;
     isWorkspaceAdmin: boolean;
@@ -162,129 +154,137 @@ export type SdkPrincipalContext = {
         tenant: string;
         workspace?: string;
     };
-    authMode?: string;
+    permittedPackKeys?: string[];
+    permittedToolNames?: string[];
+    principalId: string;
+    principalStatus?: string;
+    principalType: "user" | "human" | "service" | "group" | "external_viewer" | "agent";
+    roles: string[];
+    scopes: string[];
     sessionId?: string;
-    delegatedBy?: string;
-    expiresAt?: number;
-};
+    tenantId: string | null;
+    tenantStatus?: string;
+    workspaceId: string | null;
+    workspaceStatus?: string;
+}
 /** Evidence node record returned by evidence lifecycle APIs. */
-export type PlatformEvidenceRecord = {
-    nodeId?: string;
+export interface PlatformEvidenceRecord {
+    canonicalText?: string;
+    createdAt?: number;
+    createdBy?: string;
     evidenceId?: string;
+    externalSourceUrl?: string;
     globalId?: string;
-    topicId?: string;
-    text?: string;
-    canonicalText?: string;
-    title?: string;
     kind?: string;
-    status?: string;
-    source?: string;
-    sourceUrl?: string;
-    externalSourceUrl?: string;
     linkedBeliefId?: string;
     linkedQuestionId?: string;
-    verificationStatus?: string;
     metadata?: JsonObject | null;
+    nodeId?: string;
+    source?: string;
+    sourceUrl?: string;
+    status?: string;
     tags?: string[];
-    createdAt?: number;
+    text?: string;
+    title?: string;
+    topicId?: string;
     updatedAt?: number;
-    createdBy?: string;
-};
+    verificationStatus?: string;
+}
 /** Source node record returned by source lifecycle APIs. */
-export type PlatformSourceRecord = {
-    nodeId?: string;
-    sourceId?: string;
-    globalId?: string;
-    topicId?: string;
-    url?: string;
+export interface PlatformSourceRecord {
     contentSha?: string;
+    createdAt?: number;
+    createdBy?: string;
+    globalId?: string;
     kind?: string;
-    title?: string;
     metadata?: JsonObject | null;
-    createdAt?: number;
+    nodeId?: string;
+    sourceId?: string;
+    title?: string;
+    topicId?: string;
     updatedAt?: number;
-    createdBy?: string;
-};
+    url?: string;
+}
 /** Response returned after creating or updating a source node. */
 export type UpsertSourceResponse = PlatformSourceRecord;
 /** Response returned when fetching a single source node. */
 export type GetSourceResponse = PlatformSourceRecord;
 /** Question node record returned by question lifecycle APIs. */
-export type PlatformQuestionRecord = {
-    nodeId?: string;
-    questionId?: string;
-    globalId?: string;
-    topicId?: string;
-    text?: string;
+export interface PlatformQuestionRecord {
+    answerCompleteness?: string;
     canonicalText?: string;
-    question?: string;
-    status?: string;
-    priority?: string;
     category?: string;
-    questionType?: string;
-    linkedBeliefId?: string;
-    linkedWorktreeId?: string;
     conviction?: number;
-    answerCompleteness?: string;
     convictionRationale?: string;
-    metadata?: JsonObject | null;
     createdAt?: number;
-    updatedAt?: number;
     createdBy?: string;
-};
+    globalId?: string;
+    linkedBeliefId?: string;
+    linkedWorktreeId?: string;
+    metadata?: JsonObject | null;
+    nodeId?: string;
+    priority?: string;
+    question?: string;
+    questionId?: string;
+    questionType?: string;
+    status?: string;
+    text?: string;
+    topicId?: string;
+    updatedAt?: number;
+}
 /** Answer record returned by answer/question APIs. */
-export type PlatformAnswerRecord = {
-    nodeId?: string | null;
+export interface PlatformAnswerRecord {
+    answeredBy?: string;
     answerId?: string | null;
-    globalId?: string | null;
-    questionNodeId?: string | null;
+    answerSource?: string;
     answerText?: string | null;
     confidence?: string | null;
-    versionNumber?: number;
-    isLatest?: boolean;
+    createdAt?: number;
     evidenceCount?: number;
-    answeredBy?: string;
-    answerSource?: string;
-    status?: string;
+    globalId?: string | null;
+    isLatest?: boolean;
     metadata?: JsonObject | null;
-    createdAt?: number;
+    nodeId?: string | null;
+    questionNodeId?: string | null;
+    status?: string;
     updatedAt?: number;
-};
+    versionNumber?: number;
+}
 /** Contract record returned by contract APIs. */
-export type PlatformContract = {
-    contractId?: string;
+export interface PlatformContract {
     beliefId?: string;
     beliefNodeId?: string;
-    title?: string;
-    description?: string;
-    status?: string;
-    conditionType?: string;
-    direction?: string;
-    condition?: JsonValue;
-    deadline?: number;
     compositeOf?: string[];
     compositeOperator?: string;
-    modulation?: JsonValue;
+    condition?: JsonValue;
+    conditionType?: string;
+    contractId?: string;
+    createdAt?: number;
+    deadline?: number;
+    description?: string;
+    direction?: string;
     evaluationSchedule?: string;
+    metadata?: JsonObject | null;
+    modulation?: JsonValue;
     periodicIntervalMs?: number;
-    createdAt?: number;
+    status?: string;
+    title?: string;
     updatedAt?: number;
-    metadata?: JsonObject | null;
-};
+}
 /** Evaluation result for an epistemic contract. */
-export type PlatformContractEvaluation = {
-    contractId?: string;
+export interface PlatformContractEvaluation {
     beliefId?: string;
     beliefNodeId?: string;
-    status?: string;
+    contractId?: string;
+    details?: JsonValue;
+    evaluatedAt?: number;
     evaluationStatus?: string;
+    modulationApplied?: JsonValue;
+    nextEvaluationAt?: number;
     satisfied?: boolean;
+    status?: string;
     trigger?: JsonValue;
-    evaluatedAt?: number;
-    nextEvaluationAt?: number;
-    modulationApplied?: JsonValue;
-    details?: JsonValue;
-};
+}
 /** Response from a graph node query. May be a single node, an array, or null if not found. */
 export type QueryNodesResponse = PlatformGraphNode | PlatformGraphNode[] | null;
 /** Response returned after creating a new graph node. */
@@ -296,34 +296,34 @@ export type QueryEdgesResponse = PlatformGraphEdge | PlatformGraphEdge[] | null;
 /** Response returned after creating a new graph edge. */
 export type CreateEdgeResponse = PlatformGraphEdge;
 /** Count of edges removed in a bulk delete operation. */
-export type DeleteEdgeCountResponse = {
-    removed?: number;
+export interface DeleteEdgeCountResponse {
     deleted?: number;
-};
+    removed?: number;
+}
 /** Response from an edge delete operation. May include removed edge details or a count summary. */
 export type DeleteEdgeResponse = PlatformGraphEdge | PlatformGraphEdge[] | DeleteEdgeCountResponse | null;
 /** Local neighborhood around one or more graph nodes, including connected nodes and edges up to `maxDepth`. */
-export type GraphNeighborhoodResponse = {
-    nodes?: PlatformGraphNode[];
+export interface GraphNeighborhoodResponse {
     edges?: PlatformGraphEdge[];
-    rootGlobalIds?: string[];
     maxDepth?: number;
-};
+    nodes?: PlatformGraphNode[];
+    rootGlobalIds?: string[];
+}
 /** Path traversal result between two graph nodes, including direct edges and the connected subgraph. */
-export type GraphPathResponse = {
+export interface GraphPathResponse {
+    connectedGraph: GraphNeighborhoodResponse;
+    directEdges: PlatformGraphEdge[];
     fromGlobalId: string;
-    toGlobalId: string;
     maxDepth: number;
-    directEdges: PlatformGraphEdge[];
-    connectedGraph: GraphNeighborhoodResponse;
-};
+    toGlobalId: string;
+}
 /** Available graph analytics metric types for structural analysis. */
 export type GraphAnalyticsMetric = "graph_stats" | "contradiction_tension" | "confirmation_bias" | "reasoning_depth" | "knowledge_frontier";
 /** Response envelope for a graph analytics computation, parameterized by metric type. */
-export type GraphAnalyticsResponse<Metric extends GraphAnalyticsMetric = GraphAnalyticsMetric> = {
+export interface GraphAnalyticsResponse<Metric extends GraphAnalyticsMetric = GraphAnalyticsMetric> {
     metric: Metric;
     payload: JsonValue;
-};
+}
 /** A thematic branch within a topic. Worktrees are checked out from branches. */
 export type WorkflowBranchRecord = {
     branchId?: string;
@@ -343,36 +343,36 @@ export type WorkflowBranchRecord = {
  * Beliefs committed within a worktree can be freely amended (draft code on a feature branch).
  * When investigation is complete, `merge` integrates findings into the stable knowledge base.
  */
-export type WorkflowWorktreeRecord = {
-    worktreeId?: string;
-    nodeId?: string;
-    topicId?: string;
+export interface WorkflowWorktreeRecord {
+    autoFixPolicy?: WorkflowAutoFixPolicy;
+    autoShapeApplied?: boolean;
+    blocks?: string[];
     branchId?: string;
-    title?: string;
-    status?: string;
-    phase?: string;
     campaign?: number;
-    hypothesis?: string;
-    questionCount?: number;
-    taskCount?: number;
-    autoShapeApplied?: boolean;
-    frameworkSuggestions?: JsonValue[];
+    createdAt?: number;
+    createdBy?: string;
     dependencySuggestions?: JsonValue[];
+    dependsOn?: string[];
+    frameworkSuggestions?: JsonValue[];
     gate?: string;
+    hypothesis?: string;
     lane?: string;
     laneOrderInCampaign?: number;
+    lastReconciledAt?: number;
+    metadata?: JsonObject | null;
+    nodeId?: string;
     orderInLane?: number;
-    dependsOn?: string[];
-    blocks?: string[];
+    phase?: string;
     proofArtifacts?: WorkflowProofArtifact[];
+    questionCount?: number;
     staffingHint?: WorkflowStaffingHint | string;
-    lastReconciledAt?: number;
-    autoFixPolicy?: WorkflowAutoFixPolicy;
-    metadata?: JsonObject | null;
-    createdAt?: number;
+    status?: string;
+    taskCount?: number;
+    title?: string;
+    topicId?: string;
     updatedAt?: number;
-    createdBy?: string;
-};
+    worktreeId?: string;
+}
 /** Paginated list of workflow branches. */
 export type ListBranchesResponse = ListResult<WorkflowBranchRecord, "branches">;
 /** Response returned after creating a new workflow branch. */
@@ -383,36 +383,37 @@ export type CreateBranchResponse = WorkflowBranchRecord;
  * A lens overlays a topic with a specific investigation frame. Multiple lenses can coexist
  * on the same topic. Lenses persist across worktrees and carry operational scaffolding.
  */
-export type WorkflowLensRecord = {
+export interface WorkflowLensRecord {
+    createdAt?: number;
+    createdBy?: string;
+    description?: string;
+    filterCriteria?: JsonValue;
+    isAppliedToTopic?: boolean;
     lensId?: string;
-    workspaceId?: string;
-    topicId?: string;
+    metadata?: JsonObject | null;
     name?: string;
-    description?: string;
     perspectiveType?: LensPerspectiveType;
-    status?: LensStatus;
-    isAppliedToTopic?: boolean;
     promptTemplates?: LensPromptTemplateReference[];
-    workflowTemplates?: LensWorkflowTemplate[];
+    questionTemplates?: LensQuestionTemplate[];
+    status?: LensStatus;
     taskTemplates?: LensTaskTemplate[];
-    filterCriteria?: JsonValue;
-    metadata?: JsonObject | null;
-    createdAt?: number;
+    topicId?: string;
     updatedAt?: number;
-    createdBy?: string;
-};
+    workflowTemplates?: LensWorkflowTemplate[];
+    workspaceId?: string;
+}
 /** Record of a lens being applied to (or removed from) a topic. */
-export type WorkflowLensBindingRecord = {
+export interface WorkflowLensBindingRecord {
+    appliedAt?: number;
     bindingId?: string;
     lensId?: string;
-    workspaceId?: string;
-    topicId?: string;
-    status?: string;
-    appliedAt?: number;
+    metadata?: JsonObject | null;
     removedAt?: number;
+    status?: string;
+    topicId?: string;
     updatedAt?: number;
-    metadata?: JsonObject | null;
-};
+    workspaceId?: string;
+}
 /** Paginated list of workflow lenses. */
 export type ListLensesResponse = ListResult<WorkflowLensRecord, "lenses">;
 /** Response returned after creating a new lens. */
@@ -427,49 +428,49 @@ export type ListWorktreesResponse = ListResult<WorkflowWorktreeRecord, "worktree
 /** Response returned after adding a new worktree to a topic. */
 export type AddWorktreeResponse = WorkflowWorktreeRecord;
 /** Response returned after merging a worktree's findings into the stable knowledge base. */
-export type MergeWorktreeResponse = {
-    worktreeId?: string;
-    status?: string;
-    outcome?: string;
+export interface MergeWorktreeResponse {
     beliefsScored?: number;
+    mergedAt?: number;
+    outcome?: string;
+    status?: string;
     summary?: string;
-    mergedAt?: number;
-};
+    worktreeId?: string;
+}
 /** Response returned after opening a pull request for peer review of a worktree. */
-export type OpenPullRequestResponse = {
+export interface OpenPullRequestResponse {
+    createdAt?: number;
     pullRequestId?: string;
-    worktreeId?: string;
+    reviewers?: string[];
     status?: string;
     summary?: string;
-    reviewers?: string[];
-    createdAt?: number;
-};
+    worktreeId?: string;
+}
 /** Response returned after pushing scored beliefs from a merged worktree to a target context. */
-export type PushWorktreeResponse = {
-    pushId?: string;
+export interface PushWorktreeResponse {
+    createdAt?: number;
     pushedCount?: number;
-    targetContext?: string;
+    pushId?: string;
     status?: string;
-    createdAt?: number;
-};
+    targetContext?: string;
+}
 /** Lightweight topic record used in workflow context (topic switching, listing). */
-export type WorkflowTopicRecord = {
-    topicId: string;
-    name: string;
-    type?: string;
+export interface WorkflowTopicRecord {
     isOwner?: boolean;
+    name: string;
     tenantId?: string;
+    topicId: string;
+    type?: string;
     workspaceId?: string;
-};
+}
 /** Paginated list of workflow topic records. */
 export type ListTopicsResponse = ListResult<WorkflowTopicRecord, "topics">;
 /** Response returned after switching the active topic context. */
-export type SwitchTopicContextResponse = {
+export interface SwitchTopicContextResponse {
+    briefing: JsonValue | null;
+    switched: boolean;
     topicId: string;
     topicName: string;
-    switched: boolean;
-    briefing: JsonValue | null;
-};
+}
 /**
  * @deprecated Use WorkflowTopicRecord.
  */
@@ -483,27 +484,27 @@ export type ListProjectsResponse = ListTopicsResponse;
  */
 export type SwitchProjectContextResponse = SwitchTopicContextResponse;
 /** Full topic record with hierarchy, visibility, and tenant/workspace scoping. */
-export type TopicRecord = {
-    topicId?: string;
-    id?: string;
-    globalId?: string;
-    topicGlobalId?: string;
-    epistemicNodeId?: string;
+export interface TopicRecord {
+    createdAt?: number;
+    depth?: number;
+    description?: string;
     epistemicNodeGlobalId?: string;
-    parentEdgeId?: string;
-    parentEdgeGlobalId?: string;
+    epistemicNodeId?: string;
+    globalId?: string;
+    id?: string;
     name?: string;
-    description?: string;
-    type?: string;
-    depth?: number;
-    status?: string;
+    parentEdgeGlobalId?: string;
+    parentEdgeId?: string;
     parentTopicId?: string | null;
+    status?: string;
     tenantId?: string;
-    workspaceId?: string;
-    visibility?: string;
-    createdAt?: number;
+    topicGlobalId?: string;
+    topicId?: string;
+    type?: string;
     updatedAt?: number;
-};
+    visibility?: string;
+    workspaceId?: string;
+}
 /** Paginated list of full topic records. */
 export type TopicListResponse = ListResult<TopicRecord, "topics">;
 /** Topic record extended with ancestry path for tree traversals. */
@@ -511,59 +512,59 @@ export type TopicTreeNode = TopicRecord & {
     path?: string[];
 };
 /** Response containing the full topic hierarchy from a given root. */
-export type TopicTreeResponse = {
+export interface TopicTreeResponse {
     tree: TopicTreeNode[];
-};
+}
 /** Per-topic belief, question, and evidence counts for coverage analysis. */
-export type TopicCoverageRecord = {
-    topicId: string;
-    name: string;
-    type: string;
-    depth: number;
+export interface TopicCoverageRecord {
     beliefs: number;
-    questions: number;
-    evidence: number;
     coverage: "full" | "partial" | "empty";
-};
+    depth: number;
+    evidence: number;
+    name: string;
+    questions: number;
+    topicId: string;
+    type: string;
+}
 /** Aggregate coverage statistics across the topic tree. */
-export type TopicCoverageSummary = {
-    totalTopics: number;
+export interface TopicCoverageSummary {
+    coveragePercent: number;
     coveredTopics: number;
     emptyTopics: number;
-    coveragePercent: number;
     totalBeliefs: number;
-    totalQuestions: number;
     totalEvidence: number;
-};
+    totalQuestions: number;
+    totalTopics: number;
+}
 /** Full coverage report with per-topic records and an aggregate summary. */
-export type TopicCoverageResponse = {
-    topics: TopicCoverageRecord[];
-    summary: TopicCoverageSummary;
+export interface TopicCoverageResponse {
     scopeTopicId?: string | null;
-};
+    summary: TopicCoverageSummary;
+    topics: TopicCoverageRecord[];
+}
 /** Response returned after creating a new execution task. */
-export type CreateTaskResponse = {
-    taskId: string;
-    status: string;
+export interface CreateTaskResponse {
     createdAt: number;
-    linkedWorktreeId?: string;
-    linkedQuestionId?: string;
     linkedBeliefId?: string;
-};
-/** Response returned after marking a task as complete. */
-export type CompleteTaskResponse = {
+    linkedQuestionId?: string;
+    linkedWorktreeId?: string;
+    status: string;
     taskId: string;
+}
+/** Response returned after marking a task as complete. */
+export interface CompleteTaskResponse {
     completedAt: number;
     outputSummary: string;
     status?: string;
-};
-/** Response returned after updating a task's fields. */
-export type UpdateTaskResponse = {
     taskId: string;
-    updatedAt: number;
+}
+/** Response returned after updating a task's fields. */
+export interface UpdateTaskResponse {
     status?: string;
+    taskId: string;
     title?: string;
-};
+    updatedAt: number;
+}
 /**
  * Irreversible commitment based on the current epistemic state.
  *
@@ -571,163 +572,163 @@ export type UpdateTaskResponse = {
  * Once issued, it is evaluated against the epistemic state that existed when it was made
  * (knowledge horizon evaluation, Invariant #10). Judgments are L4 entities in the graph.
  */
-export type JudgmentRecord = {
+export interface JudgmentRecord {
     _id?: string;
-    judgmentId?: string;
-    globalId?: string;
-    summary?: string;
-    title?: string;
-    rationale?: string;
+    alternativesConsidered?: string[];
+    amount?: number;
+    companyId?: string;
+    confidence?: number;
+    createdAt?: number;
+    decisionConfidence?: number;
+    decisionMakers?: string[];
     decisionType?: string;
+    globalId?: string;
+    judgmentId?: string;
     judgmentType?: string;
-    decisionConfidence?: number;
-    confidence?: number;
+    keyUncertainties?: string[];
     outcome?: string;
+    rationale?: string;
     status?: string;
+    summary?: string;
+    terms?: string;
+    themeIds?: string[];
+    title?: string;
     topicId?: string;
-    createdAt?: number;
     updatedAt?: number;
-    companyId?: string;
-    amount?: number;
     valuation?: number;
-    terms?: string;
-    keyUncertainties?: string[];
-    alternativesConsidered?: string[];
-    decisionMakers?: string[];
-    themeIds?: string[];
-};
+}
 /** Paginated list of judgment records. */
 export type ListJudgmentsResponse = ListResult<JudgmentRecord, "judgments">;
 /** A single judgment record, or null if not found. */
 export type GetJudgmentResponse = JudgmentRecord | null;
 /** Response returned after recording a new judgment, including the knowledge horizon snapshot. */
-export type RecordJudgmentResponse = {
-    nodeId?: string;
-    judgmentId?: string;
-    globalId?: string;
-    status?: string;
+export interface RecordJudgmentResponse {
     createdAt?: number;
+    globalId?: string;
+    judgmentId?: string;
     knowledgeHorizon?: {
         beliefCount?: number;
         openQuestionCount?: number;
         contradictionCount?: number;
     };
-};
+    nodeId?: string;
+    status?: string;
+}
 /** Response returned after recording the real-world outcome of a judgment. */
-export type RecordJudgmentOutcomeResponse = {
-    success?: boolean;
+export interface RecordJudgmentOutcomeResponse {
     judgmentId?: string;
     outcome?: string;
+    success?: boolean;
     updatedAt?: number;
-};
+}
 /** Assessment of whether the epistemic state is sufficient to issue a judgment. */
-export type JudgmentReadinessResponse = {
-    ready?: boolean;
-    beliefCount?: number;
-    questionCoverage?: number;
+export interface JudgmentReadinessResponse {
     avgConfidence?: number;
-    evidencePerBelief?: number;
-    unresolvedContradictions?: number;
+    beliefCount?: number;
     blockers?: string[];
+    evidencePerBelief?: number;
+    questionCoverage?: number;
+    ready?: boolean;
     recommendation?: string;
-};
+    unresolvedContradictions?: number;
+}
 /** Calibration statistics for a single judgment type bucket. */
-export type JudgmentCalibrationBucket = {
-    total?: number;
+export interface JudgmentCalibrationBucket {
     successful?: number;
-};
+    total?: number;
+}
 /** Calibration analysis comparing judgment confidence against real outcomes. */
-export type JudgmentCalibrationResponse = {
-    totalDecisions?: number;
-    decisionsWithOutcomes?: number;
+export interface JudgmentCalibrationResponse {
+    byType?: Record<string, JudgmentCalibrationBucket>;
     calibration?: {
         calibrationScore?: number;
         overconfident?: boolean;
         underconfident?: boolean;
     } | null;
-    byType?: Record<string, JudgmentCalibrationBucket>;
-};
+    decisionsWithOutcomes?: number;
+    totalDecisions?: number;
+}
 /** A judgment that has been made but whose real-world outcome has not yet been recorded. */
-export type PendingJudgmentOutcomeRecord = {
+export interface PendingJudgmentOutcomeRecord {
     _id?: string;
-    globalId?: string;
-    summary?: string;
-    title?: string;
-    decisionType?: string;
+    companyId?: string;
     decisionConfidence?: number | null;
     decisionDate?: number;
-    companyId?: string;
+    decisionType?: string;
+    globalId?: string;
     outcome?: string;
     status?: string;
-};
+    summary?: string;
+    title?: string;
+}
 /** Paginated list of judgments pending outcome review. */
 export type PendingJudgmentOutcomeReviewResponse = ListResult<PendingJudgmentOutcomeRecord, "reviews">;
 /** A single integrity issue found during judgment transition audit. */
-export type JudgmentTransitionAuditIntegrityIssue = {
+export interface JudgmentTransitionAuditIntegrityIssue {
     code?: string;
-    severity?: "error" | "warning" | string;
     message?: string;
-};
+    severity?: "error" | "warning" | string;
+}
 /** Integrity check result for a single judgment's transition audit trail. */
-export type JudgmentTransitionAuditIntegrityCheck = {
+export interface JudgmentTransitionAuditIntegrityCheck {
+    auditEventCount?: number;
     decisionNodeId?: string;
     globalId?: string;
-    status?: string;
-    outcome?: string;
-    auditEventCount?: number;
     issues?: JudgmentTransitionAuditIntegrityIssue[];
-};
+    outcome?: string;
+    status?: string;
+}
 /** Full integrity report for all judgment transitions within a topic. */
-export type JudgmentTransitionAuditIntegrityResponse = {
-    topicId?: string;
+export interface JudgmentTransitionAuditIntegrityResponse {
     checkedDecisionCount?: number;
+    checks?: JudgmentTransitionAuditIntegrityCheck[];
     failingDecisionCount?: number;
-    passed?: boolean;
     issueTypeBreakdown?: Record<string, number>;
-    checks?: JudgmentTransitionAuditIntegrityCheck[];
-};
+    passed?: boolean;
+    topicId?: string;
+}
 /** A report template definition for generating structured reports. */
-export type ReportTemplateRecord = {
-    templateId?: string;
-    slug?: string;
-    name?: string;
-    version?: string;
+export interface ReportTemplateRecord {
     description?: string;
+    name?: string;
+    slug?: string;
     status?: string;
-};
+    templateId?: string;
+    version?: string;
+}
 /** Response for report template queries. May be a list, a single template, or null. */
 export type ReportTemplatesResponse = ListResult<ReportTemplateRecord, "templates"> | ReportTemplateRecord | null;
 /** A generated report instance for a topic. */
-export type ProjectReportRecord = {
+export interface ProjectReportRecord {
+    createdAt?: number;
     reportId?: string;
-    topicId?: string;
-    title?: string;
-    status?: string;
     slug?: string;
+    status?: string;
     summary?: string;
-    createdAt?: number;
+    title?: string;
+    topicId?: string;
     updatedAt?: number;
-};
+}
 /** Paginated list of generated reports. */
 export type ProjectReportsResponse = ListResult<ProjectReportRecord, "reports">;
 /** A single section within a generated report. */
-export type ReportSectionRecord = {
-    sectionId?: string;
-    slug?: string;
-    title?: string;
-    heading?: string;
+export interface ReportSectionRecord {
     body?: string;
     content?: string;
-    order?: number;
+    heading?: string;
     metadata?: JsonObject | null;
-};
+    order?: number;
+    sectionId?: string;
+    slug?: string;
+    title?: string;
+}
 /** A complete report including all its sections. */
-export type ReportWithSectionsResponse = {
+export interface ReportWithSectionsResponse {
     reportId?: string;
-    topicId?: string;
-    title?: string;
+    sections?: ReportSectionRecord[];
     status?: string;
     summary?: string;
-    sections?: ReportSectionRecord[];
-};
+    title?: string;
+    topicId?: string;
+}
 //# sourceMappingURL=types.d.ts.map