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

package/dist/lucern/contracts/src/lens-workflow.contract.d.ts

@@ -1,84 +0,0 @@
-/**
- * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.
- */
-export type { LensFilterCriteria, TaxonomyFilterCriteriaV1, EntityTypeFilterV1, OntologyScope, FilterValidationResult, } from "./lens-filter.contract";
-export { validateFilterCriteria, isLensFilterCriteria, isTaxonomyFilterCriteriaV1, } from "./lens-filter.contract";
-export declare const LENS_PERSPECTIVE_TYPES: readonly ["investigation", "monitoring", "analysis", "comparison", "taxonomy"];
-export type LensPerspectiveType = (typeof LENS_PERSPECTIVE_TYPES)[number];
-export declare const LENS_STATUSES: readonly ["draft", "active", "archived"];
-export type LensStatus = (typeof LENS_STATUSES)[number];
-export declare const LENS_TASK_TEMPLATE_PRIORITIES: readonly ["critical", "high", "medium", "low"];
-export type LensTaskTemplatePriority = (typeof LENS_TASK_TEMPLATE_PRIORITIES)[number];
-export type LensLooseMetadata = Record<string, unknown>;
-export type LensPromptTemplateReference = {
-    key: string;
-    promptRef: string;
-    phase?: string;
-    role?: string;
-    version?: string;
-    required?: boolean;
-    metadata?: LensLooseMetadata;
-};
-export type LensWorkflowStepTemplate = {
-    key: string;
-    title: string;
-    description?: string;
-    promptTemplateKey?: string;
-    taskTemplateKeys?: string[];
-    metadata?: LensLooseMetadata;
-};
-export type LensWorkflowTemplate = {
-    key: string;
-    name: string;
-    description?: string;
-    steps: LensWorkflowStepTemplate[];
-    metadata?: LensLooseMetadata;
-};
-export type LensTaskTemplate = {
-    key: string;
-    title: string;
-    description?: string;
-    priority?: LensTaskTemplatePriority;
-    phase?: string;
-    metadata?: LensLooseMetadata;
-};
-export type LensQuestionTemplate = {
-    key: string;
-    text: string;
-    priority?: LensTaskTemplatePriority;
-    linkedBeliefKey?: string;
-    metadata?: LensLooseMetadata;
-};
-export type LensBranchMigrationSuggestion = {
-    recommendedTool: "create_lens";
-    perspectiveType: LensPerspectiveType;
-    message: string;
-    suggestedPayload: {
-        name: string;
-        description?: string;
-        topicId?: string;
-        workspaceId?: string;
-        perspectiveType: LensPerspectiveType;
-    };
-};
-export declare const BRANCH_DEPRECATION_MESSAGE = "Branches are deprecated for operational framing. Create a workspace-scoped lens instead.";
-export type DeprecatedBranchMetadata = {
-    deprecated: true;
-    deprecationMessage: string;
-    lensSuggestion: LensBranchMigrationSuggestion;
-};
-export declare function inferLensPerspectiveTypeFromBranchSchema(schema?: string | null): LensPerspectiveType;
-export declare function migrateBranchToLens(args: {
-    name: string;
-    description?: string;
-    topicId?: string;
-    workspaceId?: string;
-    schema?: string | null;
-}): LensBranchMigrationSuggestion;
-export declare function buildDeprecatedBranchMetadata(args: {
-    name: string;
-    description?: string;
-    topicId?: string;
-    workspaceId?: string;
-    schema?: string | null;
-}): DeprecatedBranchMetadata;

package/dist/lucern/contracts/src/lens-workflow.contract.js

@@ -1,54 +0,0 @@
-/**
- * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.
- */
-export { validateFilterCriteria, isLensFilterCriteria, isTaxonomyFilterCriteriaV1, } from "./lens-filter.contract.js";
-export const LENS_PERSPECTIVE_TYPES = [
-    "investigation",
-    "monitoring",
-    "analysis",
-    "comparison",
-    "taxonomy",
-];
-export const LENS_STATUSES = ["draft", "active", "archived"];
-export const LENS_TASK_TEMPLATE_PRIORITIES = [
-    "critical",
-    "high",
-    "medium",
-    "low",
-];
-export const BRANCH_DEPRECATION_MESSAGE = "Branches are deprecated for operational framing. Create a workspace-scoped lens instead.";
-export function inferLensPerspectiveTypeFromBranchSchema(schema) {
-    const normalized = schema?.trim().toLowerCase();
-    if (normalized === "phase") {
-        return "monitoring";
-    }
-    if (normalized === "axis" || normalized === "dimension") {
-        return "comparison";
-    }
-    if (normalized === "track") {
-        return "investigation";
-    }
-    return "analysis";
-}
-export function migrateBranchToLens(args) {
-    const perspectiveType = inferLensPerspectiveTypeFromBranchSchema(args.schema);
-    return {
-        recommendedTool: "create_lens",
-        perspectiveType,
-        message: "Branches are deprecated for operational framing. Create a workspace-scoped lens with the suggested payload instead.",
-        suggestedPayload: {
-            name: args.name,
-            description: args.description,
-            topicId: args.topicId,
-            workspaceId: args.workspaceId,
-            perspectiveType,
-        },
-    };
-}
-export function buildDeprecatedBranchMetadata(args) {
-    return {
-        deprecated: true,
-        deprecationMessage: BRANCH_DEPRECATION_MESSAGE,
-        lensSuggestion: migrateBranchToLens(args),
-    };
-}

package/dist/lucern/contracts/src/mcp-tools.contract.d.ts

@@ -1,151 +0,0 @@
-/**
- * MCP Tool Contract Definitions
- *
- * Machine-readable source of truth for all Lucern MCP tool names,
- * descriptions, parameters, and response schemas.
- *
- * CONTRACT SURFACE: These definitions are the external API for AI agents.
- * Renaming a tool or changing its description is a BREAKING CHANGE.
- *
- * Git-native naming rules (enforced by lint):
- *   1. Workflow tools use git verbs directly (add_worktree, merge, push, open_pull_request)
- *   2. Knowledge tools use epistemic verbs (create_belief, fork_belief, modulate_confidence)
- *   3. First sentence of description includes the git analog verb
- *   4. Description includes "Like `git X`" parenthetical
- *   5. Parameter names use domain terms (canonicalText, nodeId, confidence)
- */
-export type McpToolContract = {
-    /** Stable tool name — breaking change to rename */
-    name: string;
-    /** Git-semantic description — breaking change to remove git references */
-    description: string;
-    /** Parameter schema (JSON Schema subset) */
-    parameters: Record<string, McpParameterDef>;
-    /** Required parameter names */
-    required: string[];
-    /** Response shape description */
-    response: McpResponseDef;
-    /** Which Lucern module owns the implementation */
-    ownerModule: string;
-    /** Ontology primitive this tool operates on */
-    ontologyPrimitive: "belief" | "evidence" | "source" | "question" | "judgment" | "worktree" | "branch" | "lens" | "edge" | "graph" | "task" | "policy" | "ontology" | "identity";
-    /** MCP surface tier — showcase (front page, every demo) or workhorse (complete CRUD, discovered when building) */
-    tier: "showcase" | "workhorse";
-    /** Hide this tool from public discovery surfaces. */
-    internal?: boolean;
-    /** Deprecation notice shown in contract-driven docs and discovery. */
-    deprecated?: string;
-};
-export type McpParameterDef = {
-    type: "string" | "number" | "boolean" | "array" | "object";
-    description: string;
-    required?: boolean;
-    enum?: string[];
-};
-export type McpResponseDef = {
-    description: string;
-    fields: Record<string, string>;
-};
-export declare const CREATE_BELIEF: McpToolContract;
-export declare const GET_BELIEF: McpToolContract;
-export declare const REFINE_BELIEF: McpToolContract;
-export declare const MODULATE_CONFIDENCE: McpToolContract;
-export declare const FORK_BELIEF: McpToolContract;
-export declare const ARCHIVE_BELIEF: McpToolContract;
-export declare const CREATE_EPISTEMIC_CONTRACT: McpToolContract;
-export declare const ADD_EVIDENCE: McpToolContract;
-export declare const FLAG_CONTRADICTION: McpToolContract;
-export declare const ADD_WORKTREE: McpToolContract;
-export declare const MERGE: McpToolContract;
-export declare const QUERY_LINEAGE: McpToolContract;
-export declare const GET_CONFIDENCE_HISTORY: McpToolContract;
-export declare const GET_AUDIT_TRAIL: McpToolContract;
-export declare const TRAVERSE_GRAPH: McpToolContract;
-export declare const GET_GRAPH_NEIGHBORHOOD: McpToolContract;
-export declare const TRACE_ENTITY_IMPACT: McpToolContract;
-export declare const SEARCH_BELIEFS: McpToolContract;
-export declare const SEARCH_RESOURCES: McpToolContract;
-export declare const FIND_CONTRADICTIONS: McpToolContract;
-export declare const CREATE_EDGE: McpToolContract;
-export declare const RECORD_JUDGMENT: McpToolContract;
-export declare const CREATE_LENS: McpToolContract;
-export declare const LIST_LENSES: McpToolContract;
-export declare const APPLY_LENS_TO_TOPIC: McpToolContract;
-export declare const REMOVE_LENS_FROM_TOPIC: McpToolContract;
-export declare const PUSH: McpToolContract;
-export declare const OPEN_PULL_REQUEST: McpToolContract;
-export declare const BISECT_CONFIDENCE: McpToolContract;
-export declare const DETECT_CONFIRMATION_BIAS: McpToolContract;
-export declare const GET_GRAPH_STRUCTURE_ANALYSIS: McpToolContract;
-export declare const GET_FALSIFICATION_QUESTIONS: McpToolContract;
-export declare const SEARCH_SOURCES: McpToolContract;
-export declare const EXECUTE_DEEP_RESEARCH: McpToolContract;
-export declare const SEARCH_EVIDENCE: McpToolContract;
-export declare const CREATE_EVIDENCE: McpToolContract;
-export declare const GET_EVIDENCE: McpToolContract;
-export declare const LIST_EVIDENCE: McpToolContract;
-export declare const LINK_EVIDENCE: McpToolContract;
-export declare const LINK_EVIDENCE_TO_BELIEF: McpToolContract;
-export declare const CREATE_QUESTION: McpToolContract;
-export declare const GET_QUESTION: McpToolContract;
-export declare const REFINE_QUESTION: McpToolContract;
-export declare const LIST_QUESTIONS: McpToolContract;
-export declare const ANSWER_QUESTION: McpToolContract;
-export declare const UPDATE_QUESTION_STATUS: McpToolContract;
-export declare const ARCHIVE_QUESTION: McpToolContract;
-export declare const LINK_EVIDENCE_TO_QUESTION: McpToolContract;
-export declare const CREATE_ANSWER: McpToolContract;
-export declare const GET_ANSWER: McpToolContract;
-export declare const GET_HIGH_PRIORITY_QUESTIONS: McpToolContract;
-export declare const FIND_MISSING_QUESTIONS: McpToolContract;
-export declare const LIST_BELIEFS: McpToolContract;
-export declare const LIST_WORKTREES: McpToolContract;
-export declare const LIST_ALL_WORKTREES: McpToolContract;
-export declare const ACTIVATE_WORKTREE: McpToolContract;
-export declare const UPDATE_WORKTREE_TARGETS: McpToolContract;
-export declare const UPDATE_WORKTREE_METADATA: McpToolContract;
-export declare const IDENTITY_WHOAMI: McpToolContract;
-export declare const COMPILE_CONTEXT: McpToolContract;
-export declare const CHECK_PERMISSION: McpToolContract;
-export declare const FILTER_BY_PERMISSION: McpToolContract;
-export declare const INGEST_OBSERVATION: McpToolContract;
-export declare const GET_OBSERVATION_CONTEXT: McpToolContract;
-export declare const CREATE_TASK: McpToolContract;
-export declare const COMPLETE_TASK: McpToolContract;
-export declare const UPDATE_TASK: McpToolContract;
-export declare const LIST_TASKS: McpToolContract;
-export declare const CREATE_TOPIC: McpToolContract;
-export declare const LIST_TOPICS: McpToolContract;
-export declare const GET_TOPIC: McpToolContract;
-export declare const UPDATE_TOPIC: McpToolContract;
-export declare const GET_TOPIC_TREE: McpToolContract;
-export declare const GET_CODE_CONTEXT: McpToolContract;
-export declare const GET_CHANGE_HISTORY: McpToolContract;
-export declare const RECORD_ATTEMPT: McpToolContract;
-export declare const GET_FAILURE_LOG: McpToolContract;
-export declare const GET_TOPIC_COVERAGE: McpToolContract;
-export declare const GET_GRAPH_GAPS: McpToolContract;
-export declare const MANAGE_WRITE_POLICY: McpToolContract;
-export declare const LIST_ONTOLOGIES: McpToolContract;
-export declare const GET_ONTOLOGY: McpToolContract;
-export declare const APPLY_ONTOLOGY: McpToolContract;
-export declare const MATCH_ENTITY_TYPE: McpToolContract;
-export declare const CREATE_ONTOLOGY: McpToolContract;
-export declare const UPDATE_ONTOLOGY: McpToolContract;
-export declare const ARCHIVE_ONTOLOGY: McpToolContract;
-export declare const CREATE_ONTOLOGY_VERSION: McpToolContract;
-export declare const PUBLISH_ONTOLOGY_VERSION: McpToolContract;
-export declare const DEPRECATE_ONTOLOGY_VERSION: McpToolContract;
-export declare const RESOLVE_EFFECTIVE_ONTOLOGY: McpToolContract;
-/** All MCP tool contracts, indexed by name */
-export declare const MCP_TOOL_CONTRACTS: Record<string, McpToolContract>;
-/** Tool names that MUST include git-semantic language in descriptions */
-export declare const GIT_SEMANTIC_REQUIRED_TOOLS: string[];
-/**
- * Lint validation: every tool description must contain "Like `git" or "Like a `git"
- * or reference a git operation in the first sentence.
- */
-export declare function validateGitSemantics(tool: McpToolContract): {
-    valid: boolean;
-    reason?: string;
-};