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

package/dist/version.js

@@ -0,0 +1,6 @@
+// src/version.ts
+var LUCERN_SDK_VERSION = "0.2.0-alpha.1";
+
+export { LUCERN_SDK_VERSION };
+//# sourceMappingURL=version.js.map
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"names":[],"mappings":";AACO,IAAM,kBAAA,GAAqB","file":"version.js","sourcesContent":["/** Current SDK package version. */\nexport const LUCERN_SDK_VERSION = \"0.2.0-alpha.1\";\n"]}

package/dist/workflowClient.d.ts

@@ -0,0 +1,316 @@
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+export { LucernApiError } from './coreClient.js';
+import { TopicIdentifierInput, JsonObject, ListResult, WorkflowBranchRecord, WorkflowLensRecord, WorkflowLensBindingRecord, WorkflowWorktreeRecord, ListWorktreesResponse, MergeWorktreeResponse, OpenPullRequestResponse, PushWorktreeResponse, ListTopicsResponse, SwitchTopicContextResponse, CreateTaskResponse, CompleteTaskResponse, UpdateTaskResponse } from './types.js';
+export { AddWorktreeResponse, CreateBranchResponse, CreateLensResponse, LensTopicBindingResponse, ListBranchesResponse, ListLensesResponse } from './types.js';
+import { LensPerspectiveType, LensStatus, LensPromptTemplateReference, LensWorkflowTemplate, LensTaskTemplate } from './contracts/lens-workflow.contract.js';
+import { WorkflowProofArtifact, WorkflowStaffingHint, WorkflowAutoFixPolicy } from './contracts/workflow-runtime.contract.js';
+import './contracts/lens-filter.contract.js';
+
+/** Configuration for the workflow client. */
+type WorkflowClientConfig = GatewayClientConfig;
+/** Lifecycle status of a workflow branch. */
+type WorkflowBranchStatus = "dormant" | "active" | "archived";
+/** Lifecycle status of a workflow lens. */
+type WorkflowLensStatus = LensStatus;
+/** Analytical perspective type for a lens overlay. */
+type WorkflowLensPerspectiveType = LensPerspectiveType;
+/** Lifecycle status of a workflow worktree. */
+type WorkflowWorktreeStatus = "planning" | "active" | "paused" | "completed" | "merged" | "failed" | "archived";
+/** Possible outcomes when merging worktree findings into the main belief line. */
+type WorkflowMergeOutcome = "validated" | "invalidated" | "forked" | "inconclusive";
+/** Input for creating a new workflow worktree. */
+type AddWorktreeInput = {
+    title: string;
+    topicId?: string;
+    branchId?: string;
+    objective?: string;
+    hypothesis?: string;
+    beliefIds?: string[];
+    autoShape?: boolean;
+    domainPackId?: string;
+    executionOrder?: number;
+    dependsOn?: string[];
+    blocks?: string[];
+    gate?: string;
+    proofArtifacts?: WorkflowProofArtifact[];
+    staffingHint?: WorkflowStaffingHint | string;
+    lastReconciledAt?: number;
+    autoFixPolicy?: WorkflowAutoFixPolicy;
+} & TopicIdentifierInput;
+/** Input for merging worktree findings with belief confidence outcomes. */
+type MergeInput = {
+    outcomes: Array<{
+        beliefId: string;
+        confidence: number;
+        rationale: string;
+    }>;
+    summary?: string;
+};
+/** Input for updating the beliefs and questions tracked by a worktree. */
+type UpdateWorktreeTargetsInput = {
+    worktreeId: string;
+    addBeliefIds?: string[];
+    addQuestionIds?: string[];
+    removeBeliefIds?: string[];
+    removeQuestionIds?: string[];
+};
+/** Input for marking a worktree complete with recorded outcomes. */
+type CompleteWorktreeInput = {
+    worktreeId: string;
+    keyFindings?: string[];
+    decisionsReached?: string[];
+    nextSteps?: string[];
+};
+/** Input for moving a worktree forward to its next phase. */
+type AdvanceWorktreePhaseInput = {
+    worktreeId: string;
+};
+/** Input for forcing a worktree into a specific phase. */
+type SetWorktreePhaseInput = {
+    worktreeId: string;
+    phase: string;
+};
+/** Input for patching arbitrary structured worktree state. */
+type PatchWorktreeStateInput = {
+    worktreeId: string;
+    patch: JsonObject;
+};
+/** Input for batch-creating worktrees through the workflow surface. */
+type BulkCreateWorktreesInput = {
+    worktrees: unknown[];
+};
+/** Input for listing accessible topic contexts. */
+type ListTopicsInput = {
+    includeShared?: boolean;
+    limit?: number;
+};
+/** Input for switching the active topic context by name. */
+type SwitchTopicContextInput = {
+    targetTopicName: string;
+};
+/** Input for creating a workflow task linked to a question or worktree. */
+type CreateTaskInput = {
+    title: string;
+    topicId?: string;
+    taskType?: "research" | "interview" | "analysis" | "data_collection";
+    linkedQuestionId?: string;
+    linkedWorktreeId?: string;
+    linkedBeliefId?: string;
+    description?: string;
+    priority?: "low" | "medium" | "high" | "urgent";
+} & TopicIdentifierInput;
+/** Input for marking a workflow task as completed with an output summary. */
+type CompleteTaskInput = {
+    outputSummary: string;
+    evidenceCreated?: boolean;
+};
+/** Input for partially updating an existing workflow task. */
+type UpdateTaskInput = {
+    title?: string;
+    description?: string;
+    linkedBeliefId?: string;
+    linkedQuestionId?: string;
+    linkedWorktreeId?: string;
+    priority?: "critical" | "high" | "medium" | "low";
+    status?: "todo" | "in_progress" | "blocked" | "done";
+};
+/**
+ * Create the workflow client for lenses, legacy branches, worktrees, context,
+ * and tasks.
+ * @param config - Gateway transport configuration.
+ * @returns An object with methods to manage branches, lenses, worktrees, topics, and tasks.
+ */
+declare function createWorkflowClient(config?: WorkflowClientConfig): {
+    /**
+     * List workflow branches for a topic scope.
+     */
+    listBranches(query: {
+        topicId?: string;
+        status?: WorkflowBranchStatus;
+        limit?: number;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowBranchRecord, "branches">>>;
+    /**
+     * Create a workflow branch.
+     */
+    createBranch(input: {
+        name: string;
+        topicId?: string;
+        description?: string;
+        metadata?: JsonObject;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
+    /**
+     * List reusable lenses for a workspace or topic scope.
+     */
+    listLenses(query: {
+        workspaceId?: string;
+        topicId?: string;
+        status?: WorkflowLensStatus;
+        perspectiveType?: WorkflowLensPerspectiveType;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowLensRecord, "lenses">>>;
+    /**
+     * Create a reusable workflow lens.
+     */
+    createLens(input: {
+        name: string;
+        workspaceId?: string;
+        topicId?: string;
+        description?: string;
+        perspectiveType: WorkflowLensPerspectiveType;
+        promptTemplates?: LensPromptTemplateReference[];
+        workflowTemplates?: LensWorkflowTemplate[];
+        taskTemplates?: LensTaskTemplate[];
+        filterCriteria?: JsonObject;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensRecord>>;
+    /**
+     * Apply an existing lens to a topic.
+     */
+    applyLensToTopic(input: {
+        lensId: string;
+        topicId?: string;
+        metadata?: JsonObject;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensBindingRecord>>;
+    /**
+     * Remove an applied lens from a topic.
+     */
+    removeLensFromTopic(input: {
+        lensId: string;
+        topicId?: string;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowLensBindingRecord>>;
+    /**
+     * List worktrees for a topic scope.
+     */
+    listWorktrees(query: {
+        topicId?: string;
+        branchId?: string;
+        status?: WorkflowWorktreeStatus;
+        track?: string;
+        executionBand?: number;
+        limit?: number;
+    } & TopicIdentifierInput): Promise<PlatformGatewaySuccess<ListResult<WorkflowWorktreeRecord, "worktrees">>>;
+    /**
+     * List all worktrees across accessible topics.
+     */
+    listAllWorktrees(query?: {
+        status?: WorkflowWorktreeStatus;
+        track?: string;
+        executionBand?: number;
+        limit?: number;
+    }): Promise<PlatformGatewaySuccess<ListWorktreesResponse>>;
+    /**
+     * Create a workflow worktree.
+     */
+    createWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * @deprecated Use createWorktree.
+     */
+    addWorktree(input: AddWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * Merge a worktree into the main belief line.
+     */
+    merge(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
+    /**
+     * Activate a planning worktree.
+     */
+    activateWorktree(worktreeId: string, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * Update targeted beliefs/questions for a worktree.
+     */
+    updateWorktreeTargets(input: UpdateWorktreeTargetsInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * Mark a worktree record complete.
+     */
+    completeWorktree(input: CompleteWorktreeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Advance a worktree to its next lifecycle phase.
+     */
+    advanceWorktreePhase(input: AdvanceWorktreePhaseInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Force a worktree into a specific lifecycle phase.
+     */
+    setWorktreePhase(input: SetWorktreePhaseInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Patch opaque worktree state for orchestration flows.
+     */
+    patchWorktreeState(input: PatchWorktreeStateInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Batch create worktree records.
+     */
+    bulkCreateWorktrees(input: BulkCreateWorktreesInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
+    /**
+     * Open a pull request for a worktree.
+     */
+    openPullRequest(worktreeId: string, input: {
+        summary: string;
+        reviewers?: string[];
+        status?: "pending_review" | "changes_requested" | "approved" | "blocked";
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
+    /**
+     * Push scored worktree findings into another context.
+     */
+    push(worktreeId: string, input: {
+        targetContext: string;
+        beliefIds?: string[];
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PushWorktreeResponse>>;
+    /**
+     * List accessible topic contexts.
+     */
+    listTopics(query?: ListTopicsInput): Promise<PlatformGatewaySuccess<ListTopicsResponse>>;
+    /**
+     * Switch the active context by topic or project name.
+     */
+    switchTopicContext(input: SwitchTopicContextInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<SwitchTopicContextResponse>>;
+    /**
+     * Create a workflow task.
+     */
+    createTask(input: CreateTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<CreateTaskResponse>>;
+    /**
+     * Complete a workflow task.
+     */
+    completeTask(taskId: string, input: CompleteTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<CompleteTaskResponse>>;
+    /**
+     * Update a workflow task.
+     */
+    updateTask(taskId: string, input: UpdateTaskInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<UpdateTaskResponse>>;
+    /**
+     * @deprecated Use createBranch.
+     */
+    createPillar(input: {
+        name: string;
+        topicId?: string;
+        description?: string;
+        metadata?: JsonObject;
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowBranchRecord>>;
+    /**
+     * @deprecated Use addWorktree.
+     */
+    createSprint(input: {
+        title: string;
+        topicId?: string;
+        branchId?: string;
+        hypothesis?: string;
+        beliefIds?: string[];
+    } & TopicIdentifierInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<WorkflowWorktreeRecord>>;
+    /**
+     * @deprecated Use merge.
+     */
+    completeSprint(worktreeId: string, input: MergeInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<MergeWorktreeResponse>>;
+    /**
+     * @deprecated Use openPullRequest.
+     */
+    requestReview(worktreeId: string, input: {
+        summary: string;
+        reviewers?: string[];
+        status?: "pending_review" | "changes_requested" | "approved" | "blocked";
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<OpenPullRequestResponse>>;
+    /**
+     * @deprecated Use push.
+     */
+    publishFindings(worktreeId: string, input: {
+        targetContext: string;
+        beliefIds?: string[];
+        metadata?: JsonObject;
+    }, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PushWorktreeResponse>>;
+};
+
+export { type AddWorktreeInput, type AdvanceWorktreePhaseInput, type BulkCreateWorktreesInput, type CompleteTaskInput, CompleteTaskResponse, type CompleteWorktreeInput, type CreateTaskInput, CreateTaskResponse, type ListTopicsInput, ListTopicsResponse, ListWorktreesResponse, type MergeInput, MergeWorktreeResponse, OpenPullRequestResponse, type PatchWorktreeStateInput, PlatformGatewaySuccess, PushWorktreeResponse, type SetWorktreePhaseInput, type SwitchTopicContextInput, SwitchTopicContextResponse, type UpdateTaskInput, UpdateTaskResponse, type UpdateWorktreeTargetsInput, type WorkflowBranchStatus, type WorkflowClientConfig, type WorkflowLensPerspectiveType, type WorkflowLensStatus, type WorkflowMergeOutcome, type WorkflowWorktreeStatus, createWorkflowClient };