@lucern/contracts 0.3.0-alpha.3 → 0.3.0-alpha.5

package/dist/sdk-methods.contract.d.ts

@@ -202,7 +202,7 @@ type WorktreeResult = {
 };
 /** Input to merge() */
 type MergeInput = {
-    outcomes: Array<{
+    outcomes: Array<string | {
         beliefId: string;
         confidence: number;
         rationale: string;

package/dist/{sdk-tools.contract-S4ia0TTo.d.ts → sdk-tools.contract-Ng8ULxjr.d.ts}

@@ -1,4 +1,4 @@
-import { M as McpToolContract } from './tool-contracts-C92-9ueT.js';
+import { M as McpToolContract } from './tool-contracts-CYXVPN4K.js';
 
 /**
  * SDK-Only Tool Contract Definitions

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

@@ -1,2 +1,2 @@
-import './tool-contracts-C92-9ueT.js';
-export { b as ADD_NOTE_TO_WORKTREE, x as ADD_RESEARCH_ACTION, A as ADVANCE_WORKTREE_PHASE, P as ALL_SDK_TOOL_CONTRACTS, V as ALL_SDK_TOOL_NAMES, n as ANALYZE_BELIEF_CLUSTER_CANDIDATES, m as ANALYZE_BELIEF_CRITICALITY, q as ANALYZE_REASONING_DEPTH, g as COMPLETE_EVIDENCE_REVIEW, f as COMPLETE_HYPOTHESIS_FORMATION, o as CREATE_BELIEF_CONDITIONAL, t as CREATE_EVIDENCE_TASK, C as CREATE_SYNTHESIZED_BELIEF, I as DETECT_ANCHORING_BIAS, J as DETECT_SOURCE_CONCENTRATION, E as EXPLORE_CONNECTIONS, M as FIND_SEMANTIC_BRIDGES, N as FIND_SEMANTIC_ORPHANS, K as FIND_SOFT_CONTRADICTIONS, H as GET_BELIEFS_BY_EPISTEMIC_STATUS, G as GET_BELIEF_RELATIONSHIPS, h as GET_BELIEF_SUPPORT_CHAIN, D as GET_CAUSAL_CHAINS, B as GET_CHALLENGED_BELIEFS, k as GET_COLLECTION_CONVICTION, l as GET_CONVICTION_TREND, i as GET_DEEP_LINEAGE, r as GET_EVIDENCE_BY_METHODOLOGY, p as GET_NECESSARY_EVIDENCE, F as GET_NON_CONSENSUS_BELIEFS, y as GET_PREDICTIONS, z as GET_SURPRISE_DETECTION, w as GET_TASK_COUNTS, j as GRAPH_AWARE_SEARCH, e as LINK_BELIEF_TO_WORKTREE, L as LINK_DOCUMENT_TO_WORKTREE, c as LINK_EVIDENCE_TO_WORKTREE, d as LINK_QUESTION_TO_WORKTREE, u as LIST_TASKS, R as REFINE_WORKTREE_BELIEF, O as SDK_ONLY_TOOL_CONTRACTS, Q as SDK_ONLY_TOOL_NAMES, a as START_WORKTREE, S as SdkToolContract, T as TRACE_PROVENANCE, v as UPDATE_TASK, U as UPDATE_WORKTREE_PHASE, W as validateSdkGitSemantics } from './sdk-tools.contract-S4ia0TTo.js';
+import './tool-contracts-CYXVPN4K.js';
+export { b as ADD_NOTE_TO_WORKTREE, x as ADD_RESEARCH_ACTION, A as ADVANCE_WORKTREE_PHASE, P as ALL_SDK_TOOL_CONTRACTS, V as ALL_SDK_TOOL_NAMES, n as ANALYZE_BELIEF_CLUSTER_CANDIDATES, m as ANALYZE_BELIEF_CRITICALITY, q as ANALYZE_REASONING_DEPTH, g as COMPLETE_EVIDENCE_REVIEW, f as COMPLETE_HYPOTHESIS_FORMATION, o as CREATE_BELIEF_CONDITIONAL, t as CREATE_EVIDENCE_TASK, C as CREATE_SYNTHESIZED_BELIEF, I as DETECT_ANCHORING_BIAS, J as DETECT_SOURCE_CONCENTRATION, E as EXPLORE_CONNECTIONS, M as FIND_SEMANTIC_BRIDGES, N as FIND_SEMANTIC_ORPHANS, K as FIND_SOFT_CONTRADICTIONS, H as GET_BELIEFS_BY_EPISTEMIC_STATUS, G as GET_BELIEF_RELATIONSHIPS, h as GET_BELIEF_SUPPORT_CHAIN, D as GET_CAUSAL_CHAINS, B as GET_CHALLENGED_BELIEFS, k as GET_COLLECTION_CONVICTION, l as GET_CONVICTION_TREND, i as GET_DEEP_LINEAGE, r as GET_EVIDENCE_BY_METHODOLOGY, p as GET_NECESSARY_EVIDENCE, F as GET_NON_CONSENSUS_BELIEFS, y as GET_PREDICTIONS, z as GET_SURPRISE_DETECTION, w as GET_TASK_COUNTS, j as GRAPH_AWARE_SEARCH, e as LINK_BELIEF_TO_WORKTREE, L as LINK_DOCUMENT_TO_WORKTREE, c as LINK_EVIDENCE_TO_WORKTREE, d as LINK_QUESTION_TO_WORKTREE, u as LIST_TASKS, R as REFINE_WORKTREE_BELIEF, O as SDK_ONLY_TOOL_CONTRACTS, Q as SDK_ONLY_TOOL_NAMES, a as START_WORKTREE, S as SdkToolContract, T as TRACE_PROVENANCE, v as UPDATE_TASK, U as UPDATE_WORKTREE_PHASE, W as validateSdkGitSemantics } from './sdk-tools.contract-Ng8ULxjr.js';

package/dist/sdk-tools.contract.js

@@ -418,6 +418,14 @@ var ADD_WORKTREE = {
   description: "Check out a branch into an active worktree for investigation. Like `git worktree add <branch>` \u2014 creates independent working state on a thematic branch. Beliefs committed within the worktree can be freely amended (draft code on a feature branch). When investigation is complete, `merge` integrates findings into main.",
   parameters: {
     title: { type: "string", description: "Worktree name/objective" },
+    name: {
+      type: "string",
+      description: "Optional storage-name alias for callers that already use backend naming"
+    },
+    projectId: {
+      type: "string",
+      description: "Legacy topicId alias"
+    },
     topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
@@ -431,14 +439,87 @@ var ADD_WORKTREE = {
       type: "string",
       description: "The testable claim this worktree investigates"
     },
+    rationale: {
+      type: "string",
+      description: "Why this worktree exists and why it belongs in the campaign"
+    },
+    worktreeType: {
+      type: "string",
+      description: "Schema-enum worktree type used by the kernel lifecycle and retrieval layers"
+    },
+    gate: {
+      type: "string",
+      description: "Exit gate name for this worktree"
+    },
+    startDate: {
+      type: "number",
+      description: "Planned start timestamp in milliseconds since epoch"
+    },
+    endDate: {
+      type: "number",
+      description: "Planned end timestamp in milliseconds since epoch"
+    },
+    durationWeeks: {
+      type: "number",
+      description: "Planned duration in weeks"
+    },
+    confidenceImpact: {
+      type: "string",
+      description: "Expected confidence impact if the worktree succeeds",
+      enum: ["high", "medium", "low"]
+    },
+    beliefFocus: {
+      type: "string",
+      description: "Natural-language focus spanning the target belief neighborhood"
+    },
     beliefIds: {
       type: "array",
-      description: "Beliefs to test in this worktree"
+      description: "Legacy alias for targetBeliefIds"
+    },
+    beliefs: {
+      type: "array",
+      description: "Legacy alias for targetBeliefIds"
+    },
+    targetBeliefIds: {
+      type: "array",
+      description: "Belief node IDs this worktree is expected to test or update"
+    },
+    targetQuestionIds: {
+      type: "array",
+      description: "Question node IDs this worktree is expected to answer"
+    },
+    keyQuestions: {
+      type: "array",
+      description: "Inline key question objects with question, optional status, answer, answerConfidence, and linkedQuestionId"
+    },
+    evidenceSignals: {
+      type: "array",
+      description: "Evidence signal objects with signal, optional collected state, progress, and notes"
+    },
+    decisionGate: {
+      type: "object",
+      description: "Decision gate object with goCriteria, noGoSignals, optional verdict, rationale, decidedAt, and decidedBy"
+    },
+    goCriteria: {
+      type: "array",
+      description: "Shorthand go criteria used to build decisionGate"
+    },
+    noGoSignals: {
+      type: "array",
+      description: "Shorthand no-go signals used to build decisionGate"
+    },
+    proofArtifacts: {
+      type: "array",
+      description: "Expected proof artifacts required to close the worktree"
     },
     autoShape: {
       type: "boolean",
       description: "Whether to invoke inquiry auto-shaping during worktree creation"
     },
+    autoFixPolicy: {
+      type: "object",
+      description: "Policy for permitted automatic remediation inside the worktree"
+    },
     domainPackId: {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
@@ -467,9 +548,17 @@ var ADD_WORKTREE = {
       type: "array",
       description: "Worktree IDs blocked by this worktree"
     },
-    gate: {
+    staffingHint: {
       type: "string",
-      description: "Exit gate name for this worktree"
+      description: "Suggested staffing or agent allocation note"
+    },
+    lensId: {
+      type: "string",
+      description: "Lens that scopes this worktree when applicable"
+    },
+    lastReconciledAt: {
+      type: "number",
+      description: "Timestamp when worktree metadata was last reconciled"
     }
   },
   required: ["title", "topicId"],
@@ -499,7 +588,7 @@ var MERGE = {
     worktreeId: { type: "string", description: "The worktree to merge" },
     outcomes: {
       type: "array",
-      description: "Scoring outcomes for each belief: { beliefId, confidence, rationale }"
+      description: "Merge outcomes as key-finding strings, or scoring outcomes for beliefs: { beliefId, confidence, rationale }"
     },
     summary: { type: "string", description: "Overall findings summary" }
   },
@@ -1053,6 +1142,74 @@ var GET_GRAPH_STRUCTURE_ANALYSIS = {
   ontologyPrimitive: "graph",
   tier: "showcase"
 };
+var LIST_GRAPH_INTELLIGENCE_QUERIES = {
+  name: "list_graph_intelligence_queries",
+  description: "List the Graph Intelligence query catalog that powers structural graph analysis experiences. Returns categories, query IDs, prompt templates, modes, and the public tool plan each query can use.",
+  parameters: {
+    categoryId: {
+      type: "string",
+      description: "Optional category filter, such as problems or strategic"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode filter: core, bias, stress, operational, alpha, semantic, or evidence"
+    }
+  },
+  required: [],
+  response: {
+    description: "Graph Intelligence query catalog and mode-to-tool mapping",
+    fields: {
+      categories: "array \u2014 query categories",
+      queries: "array \u2014 query definitions with prompt templates and tools",
+      quickQueries: "array \u2014 recommended one-click query presets",
+      publicToolNamesByMode: "object \u2014 public tool names available to each Graph Intelligence mode"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var RUN_GRAPH_INTELLIGENCE_QUERY = {
+  name: "run_graph_intelligence_query",
+  description: "Run a named Graph Intelligence query against a tenant topic graph. Returns the selected query, prompt, deterministic graph-analysis bundle, graph context, and public tool plan for model synthesis.",
+  parameters: {
+    topicId: { type: "string", description: "Topic to analyze" },
+    queryId: {
+      type: "string",
+      description: "Graph Intelligence query ID, such as confirmation-bias, pre-mortem, or thesis-summary"
+    },
+    prompt: {
+      type: "string",
+      description: "Optional custom prompt for custom analysis runs"
+    },
+    input: {
+      type: "string",
+      description: "Optional entity, theme, belief, company, or search text for input-driven queries"
+    },
+    mode: {
+      type: "string",
+      description: "Optional mode override: core, bias, stress, operational, alpha, semantic, or evidence"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum graph context rows to return"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Graph Intelligence query result bundle ready for model or prompt-library synthesis",
+    fields: {
+      query: "object \u2014 selected query definition",
+      prompt: "string \u2014 resolved prompt template",
+      toolPlan: "array \u2014 public tools and args the model can call next",
+      analysis: "object \u2014 structure, coverage, gap, and confirmation-bias analysis",
+      context: "object \u2014 sampled beliefs, questions, evidence, edges, and contradictions"
+    }
+  },
+  ownerModule: "graph-intelligence",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
 var GET_FALSIFICATION_QUESTIONS = {
   name: "get_falsification_questions",
   description: "Generate Popperian falsification questions for beliefs. Like `git test` \u2014 identifies the questions most likely to disprove current beliefs. Karl Popper as a tool: surfaces what would need to be true to invalidate each belief.",
@@ -3518,6 +3675,69 @@ var GENERATE_SESSION_HANDOFF = {
   tier: "showcase",
   internal: true
 };
+var BEGIN_BUILD_SESSION = {
+  name: "begin_build_session",
+  description: "Bootstrap a coding build session for a Lucern worktree. Like `git worktree add` plus `git status` \u2014 returns the compact context packet an agent needs before editing.",
+  parameters: {
+    worktreeId: {
+      type: "string",
+      description: "The Lucern worktree ID to bootstrap."
+    },
+    branch: {
+      type: "string",
+      description: "Optional git branch name. Auto-generated from the worktree name when omitted."
+    },
+    branchBase: {
+      type: "string",
+      description: 'Base branch for the feature branch. Default: "staging".'
+    },
+    prBase: {
+      type: "string",
+      description: 'Target branch for the PR. Default: "staging".'
+    },
+    sessionMode: {
+      type: "string",
+      description: 'Session mode: "async" for Codex/headless or "interactive" for live sessions.',
+      enum: ["async", "interactive"]
+    },
+    activateIfPlanning: {
+      type: "boolean",
+      description: "When true, automatically activate a planning worktree during bootstrap."
+    }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "A compact build-session packet with worktree metadata, graph anchors, questions, dependencies, and git defaults.",
+    fields: {
+      topicId: "string \u2014 canonical topic scope",
+      topicName: "string \u2014 human-readable topic name",
+      worktreeId: "string \u2014 worktree ID",
+      worktreeName: "string \u2014 human-readable worktree name",
+      branch: "string \u2014 git branch name",
+      branchBase: "string \u2014 base branch",
+      prBase: "string \u2014 PR target branch",
+      campaign: "number | null \u2014 top-level pipeline campaign",
+      lane: "string \u2014 campaign lane",
+      gate: "string \u2014 exit gate",
+      hypothesis: "string \u2014 worktree hypothesis",
+      focus: "string \u2014 session focus",
+      status: "string \u2014 worktree status after optional activation",
+      sessionMode: "string \u2014 async | interactive",
+      targetBeliefIds: "array \u2014 scoped belief IDs",
+      targetQuestionIds: "array \u2014 scoped question IDs",
+      topBeliefs: "array \u2014 highest-confidence scoped beliefs",
+      openQuestions: "array \u2014 open scoped questions",
+      resolvedDecisions: "array \u2014 answered questions summarized for the session",
+      dependencies: "array \u2014 upstream worktrees",
+      unblocks: "array \u2014 downstream worktrees",
+      mergeOrderNotes: "string \u2014 merge ordering advisory"
+    }
+  },
+  ownerModule: "bootstrap",
+  ontologyPrimitive: "worktree",
+  tier: "showcase",
+  internal: true
+};
 var MCP_TOOL_CONTRACTS = {
   // Belief lifecycle (commit, amend, fork, archive)
   create_belief: CREATE_BELIEF,
@@ -3565,6 +3785,8 @@ var MCP_TOOL_CONTRACTS = {
   // Graph intelligence (showcase)
   detect_confirmation_bias: DETECT_CONFIRMATION_BIAS,
   get_graph_structure_analysis: GET_GRAPH_STRUCTURE_ANALYSIS,
+  list_graph_intelligence_queries: LIST_GRAPH_INTELLIGENCE_QUERIES,
+  run_graph_intelligence_query: RUN_GRAPH_INTELLIGENCE_QUERY,
   get_falsification_questions: GET_FALSIFICATION_QUESTIONS,
   // Evidence operations (workhorse)
   search_evidence: SEARCH_EVIDENCE,
@@ -3611,6 +3833,7 @@ var MCP_TOOL_CONTRACTS = {
   get_agent_inbox: GET_AGENT_INBOX,
   claim_files: CLAIM_FILES,
   generate_session_handoff: GENERATE_SESSION_HANDOFF,
+  begin_build_session: BEGIN_BUILD_SESSION,
   // Policy / ACL (workhorse)
   check_permission: CHECK_PERMISSION,
   filter_by_permission: FILTER_BY_PERMISSION,