@lucern/contracts 0.1.0-alpha.3 → 0.1.1-alpha.1

package/dist/lens-filter.contract.js

@@ -1,96 +0,0 @@
-/**
- * Lens Filter Criteria Contract
- *
- * Version-discriminated filter DSL for lenses. Each filter criteria document
- * carries a `version` and `kind` discriminator so future shapes can coexist
- * without schema migrations. The Convex `filterCriteria` field remains v.any()
- * — all type enforcement happens here at the TypeScript contract layer.
- *
- * Forward-compatibility guarantees:
- * - `version` field: new versions add fields, never remove or rename existing ones
- * - `kind` field: new filter kinds (temporal, confidence-range) can be added
- *   without touching taxonomy code paths
- * - `entityTypeFilters` array items are open to extension in future versions
- * - Resolution logic switches on `version` + `kind` to select the right resolver
- *
- * @module lucern/contracts/src/lens-filter
- */
-// Future: | TemporalFilterCriteriaV1 | ConfidenceRangeFilterCriteriaV1 | ...
-// ---------------------------------------------------------------------------
-// Type guards
-// ---------------------------------------------------------------------------
-export function isLensFilterCriteria(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const obj = value;
-    return typeof obj.version === "number" && typeof obj.kind === "string";
-}
-export function isTaxonomyFilterCriteriaV1(value) {
-    if (!isLensFilterCriteria(value))
-        return false;
-    return value.version === 1 && value.kind === "taxonomy";
-}
-/**
- * Validate a filter criteria document at the contract layer.
- * This runs before persisting to Convex.
- */
-export function validateFilterCriteria(value) {
-    if (value === undefined || value === null) {
-        return { valid: true }; // filterCriteria is optional
-    }
-    if (!isLensFilterCriteria(value)) {
-        return {
-            valid: false,
-            errors: [
-                'filterCriteria must have numeric "version" and string "kind" fields',
-            ],
-        };
-    }
-    if (isTaxonomyFilterCriteriaV1(value)) {
-        return validateTaxonomyFilterV1(value);
-    }
-    // Cast to access properties — TypeScript narrows to `never` when all union
-    // members are exhausted, but at runtime unknown version/kind combos are possible.
-    const raw = value;
-    return {
-        valid: false,
-        errors: [
-            `Unsupported filter criteria: version=${raw.version}, kind=${raw.kind}`,
-        ],
-    };
-}
-function validateTaxonomyFilterV1(criteria) {
-    const errors = [];
-    if (!Array.isArray(criteria.entityTypeFilters)) {
-        errors.push("entityTypeFilters must be an array");
-        return { valid: false, errors };
-    }
-    if (criteria.entityTypeFilters.length === 0) {
-        errors.push("entityTypeFilters must contain at least one entry");
-        return { valid: false, errors };
-    }
-    for (let i = 0; i < criteria.entityTypeFilters.length; i++) {
-        const filter = criteria.entityTypeFilters[i];
-        if (!filter || typeof filter.entityTypeValue !== "string") {
-            errors.push(`entityTypeFilters[${i}].entityTypeValue must be a non-empty string`);
-            continue;
-        }
-        if (filter.entityTypeValue.trim().length === 0) {
-            errors.push(`entityTypeFilters[${i}].entityTypeValue must be a non-empty string`);
-        }
-        if (filter.subtypeValues !== undefined &&
-            !Array.isArray(filter.subtypeValues)) {
-            errors.push(`entityTypeFilters[${i}].subtypeValues must be an array`);
-        }
-    }
-    if (criteria.ontologyScope !== undefined) {
-        if (typeof criteria.ontologyScope !== "object" ||
-            criteria.ontologyScope === null) {
-            errors.push("ontologyScope must be an object");
-        }
-    }
-    return errors.length === 0
-        ? { valid: true }
-        : { valid: false, errors };
-}
-//# sourceMappingURL=lens-filter.contract.js.map

package/dist/lens-filter.contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lens-filter.contract.js","sourceRoot":"","sources":["../src/lens-filter.contract.ts"],"names":[],"mappings":"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"}

package/dist/lens-workflow.contract.d.ts

@@ -1,85 +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;
-//# sourceMappingURL=lens-workflow.contract.d.ts.map

package/dist/lens-workflow.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lens-workflow.contract.d.ts","sourceRoot":"","sources":["../src/lens-workflow.contract.ts"],"names":[],"mappings":"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"}

package/dist/lens-workflow.contract.js

@@ -1,55 +0,0 @@
-/**
- * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.
- */
-export { validateFilterCriteria, isLensFilterCriteria, isTaxonomyFilterCriteriaV1, } from "./lens-filter.contract";
-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),
-    };
-}
-//# sourceMappingURL=lens-workflow.contract.js.map

package/dist/lens-workflow.contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lens-workflow.contract.js","sourceRoot":"","sources":["../src/lens-workflow.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe;IACf,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAItE,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,UAAU;IACV,MAAM;IACN,QAAQ;IACR,KAAK;CACG,CAAC;AAgEX,MAAM,CAAC,MAAM,0BAA0B,GACrC,0FAA0F,CAAC;AAQ7F,MAAM,UAAU,wCAAwC,CACtD,MAAsB;IAEtB,MAAM,UAAU,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QACxD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAMnC;IACC,MAAM,eAAe,GAAG,wCAAwC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO;QACL,eAAe,EAAE,aAAa;QAC9B,eAAe;QACf,OAAO,EACL,qHAAqH;QACvH,gBAAgB,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe;SAChB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAM7C;IACC,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,kBAAkB,EAAE,0BAA0B;QAC9C,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/mcp-tools.contract.d.ts

@@ -1,152 +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;
-};
-//# sourceMappingURL=mcp-tools.contract.d.ts.map

package/dist/mcp-tools.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools.contract.d.ts","sourceRoot":"","sources":["../src/mcp-tools.contract.ts"],"names":[],"mappings":"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"}