@lucern/sdk 0.2.0-alpha.5 → 0.2.0-alpha.7

package/dist/lib/platform/sdk/types.d.ts

@@ -1,692 +0,0 @@
-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 = {
-    [key: string]: JsonValue | undefined;
-};
-/** JSON-safe array whose elements are recursively JSON-serializable. */
-export type JsonArray = JsonValue[];
-/**
- * Union of all JSON-safe primitive and composite types.
- *
- * Used throughout the SDK for metadata, details, and other
- * schemaless payloads that must survive JSON round-tripping.
- */
-export type JsonValue = null | boolean | number | string | JsonArray | JsonObject;
-/**
- * Canonical scope identifiers for SDK inputs and records.
- */
-export type TopicIdentifierInput = {
-    topicId?: 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[];
-};
-/**
- * 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.
- */
-export type PlatformBeliefRecord = {
-    nodeId: string;
-    globalId?: string;
-    text?: string;
-    canonicalText?: string;
-    formulation?: string;
-    status?: string;
-    confidence?: number | null;
-    topicId?: 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;
-};
-/** 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. */
-export interface ForkBeliefResponse extends PlatformBeliefRecord {
-    parentNodeId?: string;
-    forkReason?: string;
-}
-/**
- * Generic graph node spanning L1-L4 epistemic layers.
- *
- * Nodes include beliefs (L3), evidence (L2), sources (L1), and judgments (L4).
- * 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;
-    canonicalText?: string;
-    content?: string;
-    contentHash?: string;
-    title?: string;
-    subtype?: string;
-    status?: string;
-    confidence?: number | null;
-    topicId?: string;
-    sourceType?: string;
-    tags?: string[];
-    verificationStatus?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-};
-/**
- * Directed edge between two graph nodes.
- *
- * Weight indicates support strength: -1.0 (contradicts) to +1.0 (strongly supports).
- * 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 = {
-    edgeId?: string;
-    globalId?: string;
-    fromNodeId?: string;
-    toNodeId?: string;
-    fromGlobalId?: string;
-    toGlobalId?: string;
-    sourceGlobalId?: string;
-    targetGlobalId?: string;
-    edgeType?: string;
-    topicId?: string;
-    confidence?: number;
-    weight?: number;
-    context?: string;
-    derivationType?: string;
-    createdAt?: number;
-    updatedAt?: 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[];
-    isPlatformAdmin: boolean;
-    isTenantAdmin: boolean;
-    isWorkspaceAdmin: boolean;
-    authMode?: string;
-    sessionId?: string;
-    delegatedBy?: string;
-    expiresAt?: number;
-};
-/** Evidence node record returned by evidence lifecycle APIs. */
-export type PlatformEvidenceRecord = {
-    nodeId?: string;
-    evidenceId?: 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;
-    tags?: string[];
-    createdAt?: number;
-    updatedAt?: number;
-    createdBy?: string;
-};
-/** Question node record returned by question lifecycle APIs. */
-export type PlatformQuestionRecord = {
-    nodeId?: string;
-    questionId?: string;
-    globalId?: string;
-    topicId?: string;
-    text?: 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;
-};
-/** Answer record returned by answer/question APIs. */
-export type PlatformAnswerRecord = {
-    nodeId?: string | null;
-    answerId?: string | null;
-    globalId?: string | null;
-    questionNodeId?: string | null;
-    answerText?: string | null;
-    confidence?: string | null;
-    versionNumber?: number;
-    isLatest?: boolean;
-    evidenceCount?: number;
-    answeredBy?: string;
-    answerSource?: string;
-    status?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-};
-/** Contract record returned by contract APIs. */
-export type PlatformContract = {
-    contractId?: string;
-    beliefId?: string;
-    beliefNodeId?: string;
-    title?: string;
-    description?: string;
-    status?: string;
-    conditionType?: string;
-    direction?: string;
-    condition?: JsonValue;
-    deadline?: number;
-    compositeOf?: string[];
-    compositeOperator?: string;
-    modulation?: JsonValue;
-    evaluationSchedule?: string;
-    periodicIntervalMs?: number;
-    createdAt?: number;
-    updatedAt?: number;
-    metadata?: JsonObject | null;
-};
-/** Evaluation result for an epistemic contract. */
-export type PlatformContractEvaluation = {
-    contractId?: string;
-    beliefId?: string;
-    beliefNodeId?: string;
-    status?: string;
-    evaluationStatus?: string;
-    satisfied?: boolean;
-    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. */
-export type CreateNodeResponse = PlatformGraphNode;
-/** Response returned after updating an existing graph node. */
-export type UpdateNodeResponse = PlatformGraphNode;
-/** Response from a graph edge query. May be a single edge, an array, or null if not found. */
-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;
-    deleted?: 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[];
-    edges?: PlatformGraphEdge[];
-    rootGlobalIds?: string[];
-    maxDepth?: number;
-};
-/** Path traversal result between two graph nodes, including direct edges and the connected subgraph. */
-export type GraphPathResponse = {
-    fromGlobalId: string;
-    toGlobalId: string;
-    maxDepth: number;
-    directEdges: PlatformGraphEdge[];
-    connectedGraph: GraphNeighborhoodResponse;
-};
-/** 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> = {
-    metric: Metric;
-    payload: JsonValue;
-};
-/** A thematic branch within a topic. Worktrees are checked out from branches. */
-export type WorkflowBranchRecord = {
-    branchId?: string;
-    topicId?: string;
-    name?: string;
-    description?: string;
-    status?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-    createdBy?: string;
-} & Partial<DeprecatedBranchMetadata>;
-/**
- * Isolated investigation scope within a branch.
- *
- * Worktrees track hypotheses, dependencies, proof artifacts, and execution sequencing.
- * 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;
-    topicId?: string;
-    branchId?: string;
-    title?: string;
-    status?: string;
-    phase?: 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;
-};
-/** Paginated list of workflow branches. */
-export type ListBranchesResponse = ListResult<WorkflowBranchRecord, "branches">;
-/** Response returned after creating a new workflow branch. */
-export type CreateBranchResponse = WorkflowBranchRecord;
-/**
- * Reusable analytical perspective with prompt templates, workflow templates, and task templates.
- *
- * 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 = {
-    lensId?: string;
-    workspaceId?: string;
-    topicId?: 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;
-};
-/** Record of a lens being applied to (or removed from) a topic. */
-export type WorkflowLensBindingRecord = {
-    bindingId?: string;
-    lensId?: string;
-    workspaceId?: string;
-    topicId?: string;
-    status?: string;
-    appliedAt?: number;
-    removedAt?: number;
-    updatedAt?: number;
-    metadata?: JsonObject | null;
-};
-/** Paginated list of workflow lenses. */
-export type ListLensesResponse = ListResult<WorkflowLensRecord, "lenses">;
-/** Response returned after creating a new lens. */
-export type CreateLensResponse = WorkflowLensRecord;
-/** Response returned after binding or unbinding a lens to a topic. */
-export type LensTopicBindingResponse = WorkflowLensBindingRecord;
-/** Paginated list of worktrees with optional track and band summary counts. */
-export type ListWorktreesResponse = ListResult<WorkflowWorktreeRecord, "worktrees"> & {
-    tracks?: Record<string, number>;
-    bands?: Record<string, number>;
-};
-/** 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;
-    beliefsScored?: number;
-    summary?: string;
-    mergedAt?: number;
-};
-/** Response returned after opening a pull request for peer review of a worktree. */
-export type OpenPullRequestResponse = {
-    pullRequestId?: string;
-    worktreeId?: string;
-    status?: string;
-    summary?: string;
-    reviewers?: string[];
-    createdAt?: number;
-};
-/** Response returned after pushing scored beliefs from a merged worktree to a target context. */
-export type PushWorktreeResponse = {
-    pushId?: string;
-    pushedCount?: number;
-    targetContext?: string;
-    status?: string;
-    createdAt?: number;
-};
-/** Lightweight topic record used in workflow context (topic switching, listing). */
-export type WorkflowTopicRecord = {
-    topicId: string;
-    name: string;
-    type?: string;
-    isOwner?: boolean;
-    tenantId?: 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 = {
-    topicId: string;
-    topicName: string;
-    switched: boolean;
-    briefing: JsonValue | null;
-};
-/**
- * @deprecated Use WorkflowTopicRecord.
- */
-export type WorkflowProjectRecord = WorkflowTopicRecord;
-/**
- * @deprecated Use ListTopicsResponse.
- */
-export type ListProjectsResponse = ListTopicsResponse;
-/**
- * @deprecated Use SwitchTopicContextResponse.
- */
-export type SwitchProjectContextResponse = SwitchTopicContextResponse;
-/** Full topic record with hierarchy, visibility, and tenant/workspace scoping. */
-export type TopicRecord = {
-    topicId?: 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;
-};
-/** Paginated list of full topic records. */
-export type TopicListResponse = ListResult<TopicRecord, "topics">;
-/** Topic record extended with ancestry path for tree traversals. */
-export type TopicTreeNode = TopicRecord & {
-    path?: string[];
-};
-/** Response containing the full topic hierarchy from a given root. */
-export type TopicTreeResponse = {
-    tree: TopicTreeNode[];
-};
-/** Per-topic belief, question, and evidence counts for coverage analysis. */
-export type TopicCoverageRecord = {
-    topicId: string;
-    name: string;
-    type: string;
-    depth: number;
-    beliefs: number;
-    questions: number;
-    evidence: number;
-    coverage: "full" | "partial" | "empty";
-};
-/** Aggregate coverage statistics across the topic tree. */
-export type TopicCoverageSummary = {
-    totalTopics: number;
-    coveredTopics: number;
-    emptyTopics: number;
-    coveragePercent: number;
-    totalBeliefs: number;
-    totalQuestions: number;
-    totalEvidence: number;
-};
-/** Full coverage report with per-topic records and an aggregate summary. */
-export type TopicCoverageResponse = {
-    topics: TopicCoverageRecord[];
-    summary: TopicCoverageSummary;
-    scopeTopicId?: string | null;
-};
-/** Response returned after creating a new execution task. */
-export type CreateTaskResponse = {
-    taskId: string;
-    status: string;
-    createdAt: number;
-    linkedWorktreeId?: string;
-    linkedQuestionId?: string;
-    linkedBeliefId?: string;
-};
-/** Response returned after marking a task as complete. */
-export type CompleteTaskResponse = {
-    taskId: string;
-    completedAt: number;
-    outputSummary: string;
-    status?: string;
-};
-/** Response returned after updating a task's fields. */
-export type UpdateTaskResponse = {
-    taskId: string;
-    updatedAt: number;
-    status?: string;
-    title?: string;
-};
-/**
- * Irreversible commitment based on the current epistemic state.
- *
- * A judgment synthesizes beliefs, evidence, and uncertainties into a determination.
- * 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 = {
-    _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;
-    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;
-    createdAt?: number;
-    knowledgeHorizon?: {
-        beliefCount?: number;
-        openQuestionCount?: number;
-        contradictionCount?: number;
-    };
-};
-/** Response returned after recording the real-world outcome of a judgment. */
-export type RecordJudgmentOutcomeResponse = {
-    success?: boolean;
-    judgmentId?: string;
-    outcome?: string;
-    updatedAt?: number;
-};
-/** Assessment of whether the epistemic state is sufficient to issue a judgment. */
-export type JudgmentReadinessResponse = {
-    ready?: boolean;
-    beliefCount?: number;
-    questionCoverage?: number;
-    avgConfidence?: number;
-    evidencePerBelief?: number;
-    unresolvedContradictions?: number;
-    blockers?: string[];
-    recommendation?: string;
-};
-/** Calibration statistics for a single judgment type bucket. */
-export type JudgmentCalibrationBucket = {
-    total?: number;
-    successful?: number;
-};
-/** Calibration analysis comparing judgment confidence against real outcomes. */
-export type JudgmentCalibrationResponse = {
-    totalDecisions?: number;
-    decisionsWithOutcomes?: number;
-    calibration?: {
-        calibrationScore?: number;
-        overconfident?: boolean;
-        underconfident?: boolean;
-    } | null;
-    byType?: Record<string, JudgmentCalibrationBucket>;
-};
-/** A judgment that has been made but whose real-world outcome has not yet been recorded. */
-export type PendingJudgmentOutcomeRecord = {
-    _id?: string;
-    globalId?: string;
-    summary?: string;
-    title?: string;
-    decisionType?: string;
-    decisionConfidence?: number | null;
-    decisionDate?: number;
-    companyId?: string;
-    outcome?: string;
-    status?: 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 = {
-    code?: string;
-    severity?: "error" | "warning" | string;
-    message?: string;
-};
-/** Integrity check result for a single judgment's transition audit trail. */
-export type JudgmentTransitionAuditIntegrityCheck = {
-    decisionNodeId?: string;
-    globalId?: string;
-    status?: string;
-    outcome?: string;
-    auditEventCount?: number;
-    issues?: JudgmentTransitionAuditIntegrityIssue[];
-};
-/** Full integrity report for all judgment transitions within a topic. */
-export type JudgmentTransitionAuditIntegrityResponse = {
-    topicId?: string;
-    checkedDecisionCount?: number;
-    failingDecisionCount?: number;
-    passed?: boolean;
-    issueTypeBreakdown?: Record<string, number>;
-    checks?: JudgmentTransitionAuditIntegrityCheck[];
-};
-/** A report template definition for generating structured reports. */
-export type ReportTemplateRecord = {
-    templateId?: string;
-    slug?: string;
-    name?: string;
-    version?: string;
-    description?: string;
-    status?: 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 = {
-    reportId?: string;
-    topicId?: string;
-    title?: string;
-    status?: string;
-    slug?: string;
-    summary?: string;
-    createdAt?: number;
-    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;
-    body?: string;
-    content?: string;
-    order?: number;
-    metadata?: JsonObject | null;
-};
-/** A complete report including all its sections. */
-export type ReportWithSectionsResponse = {
-    reportId?: string;
-    topicId?: string;
-    title?: string;
-    status?: string;
-    summary?: string;
-    sections?: ReportSectionRecord[];
-};

package/dist/lib/platform/sdk/types.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/platform/sdk/version.d.ts

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