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

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

@@ -1,118 +0,0 @@
-import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, resolveTopicId, withTopicAlias, } from "./sdkSurface.js";
-function asRecord(value) {
-    return value && typeof value === "object"
-        ? value
-        : {};
-}
-function cleanString(value) {
-    return typeof value === "string" && value.trim().length > 0
-        ? value.trim()
-        : undefined;
-}
-function normalizeTopicRecord(value) {
-    const record = asRecord(value);
-    const topicId = cleanString(record.topicId) ??
-        cleanString(record.id) ??
-        cleanString(record._id);
-    return withTopicAlias({
-        ...record,
-        ...(topicId ? { topicId } : {}),
-    });
-}
-function normalizeTopicTreeNode(value) {
-    return normalizeTopicRecord(value);
-}
-/**
- * Create the topics client for managing hierarchical knowledge containers.
- *
- * @param config - Gateway transport configuration.
- * @returns An object with `list`, `get`, `create`, `update`, `getTree`, and `getCoverage` methods.
- */
-export function createTopicsClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    return {
-        async list(query = {}) {
-            const topicId = resolveTopicId(query);
-            return gateway.request({
-                path: `/api/platform/v1/topics${toQueryString({
-                    ...(topicId ? { topicId } : {}),
-                    ontologyId: query.ontologyId,
-                    parentTopicId: query.parentTopicId,
-                    status: query.status,
-                    type: query.type,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
-                const record = asRecord(data);
-                const items = Array.isArray(record.topics)
-                    ? record.topics.map(normalizeTopicRecord)
-                    : [];
-                return {
-                    ...createListResult(items, "topics"),
-                    ...record,
-                    topics: items,
-                    total: typeof record.total === "number" ? record.total : items.length,
-                };
-            }));
-        },
-        async get(topicId) {
-            return gateway.request({
-                path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`,
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(asRecord(data).topic ?? data)));
-        },
-        async create(input, idempotencyKey) {
-            const topicId = resolveTopicId(input);
-            return gateway.request({
-                path: "/api/platform/v1/topics",
-                method: "POST",
-                body: {
-                    ...input,
-                    ...(topicId ? { topicId } : {}),
-                    type: input.type ?? "theme",
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
-        },
-        async update(topicId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
-        },
-        async getTree(topicId, query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/tree${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => {
-                const record = asRecord(data);
-                return {
-                    tree: Array.isArray(record.tree)
-                        ? record.tree.map(normalizeTopicTreeNode)
-                        : [],
-                };
-            }));
-        },
-        async getCoverage(topicId, query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/coverage${toQueryString(query)}`,
-            });
-        },
-        async remove(topicId, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/topics/remove",
-                method: "POST",
-                body: { id: topicId },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        async bulkCreate(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/topics/bulk",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-    };
-}

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";

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

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

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

@@ -1,366 +0,0 @@
-import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { asListItems, createListResult, mapAliasedList, mapGatewayData, normalizeTopicQuery, resolveTopicId, withTopicAlias, } from "./sdkSurface.js";
-export { LucernApiError };
-function normalizeLensQuery(value) {
-    const topicId = resolveTopicId(value);
-    return {
-        ...value,
-        ...(topicId ? { topicId } : {}),
-    };
-}
-/**
- * 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.
- */
-export function createWorkflowClient(config = {}) {
-    const gateway = createGatewayRequestClient(config);
-    const client = {
-        /**
-         * List workflow branches for a topic scope.
-         */
-        async listBranches(query) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/branches${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "branches")));
-        },
-        /**
-         * Create a workflow branch.
-         */
-        async createBranch(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/workflow/branches",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * List reusable lenses for a workspace or topic scope.
-         */
-        async listLenses(query) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/lenses${toQueryString(normalizeLensQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "lenses")));
-        },
-        /**
-         * Create a reusable workflow lens.
-         */
-        async createLens(input, idempotencyKey) {
-            const payload = normalizeLensQuery(input);
-            return gateway.request({
-                path: "/api/platform/v1/workflow/lenses",
-                method: "POST",
-                body: payload,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * Apply an existing lens to a topic.
-         */
-        async applyLensToTopic(input, idempotencyKey) {
-            const payload = normalizeLensQuery(input);
-            return gateway.request({
-                path: "/api/platform/v1/workflow/lens-bindings",
-                method: "POST",
-                body: payload,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * Remove an applied lens from a topic.
-         */
-        async removeLensFromTopic(input, idempotencyKey) {
-            const topicId = resolveTopicId(input);
-            if (!topicId) {
-                throw new LucernApiError({
-                    code: "INVALID_REQUEST",
-                    message: "topicId is required",
-                    status: 400,
-                });
-            }
-            return gateway.request({
-                path: `/api/platform/v1/workflow/lens-bindings${toQueryString({
-                    lensId: input.lensId,
-                    topicId,
-                })}`,
-                method: "DELETE",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * List worktrees for a topic scope.
-         */
-        async listWorktrees(query) {
-            const normalized = normalizeTopicQuery(query);
-            return gateway.request({
-                path: `/api/platform/v1/worktrees${toQueryString({
-                    ...normalized,
-                    track: query.track,
-                    executionBand: query.executionBand,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => mapAliasedList(data, "worktrees")));
-        },
-        /**
-         * List all worktrees across accessible topics.
-         */
-        async listAllWorktrees(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/worktrees${toQueryString({
-                    status: query.status,
-                    track: query.track,
-                    executionBand: query.executionBand,
-                    limit: query.limit,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
-                const record = data && typeof data === "object" && !Array.isArray(data)
-                    ? data
-                    : {};
-                const list = mapAliasedList(data, "worktrees");
-                return {
-                    ...list,
-                    ...(record.tracks &&
-                        typeof record.tracks === "object" &&
-                        !Array.isArray(record.tracks)
-                        ? { tracks: record.tracks }
-                        : {}),
-                    ...(record.bands &&
-                        typeof record.bands === "object" &&
-                        !Array.isArray(record.bands)
-                        ? { bands: record.bands }
-                        : {}),
-                };
-            }));
-        },
-        /**
-         * Create a workflow worktree.
-         */
-        async createWorktree(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * @deprecated Use createWorktree.
-         */
-        async addWorktree(input, idempotencyKey) {
-            return client.createWorktree(input, idempotencyKey);
-        },
-        /**
-         * Merge a worktree into the main belief line.
-         */
-        async merge(worktreeId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/merge`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Activate a planning worktree.
-         */
-        async activateWorktree(worktreeId, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/activate`,
-                method: "POST",
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * Update targeted beliefs/questions for a worktree.
-         */
-        async updateWorktreeTargets(input, idempotencyKey) {
-            const { worktreeId, ...body } = input;
-            return gateway.request({
-                path: `/api/platform/v1/worktrees/${encodeURIComponent(worktreeId)}/targets`,
-                method: "POST",
-                body,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * Mark a worktree record complete.
-         */
-        async completeWorktree(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees/complete",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Advance a worktree to its next lifecycle phase.
-         */
-        async advanceWorktreePhase(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees/advance-phase",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Force a worktree into a specific lifecycle phase.
-         */
-        async setWorktreePhase(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees/set-phase",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Patch opaque worktree state for orchestration flows.
-         */
-        async patchWorktreeState(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees/patch-state",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Batch create worktree records.
-         */
-        async bulkCreateWorktrees(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/worktrees/bulk",
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Open a pull request for a worktree.
-         */
-        async openPullRequest(worktreeId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/worktrees/${encodeURIComponent(worktreeId)}/pull-request`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Push scored worktree findings into another context.
-         */
-        async push(worktreeId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/worktrees/${encodeURIComponent(worktreeId)}/push`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * List accessible topic contexts.
-         */
-        async listTopics(query = {}) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/topics${toQueryString({
-                    includeShared: typeof query.includeShared === "boolean"
-                        ? query.includeShared
-                            ? "true"
-                            : "false"
-                        : undefined,
-                    limit: query.limit,
-                })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
-                const items = asListItems(data, "topics").map((item) => withTopicAlias(item));
-                const record = data && typeof data === "object"
-                    ? data
-                    : {};
-                return {
-                    ...record,
-                    ...createListResult(items, "topics"),
-                    total: typeof record.total === "number" ? record.total : items.length,
-                };
-            }));
-        },
-        /**
-         * Switch the active context by topic or project name.
-         */
-        async switchTopicContext(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/workflow/topics/switch",
-                method: "POST",
-                body: {
-                    targetTopicName: input.targetTopicName,
-                },
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => withTopicAlias(data)));
-        },
-        /**
-         * Create a workflow task.
-         */
-        async createTask(input, idempotencyKey) {
-            return gateway.request({
-                path: "/api/platform/v1/workflow/tasks",
-                method: "POST",
-                body: normalizeTopicQuery(input),
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Complete a workflow task.
-         */
-        async completeTask(taskId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/tasks/${encodeURIComponent(taskId)}/complete`,
-                method: "POST",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * Update a workflow task.
-         */
-        async updateTask(taskId, input, idempotencyKey) {
-            return gateway.request({
-                path: `/api/platform/v1/workflow/tasks/${encodeURIComponent(taskId)}`,
-                method: "PATCH",
-                body: input,
-                idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            });
-        },
-        /**
-         * @deprecated Use createBranch.
-         */
-        async createPillar(input, idempotencyKey) {
-            return client.createBranch(input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use addWorktree.
-         */
-        async createSprint(input, idempotencyKey) {
-            return client.createWorktree(input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use merge.
-         */
-        async completeSprint(worktreeId, input, idempotencyKey) {
-            return client.merge(worktreeId, input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use openPullRequest.
-         */
-        async requestReview(worktreeId, input, idempotencyKey) {
-            return client.openPullRequest(worktreeId, input, idempotencyKey);
-        },
-        /**
-         * @deprecated Use push.
-         */
-        async publishFindings(worktreeId, input, idempotencyKey) {
-            return client.push(worktreeId, input, idempotencyKey);
-        },
-    };
-    return client;
-}

package/dist/lucern/contracts/src/api-enums.contract.d.ts

@@ -1,58 +0,0 @@
-/**
- * API Enum Contract Definitions
- *
- * Canonical enum values for all API-facing enumerations.
- * These are co-equal with MCP contracts as external contracts.
- * SDK types are DERIVED from these — not independently authored.
- *
- * CONTRACT SURFACE: Adding a new enum value is additive (non-breaking).
- * Removing or renaming an existing value is a BREAKING CHANGE.
- */
-/** Fork reasons — why a scored belief was branched */
-export declare const FORK_REASONS: readonly ["refinement", "contradiction_response", "scope_change", "confidence_collapse", "manual"];
-export type ForkReason = (typeof FORK_REASONS)[number];
-/** Confidence modulation triggers — what caused a confidence change */
-export declare const CONFIDENCE_TRIGGERS: readonly ["evidence_added", "contradiction_detected", "merge_outcome", "manual", "decay"];
-export type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];
-/** Belief status — lifecycle state */
-export declare const BELIEF_STATUSES: readonly ["unscored", "scored", "archived"];
-export type BeliefStatus = (typeof BELIEF_STATUSES)[number];
-/** Reasoning methods — how an edge relationship was determined */
-export declare const REASONING_METHODS: readonly ["deductive", "inductive", "abductive", "analogical", "empirical"];
-export type ReasoningMethod = (typeof REASONING_METHODS)[number];
-/** Defeat types (Pollock taxonomy) — how a contradiction operates */
-export declare const DEFEAT_TYPES: readonly ["rebuts", "undercuts", "undermines"];
-export type DefeatType = (typeof DEFEAT_TYPES)[number];
-/** Contradiction severity levels */
-export declare const CONTRADICTION_SEVERITIES: readonly ["low", "medium", "high", "critical"];
-export type ContradictionSeverity = (typeof CONTRADICTION_SEVERITIES)[number];
-/** Contradiction resolution status */
-export declare const CONTRADICTION_STATUSES: readonly ["unresolved", "resolved", "accepted"];
-export type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];
-/** Merge outcome types — how a worktree merge resolved */
-export declare const MERGE_OUTCOMES: readonly ["validated", "invalidated", "forked", "inconclusive"];
-export type MergeOutcome = (typeof MERGE_OUTCOMES)[number];
-/** Worktree phases — investigation lifecycle within a checked-out worktree */
-export declare const WORKTREE_PHASES: readonly ["hypothesis", "investigation", "evaluation", "resolution"];
-export type WorktreePhase = (typeof WORKTREE_PHASES)[number];
-/** Branch status — thematic branch lifecycle */
-export declare const BRANCH_STATUSES: readonly ["dormant", "active", "archived"];
-export type BranchStatus = (typeof BRANCH_STATUSES)[number];
-/** Pull request status — review lifecycle before merge */
-export declare const PULL_REQUEST_STATUSES: readonly ["pending_review", "changes_requested", "approved", "blocked"];
-export type PullRequestStatus = (typeof PULL_REQUEST_STATUSES)[number];
-/** Epistemic layers — the hierarchy of knowledge */
-export declare const EPISTEMIC_LAYERS: readonly ["L1", "L2", "L3", "L4"];
-export type EpistemicLayer = (typeof EPISTEMIC_LAYERS)[number];
-/**
- * Judgment type — classification of the determination.
- *
- * Phase 1: These are new enum values for the Judgment (L4) vocabulary.
- * The existing code uses "Decision" — these are the forward-looking terms
- * that will eventually replace the Decision vocabulary (Phase 2-3).
- */
-export declare const JUDGMENT_TYPES: readonly ["investment_thesis", "thesis_maturity", "contradiction_ruling", "scope_determination", "confidence_ruling"];
-export type JudgmentType = (typeof JUDGMENT_TYPES)[number];
-/** Core edge types used in the Integration Surfaces */
-export declare const INTEGRATION_EDGE_TYPES: readonly ["informs", "grounds", "answers", "contradicts", "supports", "depends_on", "derived_from", "contains", "supersedes", "tests"];
-export type IntegrationEdgeType = (typeof INTEGRATION_EDGE_TYPES)[number];