@lucern/contracts 1.0.0 → 1.0.1

package/dist/tool-contracts.questions-listing.js

@@ -0,0 +1,782 @@
+// src/tool-contracts.questions-listing.ts
+var CREATE_QUESTION = {
+  name: "create_question",
+  description: "Commit an investigation question to the reasoning graph. Like `git issue` \u2014 creates a traceable question that drives research and evidence collection. Questions test beliefs and guide worktree investigation.",
+  parameters: {
+    text: { type: "string", description: "The question text" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
+    priority: {
+      type: "string",
+      description: "Priority: urgent, high, medium, low",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    linkedBeliefId: {
+      type: "string",
+      description: "Belief this question tests"
+    },
+    metadata: {
+      type: "object",
+      description: "Optional metadata merged into the question record"
+    }
+  },
+  required: ["text"],
+  response: {
+    description: "The created canonical question record",
+    fields: {
+      id: "string \u2014 canonical question ID",
+      nodeId: "string \u2014 canonical question ID",
+      questionId: "string \u2014 canonical question ID",
+      text: "string",
+      status: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var GET_QUESTION = {
+  name: "get_question",
+  description: "Read one question by ID. Like `git show` \u2014 resolves the canonical question payload for a single identifier.",
+  parameters: {
+    id: { type: "string", description: "Canonical question ID" }
+  },
+  required: ["id"],
+  response: {
+    description: "The canonical question record",
+    fields: {
+      id: "string \u2014 canonical question ID",
+      nodeId: "string \u2014 canonical question ID",
+      questionId: "string \u2014 canonical question ID",
+      text: "string",
+      status: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var REFINE_QUESTION = {
+  name: "refine_question",
+  description: "Refine a question's framing or scope. Like `git commit --amend` for questions \u2014 updates the question text while preserving its identity and linked evidence.",
+  parameters: {
+    id: { type: "string", description: "The question to refine" },
+    text: { type: "string", description: "Updated question text" },
+    rationale: {
+      type: "string",
+      description: "Why the question is being refined"
+    }
+  },
+  required: ["id", "text"],
+  response: {
+    description: "The refined question",
+    fields: {
+      id: "string",
+      questionId: "string",
+      updatedText: "string",
+      previousText: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var LIST_QUESTIONS = {
+  name: "list_questions",
+  description: "List questions scoped to a topic or worktree. Like `git issue list` \u2014 returns questions with their status, priority, and linked belief context. Supports filtering by status and priority.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    worktreeId: { type: "string", description: "Filter to worktree scope" },
+    status: {
+      type: "string",
+      description: "Filter by canonical question status",
+      enum: ["open", "researching", "answered", "parked", "closed"]
+    },
+    priority: {
+      type: "string",
+      description: "Filter by canonical question priority",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    limit: { type: "number", description: "Max results" },
+    cursor: { type: "string", description: "Pagination cursor" }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Canonical question page",
+    fields: {
+      questions: "array \u2014 canonical question records",
+      nextCursor: "string | null"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var ANSWER_QUESTION = {
+  name: "answer_question",
+  description: "Answer a question with optional evidence links. Like `git commit` on the question thread \u2014 records the answer and closes the loop with a canonical answered state.",
+  parameters: {
+    id: { type: "string", description: "Canonical question ID" },
+    topicId: { type: "string", description: "Topic scope for the answer" },
+    text: { type: "string", description: "Answer text" },
+    confidence: {
+      type: "string",
+      description: "Optional answer confidence",
+      enum: ["weak", "medium", "strong"]
+    },
+    evidenceIds: {
+      type: "array",
+      description: "Optional canonical evidence IDs supporting the answer"
+    },
+    rationale: { type: "string", description: "Why this answer is credible" }
+  },
+  required: ["id", "topicId", "text"],
+  response: {
+    description: "Answer result",
+    fields: {
+      questionId: "string",
+      answerId: "string",
+      status: "string \u2014 answered"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var UPDATE_QUESTION_STATUS = {
+  name: "update_question_status",
+  description: "Transition a question's status through its lifecycle. Like `git issue update` \u2014 moves a question through the canonical reasoning lifecycle. Status transitions preserve history and keep linked evidence intact.",
+  parameters: {
+    id: { type: "string", description: "The question to update" },
+    status: {
+      type: "string",
+      description: "New status",
+      enum: ["open", "researching", "answered", "parked", "closed"]
+    },
+    rationale: { type: "string", description: "Why the status is changing" }
+  },
+  required: ["id", "status"],
+  response: {
+    description: "Updated question status",
+    fields: {
+      id: "string",
+      questionId: "string",
+      previousStatus: "string",
+      newStatus: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var ARCHIVE_QUESTION = {
+  name: "archive_question",
+  description: "Archive a question no longer relevant to current investigation scope. Like `git issue close` \u2014 removes it from active work while preserving audit history. Archived questions keep their existing links to beliefs and evidence.",
+  parameters: {
+    questionId: { type: "string", description: "The question to archive" },
+    reason: {
+      type: "string",
+      description: "Why the question is being archived"
+    }
+  },
+  required: ["questionId"],
+  response: {
+    description: "Archive confirmation",
+    fields: {
+      questionId: "string",
+      status: "string \u2014 'archived'",
+      archivedAt: "number"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var LINK_EVIDENCE_TO_QUESTION = {
+  name: "link_evidence_to_question",
+  description: "Link evidence to the question it helps answer. Like `git notes add` \u2014 attaches supporting detail to an active question. Question-level links improve answer quality and traceability to beliefs.",
+  parameters: {
+    evidenceId: { type: "string", description: "The evidence to link" },
+    questionId: {
+      type: "string",
+      description: "The question this evidence addresses"
+    },
+    relevance: { type: "number", description: "Relevance score in [0,1]" },
+    rationale: {
+      type: "string",
+      description: "How this evidence bears on the question"
+    }
+  },
+  required: ["evidenceId", "questionId"],
+  response: {
+    description: "The created edge",
+    fields: {
+      edgeId: "string",
+      evidenceId: "string",
+      questionId: "string",
+      relevance: "number"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "edge",
+  tier: "workhorse"
+};
+var CREATE_ANSWER = {
+  name: "create_answer",
+  description: "Create an answer node responding to a question. Like `git commit` for resolved questions \u2014 creates an immutable answer snapshot at L2. New answers supersede old ones, preserving full version history. Answers link to supporting evidence via based_on edges.",
+  parameters: {
+    questionNodeId: {
+      type: "string",
+      description: "The question node ID this answers"
+    },
+    answerText: {
+      type: "string",
+      description: "The answer content \u2014 the actual response to the question"
+    },
+    topicId: {
+      type: "string",
+      description: "Topic scope (optional if question already has topicId)"
+    },
+    confidence: {
+      type: "string",
+      description: "Answer confidence: definitive, strong, moderate, weak, speculative"
+    },
+    evidenceNodeIds: {
+      type: "array",
+      description: "Supporting evidence node IDs to link via based_on edges"
+    },
+    answerSource: {
+      type: "string",
+      description: "How the answer was produced: human, ai_generated, deep_research, synthesis"
+    }
+  },
+  required: ["questionNodeId", "answerText"],
+  response: {
+    description: "The created answer node with version metadata",
+    fields: {
+      nodeId: "string \u2014 unique node identifier",
+      globalId: "string \u2014 globally unique ID",
+      versionNumber: "number \u2014 version of this answer (auto-incremented)",
+      questionNodeId: "string \u2014 the question this answers",
+      confidence: "string \u2014 answer confidence level"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "evidence",
+  tier: "showcase"
+};
+var GET_ANSWER = {
+  name: "get_answer",
+  description: "Get the latest answer for a question. Like `git show HEAD` for a question's resolution \u2014 returns the active answer snapshot. Returns null if the question is unanswered.",
+  parameters: {
+    questionNodeId: {
+      type: "string",
+      description: "The question node ID to get the answer for"
+    }
+  },
+  required: ["questionNodeId"],
+  response: {
+    description: "The active answer node or null",
+    fields: {
+      nodeId: "string | null",
+      globalId: "string | null",
+      answerText: "string | null",
+      versionNumber: "number",
+      isLatest: "boolean",
+      evidenceCount: "number",
+      confidence: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse"
+};
+var GET_HIGH_PRIORITY_QUESTIONS = {
+  name: "get_high_priority_questions",
+  description: "Rank open questions by urgency and expected decision impact. Like `git issue list --sort=priority` \u2014 brings the highest-leverage open questions to the top. Ranking accounts for linked belief criticality and evidence gaps.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    limit: { type: "number", description: "Maximum results (default: 20)" },
+    includeAnswered: {
+      type: "boolean",
+      description: "Include answered questions (default: false)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Priority-ranked questions",
+    fields: {
+      questions: "array \u2014 { questionId, text, priority, urgencyScore, linkedBeliefCount, evidenceGapCount }"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var FIND_MISSING_QUESTIONS = {
+  name: "find_missing_questions",
+  description: "Identify beliefs missing testing questions. Like `git diff --check` \u2014 surfaces reasoning coverage gaps before merge. Returns candidate beliefs that need explicit question coverage.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    minConfidence: {
+      type: "number",
+      description: "Only check beliefs above this confidence (default: 0)"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Beliefs missing testing questions",
+    fields: {
+      gaps: "array \u2014 { beliefId, canonicalText, confidence, suggestedQuestions }",
+      totalGaps: "number"
+    }
+  },
+  ownerModule: "graph-search",
+  ontologyPrimitive: "question",
+  tier: "workhorse"
+};
+var LIST_BELIEFS = {
+  name: "list_beliefs",
+  description: "List beliefs scoped to a topic or worktree. Like `git log --oneline` \u2014 returns beliefs with their confidence, status, and scoring state. Supports filtering by status and confidence threshold.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    worktreeId: { type: "string", description: "Filter to worktree scope" },
+    status: {
+      type: "string",
+      description: "Filter: unscored, scored, archived",
+      enum: ["unscored", "scored", "archived"]
+    },
+    minConfidence: {
+      type: "number",
+      description: "Minimum confidence threshold"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum results"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Canonical belief page",
+    fields: {
+      beliefs: "array \u2014 canonical belief records",
+      nextCursor: "string | null"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "belief",
+  tier: "workhorse"
+};
+var LIST_WORKTREES = {
+  name: "list_worktrees",
+  description: "List all worktrees for a topic. Like `git worktree list` \u2014 shows active and completed investigation branches with lifecycle phase, pipeline campaign/lane, status, and belief counts.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope" },
+    status: {
+      type: "string",
+      description: "Filter: active, merged, abandoned",
+      enum: ["active", "merged", "abandoned"]
+    },
+    groupBy: {
+      type: "string",
+      description: "Optional grouping mode for the response.",
+      enum: ["campaign", "lane", "flat"]
+    },
+    lane: {
+      type: "string",
+      description: "Filter by GitButler-aligned lane name."
+    },
+    campaign: {
+      type: "number",
+      description: "Filter by top-level pipeline campaign number."
+    },
+    limit: {
+      type: "number",
+      description: "Maximum results to return."
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Worktrees with lifecycle phase, campaign, lane, status, belief count, and creation time",
+    fields: {
+      worktrees: "array \u2014 { worktreeId, title, phase, campaign, lane, laneOrderInCampaign, orderInLane, status, beliefCount, createdAt }"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var LIST_ALL_WORKTREES = {
+  name: "list_all_worktrees",
+  description: "List ALL worktrees across ALL topics in one query. No topic scope required. Like `git worktree list --all` \u2014 returns the complete pipeline inventory with campaign, lane, lane order, dependencies, and status. Supports filtering by status, lane, and campaign. This is the PM's primary pipeline query \u2014 one call, full picture.",
+  parameters: {
+    status: {
+      type: "string",
+      description: "Filter by status: planning, active, completed, abandoned, superseded, long_term, idea, paused, suggested, dismissed",
+      enum: [
+        "planning",
+        "active",
+        "completed",
+        "abandoned",
+        "superseded",
+        "long_term",
+        "idea",
+        "paused",
+        "suggested",
+        "dismissed"
+      ]
+    },
+    lane: {
+      type: "string",
+      description: "Filter by lane name (e.g., 'ontology', 'tc-scope', 'control-plane', 'dev-portal', 'mcp-sdk-parity')"
+    },
+    campaign: {
+      type: "number",
+      description: "Filter by campaign number (e.g., 1, 2, 3). Returns only worktrees in that campaign."
+    },
+    groupBy: {
+      type: "string",
+      description: "Optional grouping mode for the response.",
+      enum: ["campaign", "lane", "flat"]
+    },
+    limit: {
+      type: "number",
+      description: "Maximum results to return (default: 500, max: 1000)"
+    }
+  },
+  required: [],
+  response: {
+    description: "All worktrees across all topics with full pipeline metadata",
+    fields: {
+      worktrees: "array \u2014 { worktreeId, title, topicId, topicName, phase, status, hypothesis, campaign, lane, laneOrderInCampaign, orderInLane, dependsOn, blocks, gate, createdAt }",
+      total: "number \u2014 total count after filtering",
+      lanes: "object \u2014 { laneName: count } summary of worktrees per lane",
+      campaigns: "object \u2014 { campaignNumber: count } summary of worktrees per campaign"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+var GET_WORKTREE = {
+  name: "get_worktree",
+  description: "Get one worktree by ID. Like `git worktree list --porcelain <worktree>` \u2014 inspects one investigation branch without scanning the full pipeline inventory.",
+  parameters: {
+    worktreeId: { type: "string", description: "Canonical worktree ID to retrieve" },
+    id: { type: "string", description: "Legacy alias for worktreeId" }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "Single worktree record with pipeline metadata",
+    fields: {
+      worktree: "object \u2014 { worktreeId, title, topicId, status, hypothesis, campaign, lane, laneOrderInCampaign, orderInLane, dependsOn, blocks, gate }"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var LIST_CAMPAIGNS = {
+  name: "list_campaigns",
+  description: "List compact pipeline campaigns with their nested lanes. Use this to see the top-level campaign > lane > worktree shape without pulling the full worktree inventory.",
+  parameters: {
+    topicId: {
+      type: "string",
+      description: "Optional topic scope."
+    },
+    status: {
+      type: "string",
+      description: "Optional worktree status filter before grouping campaigns and lanes."
+    },
+    limit: {
+      type: "number",
+      description: "Maximum worktrees to scan before grouping."
+    }
+  },
+  required: [],
+  response: {
+    description: "Pipeline campaigns with nested lane summaries.",
+    fields: {
+      campaigns: "array \u2014 { campaign, lanes: [{ lane, laneOrderInCampaign, worktreeCount, activeCount, readyCount, blockedCount, completedCount, nextWorktree }] }",
+      totalWorktrees: "number \u2014 total worktrees scanned after filtering"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+var ACTIVATE_WORKTREE = {
+  name: "activate_worktree",
+  description: "Activate a worktree to begin investigation. Like `git checkout <branch>` \u2014 transitions a worktree from planning to active status. Sets the initial phase and enables belief/question editing within the worktree scope.",
+  parameters: {
+    worktreeId: { type: "string", description: "The worktree to activate" }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "Activation result with initial phase",
+    fields: {
+      worktreeId: "string",
+      status: "string \u2014 'active'",
+      phase: "string"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var UPDATE_WORKTREE_TARGETS = {
+  name: "update_worktree_targets",
+  description: "Update the target beliefs and questions tracked by a worktree. Like `git add/rm <files>` \u2014 stages or unstages beliefs/questions for investigation within the worktree scope. Supports adding and removing targets atomically.",
+  parameters: {
+    worktreeId: { type: "string", description: "The worktree to update" },
+    addBeliefIds: {
+      type: "array",
+      description: "Belief node IDs to add to the worktree"
+    },
+    addQuestionIds: {
+      type: "array",
+      description: "Question node IDs to add to the worktree"
+    },
+    removeBeliefIds: {
+      type: "array",
+      description: "Belief node IDs to remove from the worktree"
+    },
+    removeQuestionIds: {
+      type: "array",
+      description: "Question node IDs to remove from the worktree"
+    }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "Updated target counts",
+    fields: {
+      worktreeId: "string",
+      beliefCount: "number",
+      questionCount: "number"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var UPDATE_WORKTREE_METADATA = {
+  name: "update_worktree_metadata",
+  description: "Update worktree sequencing metadata \u2014 campaign, lane, dependencies, blocking relations, and gates. Like `git config` for a worktree \u2014 sets the scheduling and dependency metadata that determines when this worktree can activate relative to others. Use to backfill or correct sequencing data.",
+  parameters: {
+    worktreeId: { type: "string", description: "The worktree to update" },
+    hypothesis: {
+      type: "string",
+      description: "Testable claim this worktree investigates"
+    },
+    campaign: {
+      type: "number",
+      description: "Top-level pipeline campaign number."
+    },
+    lane: {
+      type: "string",
+      description: "GitButler-aligned workstream lane name inside the campaign."
+    },
+    laneOrderInCampaign: {
+      type: "number",
+      description: "Ordering for this lane within the campaign."
+    },
+    orderInLane: {
+      type: "number",
+      description: "Position of this worktree inside its lane."
+    },
+    dependsOn: {
+      type: "array",
+      description: "Worktree IDs that must complete before this one can activate"
+    },
+    blocks: {
+      type: "array",
+      description: "Worktree IDs that are blocked until this one completes"
+    },
+    gate: {
+      type: "string",
+      description: "Exit gate name (e.g., 'gate:ontology-schema-hardened')"
+    },
+    rationale: {
+      type: "string",
+      description: "Why this worktree is sequenced here"
+    },
+    objective: {
+      type: "string",
+      description: "What we're trying to learn/prove"
+    },
+    proofArtifacts: {
+      type: "array",
+      description: "Typed proof artifacts that define what evidence or deliverables this worktree must emit before it can claim success."
+    },
+    staffingHint: {
+      type: "string",
+      description: "Advisory staffing shape for the worktree (for example `backend+tests` or `fullstack`)."
+    },
+    lastReconciledAt: {
+      type: "number",
+      description: "Timestamp of the last deterministic workflow reconciliation pass against this worktree."
+    },
+    autoFixPolicy: {
+      type: "object",
+      description: "Calibrated auto-fix policy controlling dry-run vs safe execution, per-run action caps, and permitted mutation tiers."
+    },
+    status: {
+      type: "string",
+      description: "Override the worktree status. Use for lifecycle transitions like marking a worktree superseded, long-term, or as a raw idea.",
+      enum: [
+        "suggested",
+        "planning",
+        "active",
+        "paused",
+        "completed",
+        "dismissed",
+        "abandoned",
+        "superseded",
+        "long_term",
+        "idea"
+      ]
+    },
+    topicId: {
+      type: "string",
+      description: "Reassign this worktree's primary topic. Validates the target topic exists before updating."
+    },
+    additionalTopicIds: {
+      type: "array",
+      description: "Set additional topic associations for cross-topic worktrees. Each topic ID is validated before updating. Use when a worktree spans multiple knowledge domains."
+    }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "Update confirmation",
+    fields: { worktreeId: "string", success: "boolean" }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var IDENTITY_WHOAMI = {
+  name: "identity_whoami",
+  description: "Read the authenticated identity summary for the current session. Like `git config --get user.name` \u2014 shows who the current MCP session is acting as.",
+  parameters: {},
+  required: [],
+  response: {
+    description: "Canonical identity summary for the current session",
+    fields: {
+      principalId: "string \u2014 canonical principal identifier; for humans this is the Clerk user_... ID",
+      principalType: "string \u2014 human, service, agent, group, or external_viewer",
+      tenantId: "string | undefined \u2014 resolved tenant scope",
+      workspaceId: "string | undefined \u2014 resolved workspace scope",
+      scopes: "string[] | undefined \u2014 granted scopes for this session",
+      roles: "string[] | undefined \u2014 canonical roles for this session"
+    }
+  },
+  ownerModule: "identity-core",
+  ontologyPrimitive: "identity",
+  tier: "workhorse"
+};
+var RESOLVE_INTERACTIVE_PRINCIPAL = {
+  name: "resolve_interactive_principal",
+  description: "Read the Permit-backed Lucern principal context for an authenticated Clerk user. Like `git config --get user.email` plus the repository ACL \u2014 resolves the Clerk subject into tenant/workspace authorization context.",
+  parameters: {
+    clerkId: {
+      type: "string",
+      description: "Authenticated Clerk subject (`sub`). Clerk proves identity only; it is not the authorization record."
+    },
+    tenantId: {
+      type: "string",
+      description: "Optional tenant scope. Omit only when the Clerk alias is globally unambiguous."
+    },
+    workspaceId: {
+      type: "string",
+      description: "Optional workspace scope. Required when the principal has access to multiple workspaces and no default can be inferred."
+    },
+    providerProjectId: {
+      type: "string",
+      description: "Optional Clerk project or provider instance id for tenants with multiple identity providers."
+    }
+  },
+  required: ["clerkId"],
+  response: {
+    description: "Permit-backed Lucern principal context for tenant SDK bootstrap",
+    fields: {
+      principalId: "string \u2014 canonical Clerk user_... ID for human sessions",
+      principalType: "string \u2014 human, service, agent, group, or external_viewer",
+      clerkId: "string \u2014 authenticated Clerk subject alias",
+      tenantId: "string \u2014 resolved tenant scope",
+      workspaceId: "string | null \u2014 resolved workspace scope",
+      roles: "string[] \u2014 effective Permit roles",
+      scopes: "string[] \u2014 effective scopes derived from Permit/control-plane projection",
+      groupIds: "string[] \u2014 active Permit group memberships",
+      principalStatus: "string \u2014 active, invited, suspended, disabled, revoked, or missing",
+      tenantStatus: "string \u2014 projected tenant resource status",
+      workspaceStatus: "string \u2014 projected workspace resource status",
+      permit: "object \u2014 Permit subject, tenant, and optional workspace tuple"
+    }
+  },
+  ownerModule: "control-plane",
+  ontologyPrimitive: "identity",
+  tier: "workhorse"
+};
+var COMPILE_CONTEXT = {
+  name: "compile_context",
+  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: "Optional topic scope ID. Omit to resolve the topic from query."
+    },
+    query: {
+      type: "string",
+      description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
+    },
+    budget: {
+      type: "number",
+      description: "Token budget for prompt injection planning"
+    },
+    ranking: {
+      type: "string",
+      description: "Ranking profile for context ordering",
+      enum: ["baseline_v1", "weighted_v1"]
+    },
+    limit: {
+      type: "number",
+      description: "Optional per-section item limit"
+    },
+    maxDepth: {
+      type: "number",
+      description: "Optional descendant topic depth for neighborhood expansion"
+    },
+    includeEntities: {
+      type: "boolean",
+      description: "Include related ontological entities in the compiled result"
+    }
+  },
+  required: [],
+  response: {
+    description: "Compiled context pack for the requested topic",
+    fields: {
+      schemaVersion: "string",
+      topicId: "string",
+      topicName: "string",
+      scopedTopicIds: "array \u2014 topic IDs included in the compilation neighborhood",
+      generatedAt: "number \u2014 deterministic graph-backed reference timestamp for this compilation",
+      ranking: "string \u2014 baseline_v1 | weighted_v1",
+      summary: "object \u2014 counts and scoped health signals",
+      invariants: "array \u2014 high-confidence invariant beliefs",
+      activeBeliefs: "array \u2014 current high-signal beliefs",
+      openQuestions: "array \u2014 unresolved questions ranked for this query",
+      recentEvidence: "array \u2014 recent evidence ranked for this query",
+      contradictions: "array \u2014 unresolved contradiction records",
+      relatedEntities: "array | undefined \u2014 ranked ontological entities in scope",
+      contextNarrative: "array \u2014 guidance for prompt assembly",
+      injectionPolicy: "object \u2014 token-budgeted section selections",
+      diagnostics: "object \u2014 scoring and utilization telemetry"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+
+export { ACTIVATE_WORKTREE, ANSWER_QUESTION, ARCHIVE_QUESTION, COMPILE_CONTEXT, CREATE_ANSWER, CREATE_QUESTION, FIND_MISSING_QUESTIONS, GET_ANSWER, GET_HIGH_PRIORITY_QUESTIONS, GET_QUESTION, GET_WORKTREE, IDENTITY_WHOAMI, LINK_EVIDENCE_TO_QUESTION, LIST_ALL_WORKTREES, LIST_BELIEFS, LIST_CAMPAIGNS, LIST_QUESTIONS, LIST_WORKTREES, REFINE_QUESTION, RESOLVE_INTERACTIVE_PRINCIPAL, UPDATE_QUESTION_STATUS, UPDATE_WORKTREE_METADATA, UPDATE_WORKTREE_TARGETS };
+//# sourceMappingURL=tool-contracts.questions-listing.js.map
+//# sourceMappingURL=tool-contracts.questions-listing.js.map