@lucern/contracts 0.3.0-alpha.6 → 0.3.0-alpha.8

package/dist/function-registry/types.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F as FunctionEffect } from '../defineFunction-DO97DKs4.js';
-import { M as McpToolContract } from '../tool-contracts-CYXVPN4K.js';
+import { M as McpToolContract } from '../tool-contracts-B4iWhejG.js';
 
 type FunctionKind = "query" | "mutation" | "action";
 type FunctionIdempotency = boolean | "required";

package/dist/function-registry/worktrees.js

@@ -428,9 +428,16 @@ var ADD_WORKTREE = {
     },
     projectId: {
       type: "string",
-      description: "Legacy topicId alias"
+      description: "Legacy topicId alias or resolver hint"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope hint for resolver validation"
+    },
+    topicHint: {
+      type: "string",
+      description: "Natural-language topic hint for automatic topic resolution"
     },
-    topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
       description: "The branch this worktree investigates"
@@ -528,6 +535,22 @@ var ADD_WORKTREE = {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
     },
+    tags: {
+      type: "array",
+      description: "Additional topic-resolution tags for the worktree"
+    },
+    touchedPaths: {
+      type: "array",
+      description: "File paths used as topic-resolution signals"
+    },
+    sourceRef: {
+      type: "string",
+      description: "Source reference used as a topic-resolution signal"
+    },
+    sourceKind: {
+      type: "string",
+      description: "Source kind used as a topic-resolution signal"
+    },
     campaign: {
       type: "number",
       description: "Top-level pipeline campaign number. Campaigns define the outer execution slice."
@@ -565,7 +588,7 @@ var ADD_WORKTREE = {
       description: "Timestamp when worktree metadata was last reconciled"
     }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created worktree",
     fields: {
@@ -2062,15 +2085,15 @@ var IDENTITY_WHOAMI = {
 };
 var COMPILE_CONTEXT = {
   name: "compile_context",
-  description: "Compile a focused reasoning context for a topic. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
+  description: "Compile a focused reasoning context. If topicId is omitted, Lucern resolves the best topic from the query. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
   parameters: {
     topicId: {
       type: "string",
-      description: "Topic scope ID to compile"
+      description: "Optional topic scope ID. Omit to resolve the topic from query."
     },
     query: {
       type: "string",
-      description: "Optional focus query used to rank context items"
+      description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
     },
     budget: {
       type: "number",
@@ -2094,7 +2117,7 @@ var COMPILE_CONTEXT = {
       description: "Include related ontological entities in the compiled result"
     }
   },
-  required: ["topicId"],
+  required: [],
   response: {
     description: "Compiled context pack for the requested topic",
     fields: {
@@ -2268,18 +2291,60 @@ var CREATE_TASK = {
   name: "create_task",
   description: "Create an execution task tied to the reasoning state. Like `git task` \u2014 tracks concrete work items (calls to make, data to gather, analyses to run) linked to questions, beliefs, or worktrees.",
   parameters: {
-    title: { type: "string", description: "Task description" },
+    title: { type: "string", description: "Task title" },
     topicId: { type: "string", description: "Topic scope" },
+    description: {
+      type: "string",
+      description: "Long-form task description"
+    },
     taskType: {
       type: "string",
-      description: "Type: research, interview, analysis, data_collection",
-      enum: ["research", "interview", "analysis", "data_collection"]
+      description: "Task taxonomy",
+      enum: [
+        "general",
+        "find_evidence",
+        "verify_claim",
+        "research",
+        "review",
+        "interview",
+        "analysis",
+        "track_metrics"
+      ]
+    },
+    priority: {
+      type: "string",
+      description: "Priority",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    status: {
+      type: "string",
+      description: "Initial status (defaults to todo)",
+      enum: ["todo", "in_progress", "blocked", "done"]
+    },
+    linkedWorktreeId: {
+      type: "string",
+      description: "Worktree this task belongs to"
+    },
+    linkedBeliefId: {
+      type: "string",
+      description: "Belief this task supports"
     },
     linkedQuestionId: {
       type: "string",
       description: "Question this task addresses"
     },
-    linkedWorktreeId: { type: "string", description: "Worktree scope" }
+    assigneeId: {
+      type: "string",
+      description: "Principal assigned to the task"
+    },
+    dueDate: {
+      type: "number",
+      description: "Due date as epoch milliseconds"
+    },
+    tags: {
+      type: "array",
+      description: "Free-form string tags"
+    }
   },
   required: ["title"],
   response: {
@@ -4362,9 +4427,7 @@ function mcpContractFromArgsSchema(base, args, contractName) {
     required: converted.filter(([, field]) => field.required).map(([fieldName]) => fieldName)
   };
 }
-function defineFunctionContract(contract) {
-  return contract;
-}
+var defineFunctionContract = (contract) => contract;
 function authUserId(context) {
   return context.userId ?? context.principalId ?? "lucern-agent";
 }
@@ -4506,10 +4569,11 @@ var worktreeDecisionGateInputSchema = z.object({
   decidedBy: z.string().optional().describe("Actor that decided the gate verdict.")
 }).passthrough().describe("Decision gate contract for worktree activation or exit.");
 var addWorktreeArgs = z.object({
-  title: z.string().optional().describe("Human-readable worktree name or objective."),
+  title: z.string().describe("Human-readable worktree name or objective."),
   name: z.string().optional().describe("Storage-name alias for callers that already use backend naming."),
-  topicId: z.string().describe("Primary topic scope for the worktree."),
-  projectId: z.string().optional().describe("Legacy topicId alias."),
+  topicId: z.string().optional().describe("Optional primary topic scope hint for resolver validation."),
+  projectId: z.string().optional().describe("Legacy topicId alias/hint."),
+  topicHint: z.string().optional().describe("Natural-language topic hint for automatic topic resolution."),
   branchId: z.string().optional().describe("Legacy branch identifier for compatibility with workflow callers."),
   objective: z.string().optional().describe("Reasoning objective this worktree is intended to resolve."),
   hypothesis: z.string().optional().describe("Testable claim this worktree investigates."),
@@ -4534,6 +4598,10 @@ var addWorktreeArgs = z.object({
   autoShape: z.boolean().optional().describe("Whether to invoke inquiry auto-shaping during creation."),
   autoFixPolicy: autoFixPolicyInputSchema.optional(),
   domainPackId: z.string().optional().describe("Domain pack whose shaping hooks should influence the worktree."),
+  tags: z.array(z.string()).optional().describe("Additional topic-resolution tags for the worktree."),
+  touchedPaths: z.array(z.string()).optional().describe("File paths used as topic-resolution signals."),
+  sourceRef: z.string().optional().describe("Source reference used as a topic-resolution signal."),
+  sourceKind: z.string().optional().describe("Source kind used as a topic-resolution signal."),
   campaign: z.number().optional().describe("Top-level pipeline campaign number."),
   lane: z.string().optional().describe("Campaign lane for the worktree."),
   laneOrderInCampaign: z.number().optional().describe("Ordering for this lane within its campaign."),