@lucern/contracts 1.0.0 → 1.0.1

package/dist/tool-contracts.nodes-lenses.js

@@ -0,0 +1,334 @@
+// src/lens-workflow.contract.ts
+var LENS_PERSPECTIVE_TYPES = [
+  "investigation",
+  "monitoring",
+  "analysis",
+  "comparison",
+  "taxonomy"
+];
+
+// src/tool-contracts.nodes-lenses.ts
+var CREATE_EPISTEMIC_NODE = {
+  name: "create_epistemic_node",
+  description: "Commit a generic epistemic graph node. Like `git commit` \u2014 creates a canonical node in the public spine for topics, beliefs, evidence, questions, answers, sources, and entities.",
+  parameters: {
+    globalId: { type: "string", description: "Optional idempotent node global ID" },
+    nodeType: { type: "string", description: "Public epistemic node type" },
+    canonicalText: { type: "string", description: "Canonical node text" },
+    text: { type: "string", description: "Alias for canonicalText" },
+    contentHash: { type: "string", description: "Optional idempotency content hash" },
+    sourceType: { type: "string", description: "Source type for provenance" },
+    topicId: { type: "string", description: "Optional topic scope" },
+    content: { type: "string", description: "Extended content" },
+    title: { type: "string", description: "Display title" },
+    metadata: { type: "object", description: "Optional node metadata" }
+  },
+  required: ["nodeType"],
+  response: {
+    description: "Created node result",
+    fields: {
+      nodeId: "string",
+      nodeGlobalId: "string",
+      isDuplicate: "boolean"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var GET_EPISTEMIC_NODE = {
+  name: "get_epistemic_node",
+  description: "Read one epistemic graph node. Like `git show` \u2014 resolves a canonical spine node by ID or global ID.",
+  parameters: {
+    nodeId: { type: "string", description: "Node ID or global ID" }
+  },
+  required: ["nodeId"],
+  response: {
+    description: "The resolved node",
+    fields: { node: "object" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var LIST_EPISTEMIC_NODES = {
+  name: "list_epistemic_nodes",
+  description: "List epistemic graph nodes. Like `git ls-tree` \u2014 lists canonical spine nodes by topic, type, status, or search query.",
+  parameters: {
+    topicId: { type: "string", description: "Optional topic scope" },
+    nodeType: { type: "string", description: "Optional node type filter" },
+    status: { type: "string", description: "Optional lifecycle status" },
+    searchQuery: { type: "string", description: "Optional text search query" },
+    limit: { type: "number", description: "Maximum nodes to return" }
+  },
+  required: [],
+  response: {
+    description: "Matching nodes",
+    fields: { nodes: "array" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var UPDATE_EPISTEMIC_NODE = {
+  name: "update_epistemic_node",
+  description: "Amend an epistemic graph node. Like `git commit --amend` \u2014 updates mutable node metadata, text, status, or verification fields.",
+  parameters: {
+    nodeId: { type: "string", description: "Node ID or global ID" },
+    canonicalText: { type: "string", description: "Updated canonical text" },
+    text: { type: "string", description: "Alias for canonicalText" },
+    contentHash: { type: "string", description: "Updated content hash" },
+    content: { type: "string", description: "Updated content" },
+    title: { type: "string", description: "Updated display title" },
+    metadata: { type: "object", description: "Updated metadata" },
+    confidence: { type: "number", description: "Updated confidence" },
+    verificationStatus: { type: "string", description: "Updated verification status" },
+    status: { type: "string", description: "Updated lifecycle status" }
+  },
+  required: ["nodeId"],
+  response: {
+    description: "Node update result",
+    fields: { success: "boolean" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var ARCHIVE_EPISTEMIC_NODE = {
+  name: "archive_epistemic_node",
+  description: "Archive an epistemic graph node. Like `git rm --cached` \u2014 removes a node from active traversal without hard-deleting it.",
+  parameters: {
+    nodeId: { type: "string", description: "Node ID or global ID" }
+  },
+  required: ["nodeId"],
+  response: {
+    description: "Archive result",
+    fields: { success: "boolean", effectiveStatus: "string" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var VERIFY_EPISTEMIC_NODE = {
+  name: "verify_epistemic_node",
+  description: "Record verification state on an epistemic graph node. Like `git tag` \u2014 marks the node with a reviewed verification state.",
+  parameters: {
+    nodeId: { type: "string", description: "Node ID or global ID" },
+    verificationStatus: { type: "string", description: "Verification status" },
+    confidence: { type: "number", description: "Optional confidence update" }
+  },
+  required: ["nodeId", "verificationStatus"],
+  response: {
+    description: "Verification result",
+    fields: { success: "boolean" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var SUPERSEDE_EPISTEMIC_NODE = {
+  name: "supersede_epistemic_node",
+  description: "Supersede an epistemic graph node with a new version. Like `git commit --amend` on an immutable history branch \u2014 creates the replacement and marks the old node superseded.",
+  parameters: {
+    oldNodeId: { type: "string", description: "Node ID or global ID to supersede" },
+    newGlobalId: { type: "string", description: "Optional replacement global ID" },
+    newCanonicalText: { type: "string", description: "Replacement canonical text" },
+    text: { type: "string", description: "Alias for newCanonicalText" },
+    newContentHash: { type: "string", description: "Optional replacement content hash" },
+    reason: { type: "string", description: "Reason for superseding" }
+  },
+  required: ["oldNodeId"],
+  response: {
+    description: "Supersede result",
+    fields: { oldNodeId: "string", newNodeId: "string" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var BATCH_CREATE_EPISTEMIC_NODES = {
+  name: "batch_create_epistemic_nodes",
+  description: "Commit multiple epistemic graph nodes. Like `git commit` with many staged files \u2014 writes a batch of canonical spine nodes.",
+  parameters: {
+    nodes: {
+      type: "array",
+      description: "Nodes to create with nodeType, canonicalText/text, and optional metadata."
+    }
+  },
+  required: ["nodes"],
+  response: {
+    description: "Batch node creation result",
+    fields: { created: "number", results: "array" }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse"
+};
+var RECORD_JUDGMENT = {
+  name: "record_judgment",
+  description: "Record a judgment \u2014 an irreversible commitment based on the current epistemic state. Like a `git tag` marking a release. A judgment synthesizes beliefs, evidence, and uncertainties into a determination. Once issued, a judgment is evaluated against the epistemic state that existed when it was made (knowledge horizon evaluation, Invariant #10).",
+  parameters: {
+    title: { type: "string", description: "Short judgment statement" },
+    rationale: {
+      type: "string",
+      description: "Full reasoning behind the judgment"
+    },
+    topicId: { type: "string", description: "Topic scope" },
+    beliefIds: {
+      type: "array",
+      description: "Beliefs that warrant this judgment"
+    },
+    confidence: {
+      type: "number",
+      description: "Confidence in the judgment (0-1)"
+    }
+  },
+  required: ["title", "rationale"],
+  response: {
+    description: "The recorded judgment",
+    fields: {
+      judgmentId: "string",
+      title: "string",
+      status: "string \u2014 'issued'"
+    }
+  },
+  ownerModule: "decisions",
+  ontologyPrimitive: "judgment",
+  tier: "showcase"
+};
+var CREATE_LENS = {
+  name: "create_lens",
+  description: "Create a reusable lens that overlays a workspace topic with a specific analytical perspective. Like `git branch <name>` for operational scaffolding \u2014 a lens persists across worktrees and carries prompts, workflows, and task templates. Multiple topics in the same workspace can reuse the same lens.",
+  parameters: {
+    name: {
+      type: "string",
+      description: "Lens name (e.g., 'market dynamics', 'team quality')"
+    },
+    workspaceId: {
+      type: "string",
+      description: "Workspace scope for the lens. Required unless topicId resolves to a workspace-scoped topic."
+    },
+    topicId: {
+      type: "string",
+      description: "Optional originating topic scope. Lenses remain reusable across topics even when this is set."
+    },
+    description: {
+      type: "string",
+      description: "What this lens is designed to investigate or monitor"
+    },
+    perspectiveType: {
+      type: "string",
+      description: "Perspective type for the lens. Validated against schemaEnumConfig category 'lens_perspective_type'.",
+      enum: [...LENS_PERSPECTIVE_TYPES]
+    },
+    promptTemplates: {
+      type: "array",
+      description: "Langfuse prompt references used when operating through this lens"
+    },
+    workflowTemplates: {
+      type: "array",
+      description: "Guided workflow templates for lens-driven investigations"
+    },
+    taskTemplates: {
+      type: "array",
+      description: "Default task templates instantiated when the lens is applied"
+    },
+    filterCriteria: {
+      type: "object",
+      description: "Belief/evidence filtering rules applied by the lens"
+    }
+  },
+  required: ["name", "perspectiveType"],
+  response: {
+    description: "The created lens",
+    fields: {
+      lensId: "string",
+      name: "string",
+      workspaceId: "string",
+      status: "string \u2014 'active'"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "lens",
+  tier: "showcase"
+};
+var LIST_LENSES = {
+  name: "list_lenses",
+  description: "List reusable lenses for a workspace, optionally scored by whether they are active on a topic. Like `git branch --list` \u2014 shows the available named frames you can activate. When topicId is provided, the response can indicate which lenses are already applied there.",
+  parameters: {
+    workspaceId: {
+      type: "string",
+      description: "Workspace scope to list lenses from"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope used to derive workspace and annotate applied lenses"
+    },
+    status: {
+      type: "string",
+      description: "Filter by lens lifecycle status",
+      enum: ["draft", "active", "archived"]
+    },
+    perspectiveType: {
+      type: "string",
+      description: "Filter by perspective type",
+      enum: [...LENS_PERSPECTIVE_TYPES]
+    }
+  },
+  required: [],
+  response: {
+    description: "Available lenses",
+    fields: {
+      lenses: "array \u2014 each item includes lensId, name, workspaceId, perspectiveType, status, and optional isAppliedToTopic"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "lens",
+  tier: "workhorse"
+};
+var APPLY_LENS_TO_TOPIC = {
+  name: "apply_lens_to_topic",
+  description: "Apply a lens to a topic so it becomes an active perspective overlay. Like `git checkout <branch>` for a reusable frame \u2014 the topic keeps its knowledge, but the active lens shapes guidance and retrieval. Multiple active lenses can coexist on the same topic.",
+  parameters: {
+    lensId: { type: "string", description: "Lens to activate on the topic" },
+    topicId: { type: "string", description: "Topic that should receive the lens" }
+  },
+  required: ["lensId", "topicId"],
+  response: {
+    description: "Lens activation result",
+    fields: {
+      bindingId: "string",
+      lensId: "string",
+      topicId: "string",
+      status: "string \u2014 'active'"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "lens",
+  tier: "workhorse"
+};
+var REMOVE_LENS_FROM_TOPIC = {
+  name: "remove_lens_from_topic",
+  description: "Remove an active lens overlay from a topic. Like `git switch` away from a frame \u2014 the topic remains, but the lens stops shaping the investigation context. Historical binding state is preserved for auditability.",
+  parameters: {
+    lensId: { type: "string", description: "Lens to remove from the topic" },
+    topicId: { type: "string", description: "Topic that currently has the lens applied" }
+  },
+  required: ["lensId", "topicId"],
+  response: {
+    description: "Lens removal result",
+    fields: {
+      bindingId: "string",
+      lensId: "string",
+      topicId: "string",
+      status: "string \u2014 'removed'"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "lens",
+  tier: "workhorse"
+};
+
+export { APPLY_LENS_TO_TOPIC, ARCHIVE_EPISTEMIC_NODE, BATCH_CREATE_EPISTEMIC_NODES, CREATE_EPISTEMIC_NODE, CREATE_LENS, GET_EPISTEMIC_NODE, LIST_EPISTEMIC_NODES, LIST_LENSES, RECORD_JUDGMENT, REMOVE_LENS_FROM_TOPIC, SUPERSEDE_EPISTEMIC_NODE, UPDATE_EPISTEMIC_NODE, VERIFY_EPISTEMIC_NODE };
+//# sourceMappingURL=tool-contracts.nodes-lenses.js.map
+//# sourceMappingURL=tool-contracts.nodes-lenses.js.map

package/dist/tool-contracts.nodes-lenses.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lens-workflow.contract.ts","../src/tool-contracts.nodes-lenses.ts"],"names":[],"mappings":"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","file":"tool-contracts.nodes-lenses.js","sourcesContent":["/**\n * Canonical lens workflow contract shared across schema, SDK, and MCP surfaces.\n */\n\n// Re-export filter criteria types for consumers who import from lens-workflow\nexport type {\n  LensFilterCriteria,\n  TaxonomyFilterCriteriaV1,\n  EntityTypeFilterV1,\n  OntologyScope,\n  FilterValidationResult,\n} from \"./lens-filter.contract\";\nexport {\n  validateFilterCriteria,\n  isLensFilterCriteria,\n  isTaxonomyFilterCriteriaV1,\n} from \"./lens-filter.contract\";\n\nexport const LENS_PERSPECTIVE_TYPES = [\n  \"investigation\",\n  \"monitoring\",\n  \"analysis\",\n  \"comparison\",\n  \"taxonomy\",\n] as const;\n\nexport type LensPerspectiveType = (typeof LENS_PERSPECTIVE_TYPES)[number];\n\nexport const LENS_STATUSES = [\"draft\", \"active\", \"archived\"] as const;\n\nexport type LensStatus = (typeof LENS_STATUSES)[number];\n\nexport const LENS_TASK_TEMPLATE_PRIORITIES = [\n  \"critical\",\n  \"high\",\n  \"medium\",\n  \"low\",\n] as const;\n\nexport type LensTaskTemplatePriority =\n  (typeof LENS_TASK_TEMPLATE_PRIORITIES)[number];\n\nexport type LensLooseMetadata = Record<string, unknown>;\n\nexport type LensPromptTemplateReference = {\n  key: string;\n  promptRef: string;\n  phase?: string;\n  role?: string;\n  version?: string;\n  required?: boolean;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowStepTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  promptTemplateKey?: string;\n  taskTemplateKeys?: string[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensWorkflowTemplate = {\n  key: string;\n  name: string;\n  description?: string;\n  steps: LensWorkflowStepTemplate[];\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensTaskTemplate = {\n  key: string;\n  title: string;\n  description?: string;\n  priority?: LensTaskTemplatePriority;\n  phase?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensQuestionTemplate = {\n  key: string;\n  text: string;\n  priority?: LensTaskTemplatePriority;\n  linkedBeliefKey?: string;\n  metadata?: LensLooseMetadata;\n};\n\nexport type LensBranchMigrationSuggestion = {\n  recommendedTool: \"create_lens\";\n  perspectiveType: LensPerspectiveType;\n  message: string;\n  suggestedPayload: {\n    name: string;\n    description?: string;\n    topicId?: string;\n    workspaceId?: string;\n    perspectiveType: LensPerspectiveType;\n  };\n};\n\nexport const BRANCH_DEPRECATION_MESSAGE =\n  \"Branches are deprecated for operational framing. Create a workspace-scoped lens instead.\";\n\nexport type DeprecatedBranchMetadata = {\n  deprecated: true;\n  deprecationMessage: string;\n  lensSuggestion: LensBranchMigrationSuggestion;\n};\n\nexport function inferLensPerspectiveTypeFromBranchSchema(\n  schema?: string | null\n): LensPerspectiveType {\n  const normalized = schema?.trim().toLowerCase();\n  if (normalized === \"phase\") {\n    return \"monitoring\";\n  }\n  if (normalized === \"axis\" || normalized === \"dimension\") {\n    return \"comparison\";\n  }\n  if (normalized === \"track\") {\n    return \"investigation\";\n  }\n  return \"analysis\";\n}\n\nexport function migrateBranchToLens(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): LensBranchMigrationSuggestion {\n  const perspectiveType = inferLensPerspectiveTypeFromBranchSchema(args.schema);\n  return {\n    recommendedTool: \"create_lens\",\n    perspectiveType,\n    message:\n      \"Branches are deprecated for operational framing. Create a workspace-scoped lens with the suggested payload instead.\",\n    suggestedPayload: {\n      name: args.name,\n      description: args.description,\n      topicId: args.topicId,\n      workspaceId: args.workspaceId,\n      perspectiveType,\n    },\n  };\n}\n\nexport function buildDeprecatedBranchMetadata(args: {\n  name: string;\n  description?: string;\n  topicId?: string;\n  workspaceId?: string;\n  schema?: string | null;\n}): DeprecatedBranchMetadata {\n  return {\n    deprecated: true,\n    deprecationMessage: BRANCH_DEPRECATION_MESSAGE,\n    lensSuggestion: migrateBranchToLens(args),\n  };\n}\n","import type { McpToolContract } from \"./tool-contracts.types\";\nimport { LENS_PERSPECTIVE_TYPES } from \"./lens-workflow.contract\";\n\nexport const CREATE_EPISTEMIC_NODE: McpToolContract = {\n  name: \"create_epistemic_node\",\n  description:\n    \"Commit a generic epistemic graph node. \" +\n    \"Like `git commit` — creates a canonical node in the public spine for topics, beliefs, evidence, questions, answers, sources, and entities.\",\n  parameters: {\n    globalId: { type: \"string\", description: \"Optional idempotent node global ID\" },\n    nodeType: { type: \"string\", description: \"Public epistemic node type\" },\n    canonicalText: { type: \"string\", description: \"Canonical node text\" },\n    text: { type: \"string\", description: \"Alias for canonicalText\" },\n    contentHash: { type: \"string\", description: \"Optional idempotency content hash\" },\n    sourceType: { type: \"string\", description: \"Source type for provenance\" },\n    topicId: { type: \"string\", description: \"Optional topic scope\" },\n    content: { type: \"string\", description: \"Extended content\" },\n    title: { type: \"string\", description: \"Display title\" },\n    metadata: { type: \"object\", description: \"Optional node metadata\" },\n  },\n  required: [\"nodeType\"],\n  response: {\n    description: \"Created node result\",\n    fields: {\n      nodeId: \"string\",\n      nodeGlobalId: \"string\",\n      isDuplicate: \"boolean\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"showcase\",\n};\n\nexport const GET_EPISTEMIC_NODE: McpToolContract = {\n  name: \"get_epistemic_node\",\n  description:\n    \"Read one epistemic graph node. \" +\n    \"Like `git show` — resolves a canonical spine node by ID or global ID.\",\n  parameters: {\n    nodeId: { type: \"string\", description: \"Node ID or global ID\" },\n  },\n  required: [\"nodeId\"],\n  response: {\n    description: \"The resolved node\",\n    fields: { node: \"object\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const LIST_EPISTEMIC_NODES: McpToolContract = {\n  name: \"list_epistemic_nodes\",\n  description:\n    \"List epistemic graph nodes. \" +\n    \"Like `git ls-tree` — lists canonical spine nodes by topic, type, status, or search query.\",\n  parameters: {\n    topicId: { type: \"string\", description: \"Optional topic scope\" },\n    nodeType: { type: \"string\", description: \"Optional node type filter\" },\n    status: { type: \"string\", description: \"Optional lifecycle status\" },\n    searchQuery: { type: \"string\", description: \"Optional text search query\" },\n    limit: { type: \"number\", description: \"Maximum nodes to return\" },\n  },\n  required: [],\n  response: {\n    description: \"Matching nodes\",\n    fields: { nodes: \"array\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const UPDATE_EPISTEMIC_NODE: McpToolContract = {\n  name: \"update_epistemic_node\",\n  description:\n    \"Amend an epistemic graph node. \" +\n    \"Like `git commit --amend` — updates mutable node metadata, text, status, or verification fields.\",\n  parameters: {\n    nodeId: { type: \"string\", description: \"Node ID or global ID\" },\n    canonicalText: { type: \"string\", description: \"Updated canonical text\" },\n    text: { type: \"string\", description: \"Alias for canonicalText\" },\n    contentHash: { type: \"string\", description: \"Updated content hash\" },\n    content: { type: \"string\", description: \"Updated content\" },\n    title: { type: \"string\", description: \"Updated display title\" },\n    metadata: { type: \"object\", description: \"Updated metadata\" },\n    confidence: { type: \"number\", description: \"Updated confidence\" },\n    verificationStatus: { type: \"string\", description: \"Updated verification status\" },\n    status: { type: \"string\", description: \"Updated lifecycle status\" },\n  },\n  required: [\"nodeId\"],\n  response: {\n    description: \"Node update result\",\n    fields: { success: \"boolean\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const ARCHIVE_EPISTEMIC_NODE: McpToolContract = {\n  name: \"archive_epistemic_node\",\n  description:\n    \"Archive an epistemic graph node. \" +\n    \"Like `git rm --cached` — removes a node from active traversal without hard-deleting it.\",\n  parameters: {\n    nodeId: { type: \"string\", description: \"Node ID or global ID\" },\n  },\n  required: [\"nodeId\"],\n  response: {\n    description: \"Archive result\",\n    fields: { success: \"boolean\", effectiveStatus: \"string\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const VERIFY_EPISTEMIC_NODE: McpToolContract = {\n  name: \"verify_epistemic_node\",\n  description:\n    \"Record verification state on an epistemic graph node. \" +\n    \"Like `git tag` — marks the node with a reviewed verification state.\",\n  parameters: {\n    nodeId: { type: \"string\", description: \"Node ID or global ID\" },\n    verificationStatus: { type: \"string\", description: \"Verification status\" },\n    confidence: { type: \"number\", description: \"Optional confidence update\" },\n  },\n  required: [\"nodeId\", \"verificationStatus\"],\n  response: {\n    description: \"Verification result\",\n    fields: { success: \"boolean\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const SUPERSEDE_EPISTEMIC_NODE: McpToolContract = {\n  name: \"supersede_epistemic_node\",\n  description:\n    \"Supersede an epistemic graph node with a new version. \" +\n    \"Like `git commit --amend` on an immutable history branch — creates the replacement and marks the old node superseded.\",\n  parameters: {\n    oldNodeId: { type: \"string\", description: \"Node ID or global ID to supersede\" },\n    newGlobalId: { type: \"string\", description: \"Optional replacement global ID\" },\n    newCanonicalText: { type: \"string\", description: \"Replacement canonical text\" },\n    text: { type: \"string\", description: \"Alias for newCanonicalText\" },\n    newContentHash: { type: \"string\", description: \"Optional replacement content hash\" },\n    reason: { type: \"string\", description: \"Reason for superseding\" },\n  },\n  required: [\"oldNodeId\"],\n  response: {\n    description: \"Supersede result\",\n    fields: { oldNodeId: \"string\", newNodeId: \"string\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\nexport const BATCH_CREATE_EPISTEMIC_NODES: McpToolContract = {\n  name: \"batch_create_epistemic_nodes\",\n  description:\n    \"Commit multiple epistemic graph nodes. \" +\n    \"Like `git commit` with many staged files — writes a batch of canonical spine nodes.\",\n  parameters: {\n    nodes: {\n      type: \"array\",\n      description: \"Nodes to create with nodeType, canonicalText/text, and optional metadata.\",\n    },\n  },\n  required: [\"nodes\"],\n  response: {\n    description: \"Batch node creation result\",\n    fields: { created: \"number\", results: \"array\" },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"graph\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// JUDGMENT TOOLS (Phase 1: new vocabulary, aliased to decision implementation)\n// =============================================================================\n\nexport const RECORD_JUDGMENT: McpToolContract = {\n  name: \"record_judgment\",\n  description:\n    \"Record a judgment — an irreversible commitment based on the current epistemic state. \" +\n    \"Like a `git tag` marking a release. \" +\n    \"A judgment synthesizes beliefs, evidence, and uncertainties into a determination. \" +\n    \"Once issued, a judgment is evaluated against the epistemic state that existed when it was made \" +\n    \"(knowledge horizon evaluation, Invariant #10).\",\n  parameters: {\n    title: { type: \"string\", description: \"Short judgment statement\" },\n    rationale: {\n      type: \"string\",\n      description: \"Full reasoning behind the judgment\",\n    },\n    topicId: { type: \"string\", description: \"Topic scope\" },\n    beliefIds: {\n      type: \"array\",\n      description: \"Beliefs that warrant this judgment\",\n    },\n    confidence: {\n      type: \"number\",\n      description: \"Confidence in the judgment (0-1)\",\n    },\n  },\n  required: [\"title\", \"rationale\"],\n  response: {\n    description: \"The recorded judgment\",\n    fields: {\n      judgmentId: \"string\",\n      title: \"string\",\n      status: \"string — 'issued'\",\n    },\n  },\n  ownerModule: \"decisions\",\n  ontologyPrimitive: \"judgment\",\n  tier: \"showcase\",\n};\n\n// =============================================================================\n// LENS TOOLS (workspace-scoped operational frames)\n// =============================================================================\n\nexport const CREATE_LENS: McpToolContract = {\n  name: \"create_lens\",\n  description:\n    \"Create a reusable lens that overlays a workspace topic with a specific analytical perspective. \" +\n    \"Like `git branch <name>` for operational scaffolding — a lens persists across worktrees and carries prompts, workflows, and task templates. \" +\n    \"Multiple topics in the same workspace can reuse the same lens.\",\n  parameters: {\n    name: {\n      type: \"string\",\n      description: \"Lens name (e.g., 'market dynamics', 'team quality')\",\n    },\n    workspaceId: {\n      type: \"string\",\n      description:\n        \"Workspace scope for the lens. Required unless topicId resolves to a workspace-scoped topic.\",\n    },\n    topicId: {\n      type: \"string\",\n      description:\n        \"Optional originating topic scope. Lenses remain reusable across topics even when this is set.\",\n    },\n    description: {\n      type: \"string\",\n      description: \"What this lens is designed to investigate or monitor\",\n    },\n    perspectiveType: {\n      type: \"string\",\n      description:\n        \"Perspective type for the lens. Validated against schemaEnumConfig category 'lens_perspective_type'.\",\n      enum: [...LENS_PERSPECTIVE_TYPES],\n    },\n    promptTemplates: {\n      type: \"array\",\n      description: \"Langfuse prompt references used when operating through this lens\",\n    },\n    workflowTemplates: {\n      type: \"array\",\n      description: \"Guided workflow templates for lens-driven investigations\",\n    },\n    taskTemplates: {\n      type: \"array\",\n      description: \"Default task templates instantiated when the lens is applied\",\n    },\n    filterCriteria: {\n      type: \"object\",\n      description: \"Belief/evidence filtering rules applied by the lens\",\n    },\n  },\n  required: [\"name\", \"perspectiveType\"],\n  response: {\n    description: \"The created lens\",\n    fields: {\n      lensId: \"string\",\n      name: \"string\",\n      workspaceId: \"string\",\n      status: \"string — 'active'\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"lens\",\n  tier: \"showcase\",\n};\n\nexport const LIST_LENSES: McpToolContract = {\n  name: \"list_lenses\",\n  description:\n    \"List reusable lenses for a workspace, optionally scored by whether they are active on a topic. \" +\n    \"Like `git branch --list` — shows the available named frames you can activate. \" +\n    \"When topicId is provided, the response can indicate which lenses are already applied there.\",\n  parameters: {\n    workspaceId: {\n      type: \"string\",\n      description: \"Workspace scope to list lenses from\",\n    },\n    topicId: {\n      type: \"string\",\n      description:\n        \"Optional topic scope used to derive workspace and annotate applied lenses\",\n    },\n    status: {\n      type: \"string\",\n      description: \"Filter by lens lifecycle status\",\n      enum: [\"draft\", \"active\", \"archived\"],\n    },\n    perspectiveType: {\n      type: \"string\",\n      description: \"Filter by perspective type\",\n      enum: [...LENS_PERSPECTIVE_TYPES],\n    },\n  },\n  required: [],\n  response: {\n    description: \"Available lenses\",\n    fields: {\n      lenses:\n        \"array — each item includes lensId, name, workspaceId, perspectiveType, status, and optional isAppliedToTopic\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"lens\",\n  tier: \"workhorse\",\n};\n\nexport const APPLY_LENS_TO_TOPIC: McpToolContract = {\n  name: \"apply_lens_to_topic\",\n  description:\n    \"Apply a lens to a topic so it becomes an active perspective overlay. \" +\n    \"Like `git checkout <branch>` for a reusable frame — the topic keeps its knowledge, but the active lens shapes guidance and retrieval. \" +\n    \"Multiple active lenses can coexist on the same topic.\",\n  parameters: {\n    lensId: { type: \"string\", description: \"Lens to activate on the topic\" },\n    topicId: { type: \"string\", description: \"Topic that should receive the lens\" },\n  },\n  required: [\"lensId\", \"topicId\"],\n  response: {\n    description: \"Lens activation result\",\n    fields: {\n      bindingId: \"string\",\n      lensId: \"string\",\n      topicId: \"string\",\n      status: \"string — 'active'\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"lens\",\n  tier: \"workhorse\",\n};\n\nexport const REMOVE_LENS_FROM_TOPIC: McpToolContract = {\n  name: \"remove_lens_from_topic\",\n  description:\n    \"Remove an active lens overlay from a topic. \" +\n    \"Like `git switch` away from a frame — the topic remains, but the lens stops shaping the investigation context. \" +\n    \"Historical binding state is preserved for auditability.\",\n  parameters: {\n    lensId: { type: \"string\", description: \"Lens to remove from the topic\" },\n    topicId: { type: \"string\", description: \"Topic that currently has the lens applied\" },\n  },\n  required: [\"lensId\", \"topicId\"],\n  response: {\n    description: \"Lens removal result\",\n    fields: {\n      bindingId: \"string\",\n      lensId: \"string\",\n      topicId: \"string\",\n      status: \"string — 'removed'\",\n    },\n  },\n  ownerModule: \"reasoning-kernel\",\n  ontologyPrimitive: \"lens\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// PUSH TOOLS (git push)\n// =============================================================================\n"]}

package/dist/tool-contracts.ontology.d.ts

@@ -0,0 +1,16 @@
+import { McpToolContract } from './tool-contracts.types.js';
+
+declare const MANAGE_WRITE_POLICY: McpToolContract;
+declare const LIST_ONTOLOGIES: McpToolContract;
+declare const GET_ONTOLOGY: McpToolContract;
+declare const APPLY_ONTOLOGY: McpToolContract;
+declare const MATCH_ENTITY_TYPE: McpToolContract;
+declare const CREATE_ONTOLOGY: McpToolContract;
+declare const UPDATE_ONTOLOGY: McpToolContract;
+declare const ARCHIVE_ONTOLOGY: McpToolContract;
+declare const CREATE_ONTOLOGY_VERSION: McpToolContract;
+declare const PUBLISH_ONTOLOGY_VERSION: McpToolContract;
+declare const DEPRECATE_ONTOLOGY_VERSION: McpToolContract;
+declare const RESOLVE_EFFECTIVE_ONTOLOGY: McpToolContract;
+
+export { APPLY_ONTOLOGY, ARCHIVE_ONTOLOGY, CREATE_ONTOLOGY, CREATE_ONTOLOGY_VERSION, DEPRECATE_ONTOLOGY_VERSION, GET_ONTOLOGY, LIST_ONTOLOGIES, MANAGE_WRITE_POLICY, MATCH_ENTITY_TYPE, PUBLISH_ONTOLOGY_VERSION, RESOLVE_EFFECTIVE_ONTOLOGY, UPDATE_ONTOLOGY };