@lucern/sdk 0.2.0-alpha.1

package/dist/packages/sdk/src/types.d.ts

@@ -0,0 +1,489 @@
+import type { WorkflowAutoFixPolicy, WorkflowProofArtifact, WorkflowStaffingHint } from "@lucern/contracts/workflow-runtime.contract";
+import type { DeprecatedBranchMetadata, LensPerspectiveType, LensPromptTemplateReference, LensStatus, LensTaskTemplate, LensWorkflowTemplate } from "@lucern/contracts/lens-workflow.contract";
+export type JsonObject = {
+    [key: string]: JsonValue | undefined;
+};
+export type JsonArray = JsonValue[];
+export type JsonValue = null | boolean | number | string | JsonArray | JsonObject;
+/**
+ * Canonical scope identifiers for SDK inputs and records.
+ */
+export type TopicIdentifierInput = {
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+};
+/**
+ * Canonical text aliases for belief, question, and evidence payloads.
+ */
+export type TextAliasInput = {
+    text?: string;
+    /** @deprecated Use text. */
+    canonicalText?: string;
+};
+/**
+ * Standard list envelope returned by canonical SDK list methods.
+ */
+export type ListResult<T, LegacyKey extends string = never> = {
+    items: T[];
+    total: number;
+} & {
+    [Key in LegacyKey]: T[];
+};
+export type PlatformBeliefRecord = {
+    nodeId: string;
+    globalId?: string;
+    text?: string;
+    canonicalText?: string;
+    formulation?: string;
+    status?: string;
+    confidence?: number | null;
+    topicId?: string;
+    projectId?: string;
+    title?: string;
+    subtype?: string;
+    domain?: string;
+    layer?: string;
+    sourceType?: string;
+    content?: string;
+    contentHash?: string;
+    tags?: string[];
+    verificationStatus?: string;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+};
+export type CreateBeliefResponse = PlatformBeliefRecord;
+export type ModulateConfidenceResponse = {
+    nodeId: string;
+    newConfidence?: number;
+    previousConfidence?: number | null;
+    confidence?: number;
+    trigger?: string;
+    rationale?: string;
+    certainty?: number;
+    recordedAt?: number;
+};
+export interface ForkBeliefResponse extends PlatformBeliefRecord {
+    parentNodeId?: string;
+    forkReason?: string;
+}
+export type PlatformGraphNode = {
+    nodeId?: string;
+    globalId?: string;
+    nodeType?: string;
+    text?: string;
+    canonicalText?: string;
+    content?: string;
+    contentHash?: string;
+    title?: string;
+    subtype?: string;
+    status?: string;
+    confidence?: number | null;
+    topicId?: string;
+    projectId?: string;
+    sourceType?: string;
+    tags?: string[];
+    verificationStatus?: string;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+};
+export type PlatformGraphEdge = {
+    edgeId?: string;
+    globalId?: string;
+    fromNodeId?: string;
+    toNodeId?: string;
+    fromGlobalId?: string;
+    toGlobalId?: string;
+    sourceGlobalId?: string;
+    targetGlobalId?: string;
+    edgeType?: string;
+    topicId?: string;
+    projectId?: string;
+    confidence?: number;
+    weight?: number;
+    context?: string;
+    derivationType?: string;
+    createdAt?: number;
+    updatedAt?: number;
+};
+export type QueryNodesResponse = PlatformGraphNode | PlatformGraphNode[] | null;
+export type CreateNodeResponse = PlatformGraphNode;
+export type UpdateNodeResponse = PlatformGraphNode;
+export type QueryEdgesResponse = PlatformGraphEdge | PlatformGraphEdge[] | null;
+export type CreateEdgeResponse = PlatformGraphEdge;
+export type DeleteEdgeCountResponse = {
+    removed?: number;
+    deleted?: number;
+};
+export type DeleteEdgeResponse = PlatformGraphEdge | PlatformGraphEdge[] | DeleteEdgeCountResponse | null;
+export type GraphNeighborhoodResponse = {
+    nodes?: PlatformGraphNode[];
+    edges?: PlatformGraphEdge[];
+    rootGlobalIds?: string[];
+    maxDepth?: number;
+};
+export type GraphPathResponse = {
+    fromGlobalId: string;
+    toGlobalId: string;
+    maxDepth: number;
+    directEdges: PlatformGraphEdge[];
+    connectedGraph: GraphNeighborhoodResponse;
+};
+export type GraphAnalyticsMetric = "graph_stats" | "contradiction_tension" | "confirmation_bias" | "reasoning_depth" | "knowledge_frontier";
+export type GraphAnalyticsResponse<Metric extends GraphAnalyticsMetric = GraphAnalyticsMetric> = {
+    metric: Metric;
+    payload: JsonValue;
+};
+export type WorkflowBranchRecord = {
+    branchId?: string;
+    topicId?: string;
+    projectId?: string;
+    name?: string;
+    description?: string;
+    status?: string;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+} & Partial<DeprecatedBranchMetadata>;
+export type WorkflowWorktreeRecord = {
+    worktreeId?: string;
+    topicId?: string;
+    projectId?: string;
+    branchId?: string;
+    title?: string;
+    status?: string;
+    hypothesis?: string;
+    questionCount?: number;
+    taskCount?: number;
+    autoShapeApplied?: boolean;
+    frameworkSuggestions?: JsonValue[];
+    dependencySuggestions?: JsonValue[];
+    gate?: string;
+    track?: string;
+    trackPosition?: number;
+    executionBand?: number;
+    executionOrder?: number;
+    dependsOn?: string[];
+    blocks?: string[];
+    proofArtifacts?: WorkflowProofArtifact[];
+    staffingHint?: WorkflowStaffingHint | string;
+    lastReconciledAt?: number;
+    autoFixPolicy?: WorkflowAutoFixPolicy;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+};
+export type ListBranchesResponse = ListResult<WorkflowBranchRecord, "branches">;
+export type CreateBranchResponse = WorkflowBranchRecord;
+export type WorkflowLensRecord = {
+    lensId?: string;
+    workspaceId?: string;
+    topicId?: string;
+    projectId?: string;
+    name?: string;
+    description?: string;
+    perspectiveType?: LensPerspectiveType;
+    status?: LensStatus;
+    isAppliedToTopic?: boolean;
+    promptTemplates?: LensPromptTemplateReference[];
+    workflowTemplates?: LensWorkflowTemplate[];
+    taskTemplates?: LensTaskTemplate[];
+    filterCriteria?: JsonValue;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+};
+export type WorkflowLensBindingRecord = {
+    bindingId?: string;
+    lensId?: string;
+    workspaceId?: string;
+    topicId?: string;
+    projectId?: string;
+    status?: string;
+    appliedAt?: number;
+    removedAt?: number;
+    updatedAt?: number;
+    metadata?: JsonObject | null;
+};
+export type ListLensesResponse = ListResult<WorkflowLensRecord, "lenses">;
+export type CreateLensResponse = WorkflowLensRecord;
+export type LensTopicBindingResponse = WorkflowLensBindingRecord;
+export type ListWorktreesResponse = ListResult<WorkflowWorktreeRecord, "worktrees"> & {
+    tracks?: Record<string, number>;
+    bands?: Record<string, number>;
+};
+export type AddWorktreeResponse = WorkflowWorktreeRecord;
+export type MergeWorktreeResponse = {
+    worktreeId?: string;
+    status?: string;
+    outcome?: string;
+    beliefsScored?: number;
+    summary?: string;
+    mergedAt?: number;
+};
+export type OpenPullRequestResponse = {
+    pullRequestId?: string;
+    worktreeId?: string;
+    status?: string;
+    summary?: string;
+    reviewers?: string[];
+    createdAt?: number;
+};
+export type PushWorktreeResponse = {
+    pushId?: string;
+    pushedCount?: number;
+    targetContext?: string;
+    status?: string;
+    createdAt?: number;
+};
+export type WorkflowTopicRecord = {
+    topicId: string;
+    projectId?: string;
+    name: string;
+    type?: string;
+    isOwner?: boolean;
+    tenantId?: string;
+    workspaceId?: string;
+};
+export type ListTopicsResponse = ListResult<WorkflowTopicRecord, "topics">;
+export type SwitchTopicContextResponse = {
+    topicId: string;
+    topicName: string;
+    switched: boolean;
+    briefing: JsonValue | null;
+    projectId?: string;
+    projectName?: string;
+};
+/**
+ * @deprecated Use WorkflowTopicRecord.
+ */
+export type WorkflowProjectRecord = WorkflowTopicRecord;
+/**
+ * @deprecated Use ListTopicsResponse.
+ */
+export type ListProjectsResponse = ListTopicsResponse;
+/**
+ * @deprecated Use SwitchTopicContextResponse.
+ */
+export type SwitchProjectContextResponse = SwitchTopicContextResponse;
+export type TopicRecord = {
+    topicId?: string;
+    projectId?: string;
+    id?: string;
+    globalId?: string;
+    name?: string;
+    description?: string;
+    type?: string;
+    depth?: number;
+    status?: string;
+    parentTopicId?: string | null;
+    tenantId?: string;
+    workspaceId?: string;
+    visibility?: string;
+    createdAt?: number;
+    updatedAt?: number;
+};
+export type TopicListResponse = ListResult<TopicRecord, "topics">;
+export type TopicTreeNode = TopicRecord & {
+    path?: string[];
+};
+export type TopicTreeResponse = {
+    tree: TopicTreeNode[];
+};
+export type TopicCoverageRecord = {
+    topicId: string;
+    name: string;
+    type: string;
+    depth: number;
+    beliefs: number;
+    questions: number;
+    evidence: number;
+    coverage: "full" | "partial" | "empty";
+};
+export type TopicCoverageSummary = {
+    totalTopics: number;
+    coveredTopics: number;
+    emptyTopics: number;
+    coveragePercent: number;
+    totalBeliefs: number;
+    totalQuestions: number;
+    totalEvidence: number;
+};
+export type TopicCoverageResponse = {
+    topics: TopicCoverageRecord[];
+    summary: TopicCoverageSummary;
+    scopeTopicId?: string | null;
+};
+export type CreateTaskResponse = {
+    taskId: string;
+    status: string;
+    createdAt: number;
+    linkedWorktreeId?: string;
+    linkedQuestionId?: string;
+    linkedBeliefId?: string;
+};
+export type CompleteTaskResponse = {
+    taskId: string;
+    completedAt: number;
+    outputSummary: string;
+    status?: string;
+};
+export type UpdateTaskResponse = {
+    taskId: string;
+    updatedAt: number;
+    status?: string;
+    title?: string;
+};
+export type JudgmentRecord = {
+    _id?: string;
+    judgmentId?: string;
+    globalId?: string;
+    summary?: string;
+    title?: string;
+    rationale?: string;
+    decisionType?: string;
+    judgmentType?: string;
+    decisionConfidence?: number;
+    confidence?: number;
+    outcome?: string;
+    status?: string;
+    topicId?: string;
+    projectId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    dealId?: string;
+    companyId?: string;
+    amount?: number;
+    valuation?: number;
+    terms?: string;
+    keyUncertainties?: string[];
+    alternativesConsidered?: string[];
+    decisionMakers?: string[];
+    themeIds?: string[];
+};
+export type ListJudgmentsResponse = ListResult<JudgmentRecord, "judgments">;
+export type GetJudgmentResponse = JudgmentRecord | null;
+export type RecordJudgmentResponse = {
+    nodeId?: string;
+    judgmentId?: string;
+    globalId?: string;
+    status?: string;
+    createdAt?: number;
+    knowledgeHorizon?: {
+        beliefCount?: number;
+        openQuestionCount?: number;
+        contradictionCount?: number;
+    };
+};
+export type RecordJudgmentOutcomeResponse = {
+    success?: boolean;
+    judgmentId?: string;
+    outcome?: string;
+    updatedAt?: number;
+};
+export type JudgmentReadinessResponse = {
+    ready?: boolean;
+    beliefCount?: number;
+    questionCoverage?: number;
+    avgConfidence?: number;
+    evidencePerBelief?: number;
+    unresolvedContradictions?: number;
+    blockers?: string[];
+    recommendation?: string;
+};
+export type JudgmentCalibrationBucket = {
+    total?: number;
+    successful?: number;
+};
+export type JudgmentCalibrationResponse = {
+    totalDecisions?: number;
+    decisionsWithOutcomes?: number;
+    calibration?: {
+        calibrationScore?: number;
+        overconfident?: boolean;
+        underconfident?: boolean;
+    } | null;
+    byType?: Record<string, JudgmentCalibrationBucket>;
+};
+export type PendingJudgmentOutcomeRecord = {
+    _id?: string;
+    globalId?: string;
+    summary?: string;
+    title?: string;
+    decisionType?: string;
+    decisionConfidence?: number | null;
+    decisionDate?: number;
+    dealId?: string;
+    companyId?: string;
+    outcome?: string;
+    status?: string;
+};
+export type PendingJudgmentOutcomeReviewResponse = ListResult<PendingJudgmentOutcomeRecord, "reviews">;
+export type JudgmentTransitionAuditIntegrityIssue = {
+    code?: string;
+    severity?: "error" | "warning" | string;
+    message?: string;
+};
+export type JudgmentTransitionAuditIntegrityCheck = {
+    decisionNodeId?: string;
+    globalId?: string;
+    status?: string;
+    outcome?: string;
+    auditEventCount?: number;
+    issues?: JudgmentTransitionAuditIntegrityIssue[];
+};
+export type JudgmentTransitionAuditIntegrityResponse = {
+    topicId?: string;
+    projectId?: string;
+    checkedDecisionCount?: number;
+    failingDecisionCount?: number;
+    passed?: boolean;
+    issueTypeBreakdown?: Record<string, number>;
+    checks?: JudgmentTransitionAuditIntegrityCheck[];
+};
+export type ReportTemplateRecord = {
+    templateId?: string;
+    slug?: string;
+    name?: string;
+    version?: string;
+    description?: string;
+    status?: string;
+};
+export type ReportTemplatesResponse = ListResult<ReportTemplateRecord, "templates"> | ReportTemplateRecord | null;
+export type ProjectReportRecord = {
+    reportId?: string;
+    topicId?: string;
+    projectId?: string;
+    title?: string;
+    status?: string;
+    slug?: string;
+    summary?: string;
+    createdAt?: number;
+    updatedAt?: number;
+};
+export type ProjectReportsResponse = ListResult<ProjectReportRecord, "reports">;
+export type ReportSectionRecord = {
+    sectionId?: string;
+    slug?: string;
+    title?: string;
+    heading?: string;
+    body?: string;
+    content?: string;
+    order?: number;
+    metadata?: JsonObject | null;
+};
+export type ReportWithSectionsResponse = {
+    reportId?: string;
+    topicId?: string;
+    projectId?: string;
+    title?: string;
+    status?: string;
+    summary?: string;
+    sections?: ReportSectionRecord[];
+};

package/dist/packages/sdk/src/version.d.ts

@@ -0,0 +1,2 @@
+/** Current SDK package version. */
+export declare const LUCERN_SDK_VERSION = "0.2.0-alpha.1";