@lucern/contracts 1.0.0 → 1.0.1

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

@@ -0,0 +1,8 @@
+import { McpToolContract } from './tool-contracts.types.js';
+
+declare const ADD_WORKTREE: McpToolContract;
+declare const MERGE: McpToolContract;
+declare const PUSH: McpToolContract;
+declare const OPEN_PULL_REQUEST: McpToolContract;
+
+export { ADD_WORKTREE, MERGE, OPEN_PULL_REQUEST, PUSH };

package/dist/tool-contracts.worktrees.js

@@ -0,0 +1,280 @@
+// src/tool-contracts.worktrees.ts
+var ADD_WORKTREE = {
+  name: "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 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"
+    },
+    branchId: {
+      type: "string",
+      description: "The branch this worktree investigates"
+    },
+    objective: {
+      type: "string",
+      description: "Plain-text reasoning objective to auto-shape into a hypothesis, questions, tasks, and dependencies"
+    },
+    hypothesis: {
+      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: "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"
+    },
+    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."
+    },
+    lane: {
+      type: "string",
+      description: "GitButler-aligned workstream lane name inside the campaign."
+    },
+    laneOrderInCampaign: {
+      type: "number",
+      description: "Ordering for this lane within its 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 blocked by this worktree"
+    },
+    staffingHint: {
+      type: "string",
+      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"],
+  response: {
+    description: "The created worktree",
+    fields: {
+      worktreeId: "string",
+      branchId: "string | null",
+      status: "string \u2014 usually 'planning' or 'active'",
+      title: "string",
+      hypothesis: "string | null",
+      questionCount: "number",
+      taskCount: "number",
+      autoShapeApplied: "boolean",
+      frameworkSuggestions: "array",
+      dependencySuggestions: "array"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+var MERGE = {
+  name: "merge",
+  description: "Merge a worktree's findings into the stable knowledge base (main). Like `git merge` to main \u2014 formulations freeze, confidence is recorded, findings are integrated. Each belief gets a confidence score and rationale. After merge, beliefs can only evolve via fork. Low-confidence beliefs may need forking.",
+  parameters: {
+    worktreeId: { type: "string", description: "The worktree to merge" },
+    outcomes: {
+      type: "array",
+      description: "Merge outcomes as key-finding strings, or scoring outcomes for beliefs: { beliefId, confidence, rationale }"
+    },
+    summary: { type: "string", description: "Overall findings summary" }
+  },
+  required: ["worktreeId", "outcomes"],
+  response: {
+    description: "Merge result",
+    fields: {
+      worktreeId: "string",
+      status: "string \u2014 'merged'",
+      beliefsScored: "number"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+var PUSH = {
+  name: "push",
+  description: "Push scored beliefs from a merged worktree to other contexts. Like `git push` \u2014 makes local findings available on the remote. Only merged beliefs can be pushed. Publication makes findings visible to other projects, teams, or external consumers.",
+  parameters: {
+    worktreeId: {
+      type: "string",
+      description: "The merged worktree whose findings to push"
+    },
+    targetContext: {
+      type: "string",
+      description: "Where to push (e.g., 'portfolio', 'ic_review', 'external')"
+    },
+    beliefIds: {
+      type: "array",
+      description: "Optional subset of beliefs to push (default: all scored)"
+    }
+  },
+  required: ["worktreeId", "targetContext"],
+  response: {
+    description: "Push result",
+    fields: {
+      pushedCount: "number",
+      targetContext: "string",
+      pushedAt: "number"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "workhorse"
+};
+var OPEN_PULL_REQUEST = {
+  name: "open_pull_request",
+  description: "Open a pull request for peer review before merging a worktree. Like opening a `git pull request` \u2014 the worktree's findings are ready but await approval before merge. Reviewers can approve, request changes, or block the merge. This is the gate between draft work and scored knowledge.",
+  parameters: {
+    worktreeId: {
+      type: "string",
+      description: "The worktree to submit for review"
+    },
+    reviewers: {
+      type: "array",
+      description: "User IDs of requested reviewers"
+    },
+    summary: {
+      type: "string",
+      description: "Summary of findings and why they're ready for merge"
+    }
+  },
+  required: ["worktreeId", "summary"],
+  response: {
+    description: "The pull request",
+    fields: {
+      pullRequestId: "string",
+      worktreeId: "string",
+      status: "string \u2014 'pending_review'"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+
+export { ADD_WORKTREE, MERGE, OPEN_PULL_REQUEST, PUSH };
+//# sourceMappingURL=tool-contracts.worktrees.js.map
+//# sourceMappingURL=tool-contracts.worktrees.js.map

package/dist/tool-contracts.worktrees.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-contracts.worktrees.ts"],"names":[],"mappings":"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","file":"tool-contracts.worktrees.js","sourcesContent":["import type { McpToolContract } from \"./tool-contracts.types\";\n\nexport const ADD_WORKTREE: McpToolContract = {\n  name: \"add_worktree\",\n  description:\n    \"Check out a branch into an active worktree for investigation. \" +\n    \"Like `git worktree add <branch>` — creates independent working state on a thematic branch. \" +\n    \"Beliefs committed within the worktree can be freely amended (draft code on a feature branch). \" +\n    \"When investigation is complete, `merge` integrates findings into main.\",\n  parameters: {\n    title: { type: \"string\", description: \"Worktree name/objective\" },\n    name: {\n      type: \"string\",\n      description:\n        \"Optional storage-name alias for callers that already use backend naming\",\n    },\n    projectId: {\n      type: \"string\",\n      description: \"Legacy topicId alias or resolver hint\",\n    },\n    topicId: {\n      type: \"string\",\n      description: \"Optional topic scope hint for resolver validation\",\n    },\n    topicHint: {\n      type: \"string\",\n      description: \"Natural-language topic hint for automatic topic resolution\",\n    },\n    branchId: {\n      type: \"string\",\n      description: \"The branch this worktree investigates\",\n    },\n    objective: {\n      type: \"string\",\n      description:\n        \"Plain-text reasoning objective to auto-shape into a hypothesis, questions, tasks, and dependencies\",\n    },\n    hypothesis: {\n      type: \"string\",\n      description: \"The testable claim this worktree investigates\",\n    },\n    rationale: {\n      type: \"string\",\n      description:\n        \"Why this worktree exists and why it belongs in the campaign\",\n    },\n    worktreeType: {\n      type: \"string\",\n      description:\n        \"Schema-enum worktree type used by the kernel lifecycle and retrieval layers\",\n    },\n    gate: {\n      type: \"string\",\n      description: \"Exit gate name for this worktree\",\n    },\n    startDate: {\n      type: \"number\",\n      description: \"Planned start timestamp in milliseconds since epoch\",\n    },\n    endDate: {\n      type: \"number\",\n      description: \"Planned end timestamp in milliseconds since epoch\",\n    },\n    durationWeeks: {\n      type: \"number\",\n      description: \"Planned duration in weeks\",\n    },\n    confidenceImpact: {\n      type: \"string\",\n      description: \"Expected confidence impact if the worktree succeeds\",\n      enum: [\"high\", \"medium\", \"low\"],\n    },\n    beliefFocus: {\n      type: \"string\",\n      description:\n        \"Natural-language focus spanning the target belief neighborhood\",\n    },\n    beliefIds: {\n      type: \"array\",\n      description: \"Legacy alias for targetBeliefIds\",\n    },\n    beliefs: {\n      type: \"array\",\n      description: \"Legacy alias for targetBeliefIds\",\n    },\n    targetBeliefIds: {\n      type: \"array\",\n      description: \"Belief node IDs this worktree is expected to test or update\",\n    },\n    targetQuestionIds: {\n      type: \"array\",\n      description: \"Question node IDs this worktree is expected to answer\",\n    },\n    keyQuestions: {\n      type: \"array\",\n      description:\n        \"Inline key question objects with question, optional status, answer, answerConfidence, and linkedQuestionId\",\n    },\n    evidenceSignals: {\n      type: \"array\",\n      description:\n        \"Evidence signal objects with signal, optional collected state, progress, and notes\",\n    },\n    decisionGate: {\n      type: \"object\",\n      description:\n        \"Decision gate object with goCriteria, noGoSignals, optional verdict, rationale, decidedAt, and decidedBy\",\n    },\n    goCriteria: {\n      type: \"array\",\n      description: \"Shorthand go criteria used to build decisionGate\",\n    },\n    noGoSignals: {\n      type: \"array\",\n      description: \"Shorthand no-go signals used to build decisionGate\",\n    },\n    proofArtifacts: {\n      type: \"array\",\n      description: \"Expected proof artifacts required to close the worktree\",\n    },\n    autoShape: {\n      type: \"boolean\",\n      description:\n        \"Whether to invoke inquiry auto-shaping during worktree creation\",\n    },\n    autoFixPolicy: {\n      type: \"object\",\n      description:\n        \"Policy for permitted automatic remediation inside the worktree\",\n    },\n    domainPackId: {\n      type: \"string\",\n      description:\n        \"Optional domain pack whose shaping hooks should influence generated questions and tasks\",\n    },\n    tags: {\n      type: \"array\",\n      description: \"Additional topic-resolution tags for the worktree\",\n    },\n    touchedPaths: {\n      type: \"array\",\n      description: \"File paths used as topic-resolution signals\",\n    },\n    sourceRef: {\n      type: \"string\",\n      description: \"Source reference used as a topic-resolution signal\",\n    },\n    sourceKind: {\n      type: \"string\",\n      description: \"Source kind used as a topic-resolution signal\",\n    },\n    campaign: {\n      type: \"number\",\n      description:\n        \"Top-level pipeline campaign number. Campaigns define the outer execution slice.\",\n    },\n    lane: {\n      type: \"string\",\n      description:\n        \"GitButler-aligned workstream lane name inside the campaign.\",\n    },\n    laneOrderInCampaign: {\n      type: \"number\",\n      description:\n        \"Ordering for this lane within its campaign.\",\n    },\n    orderInLane: {\n      type: \"number\",\n      description:\n        \"Position of this worktree inside its lane.\",\n    },\n    dependsOn: {\n      type: \"array\",\n      description: \"Worktree IDs that must complete before this one can activate\",\n    },\n    blocks: {\n      type: \"array\",\n      description: \"Worktree IDs blocked by this worktree\",\n    },\n    staffingHint: {\n      type: \"string\",\n      description: \"Suggested staffing or agent allocation note\",\n    },\n    lensId: {\n      type: \"string\",\n      description: \"Lens that scopes this worktree when applicable\",\n    },\n    lastReconciledAt: {\n      type: \"number\",\n      description: \"Timestamp when worktree metadata was last reconciled\",\n    },\n  },\n  required: [\"title\"],\n  response: {\n    description: \"The created worktree\",\n    fields: {\n      worktreeId: \"string\",\n      branchId: \"string | null\",\n      status: \"string — usually 'planning' or 'active'\",\n      title: \"string\",\n      hypothesis: \"string | null\",\n      questionCount: \"number\",\n      taskCount: \"number\",\n      autoShapeApplied: \"boolean\",\n      frameworkSuggestions: \"array\",\n      dependencySuggestions: \"array\",\n    },\n  },\n  ownerModule: \"workflow-engine\",\n  ontologyPrimitive: \"worktree\",\n  tier: \"showcase\",\n};\n\nexport const MERGE: McpToolContract = {\n  name: \"merge\",\n  description:\n    \"Merge a worktree's findings into the stable knowledge base (main). \" +\n    \"Like `git merge` to main — formulations freeze, confidence is recorded, findings are integrated. \" +\n    \"Each belief gets a confidence score and rationale. After merge, beliefs can only evolve via fork. \" +\n    \"Low-confidence beliefs may need forking.\",\n  parameters: {\n    worktreeId: { type: \"string\", description: \"The worktree to merge\" },\n    outcomes: {\n      type: \"array\",\n      description:\n        \"Merge outcomes as key-finding strings, or scoring outcomes for beliefs: { beliefId, confidence, rationale }\",\n    },\n    summary: { type: \"string\", description: \"Overall findings summary\" },\n  },\n  required: [\"worktreeId\", \"outcomes\"],\n  response: {\n    description: \"Merge result\",\n    fields: {\n      worktreeId: \"string\",\n      status: \"string — 'merged'\",\n      beliefsScored: \"number\",\n    },\n  },\n  ownerModule: \"workflow-engine\",\n  ontologyPrimitive: \"worktree\",\n  tier: \"showcase\",\n};\n\n// =============================================================================\n// LINEAGE AND AUDIT TOOLS\n// =============================================================================\n\nexport const PUSH: McpToolContract = {\n  name: \"push\",\n  description:\n    \"Push scored beliefs from a merged worktree to other contexts. \" +\n    \"Like `git push` — makes local findings available on the remote. \" +\n    \"Only merged beliefs can be pushed. \" +\n    \"Publication makes findings visible to other projects, teams, or external consumers.\",\n  parameters: {\n    worktreeId: {\n      type: \"string\",\n      description: \"The merged worktree whose findings to push\",\n    },\n    targetContext: {\n      type: \"string\",\n      description: \"Where to push (e.g., 'portfolio', 'ic_review', 'external')\",\n    },\n    beliefIds: {\n      type: \"array\",\n      description: \"Optional subset of beliefs to push (default: all scored)\",\n    },\n  },\n  required: [\"worktreeId\", \"targetContext\"],\n  response: {\n    description: \"Push result\",\n    fields: {\n      pushedCount: \"number\",\n      targetContext: \"string\",\n      pushedAt: \"number\",\n    },\n  },\n  ownerModule: \"workflow-engine\",\n  ontologyPrimitive: \"worktree\",\n  tier: \"workhorse\",\n};\n\n// =============================================================================\n// PULL REQUEST TOOLS (git pull request)\n// =============================================================================\n\nexport const OPEN_PULL_REQUEST: McpToolContract = {\n  name: \"open_pull_request\",\n  description:\n    \"Open a pull request for peer review before merging a worktree. \" +\n    \"Like opening a `git pull request` — the worktree's findings are ready but await approval before merge. \" +\n    \"Reviewers can approve, request changes, or block the merge. \" +\n    \"This is the gate between draft work and scored knowledge.\",\n  parameters: {\n    worktreeId: {\n      type: \"string\",\n      description: \"The worktree to submit for review\",\n    },\n    reviewers: {\n      type: \"array\",\n      description: \"User IDs of requested reviewers\",\n    },\n    summary: {\n      type: \"string\",\n      description: \"Summary of findings and why they're ready for merge\",\n    },\n  },\n  required: [\"worktreeId\", \"summary\"],\n  response: {\n    description: \"The pull request\",\n    fields: {\n      pullRequestId: \"string\",\n      worktreeId: \"string\",\n      status: \"string — 'pending_review'\",\n    },\n  },\n  ownerModule: \"workflow-engine\",\n  ontologyPrimitive: \"worktree\",\n  tier: \"showcase\",\n};\n\n// =============================================================================\n// FORENSIC TOOLS (git bisect)\n// =============================================================================\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/contracts",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -195,19 +195,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "convex": "^1.17.0",
     "typescript": "^5.7.0",
     "zod": "^3.23.0"
   },
-  "peerDependencies": {
-    "convex": "^1.17.0"
-  },
-  "peerDependenciesMeta": {
-    "convex": {
-      "optional": true
-    }
-  },
   "devDependencies": {
-    "tsup": "^8.5.0",
-    "typescript": "^5.7.0"
+    "tsup": "^8.5.0"
   }
 }

package/dist/dsl-DVPthQGY.d.ts

@@ -1,110 +0,0 @@
-import { a as FunctionContract, F as FunctionEffect, d as defineFunction } from './defineFunction-DO97DKs4.js';
-import { a as TableIndex, b as TableComponent, T as TableContract, c as TableDeprecation, d as defineTable } from './defineTable-t1wr5wgn.js';
-import { a as CONVEX_ID_TABLE, C as ConvexIdSchema, g as getConvexIdTable, i as idOf } from './idOf-DR8tkhQS.js';
-import { z, ZodTypeAny } from 'zod';
-
-type AdapterKind = "convex" | "jsonschema" | "cli";
-type AdapterPurpose = "table" | "function_args" | "function_returns";
-type AdapterContext = {
-    adapter: AdapterKind;
-    purpose?: AdapterPurpose;
-    location?: string;
-    path?: readonly string[];
-};
-declare class SchemaAdapterError extends Error {
-    readonly context: AdapterContext;
-    constructor(message: string, context: AdapterContext);
-}
-declare function schemaAdapterError(message: string, context: AdapterContext): SchemaAdapterError;
-
-type CliOptionKind = "string" | "number" | "bigint" | "boolean" | "json";
-type CliOptionSpec = {
-    name: string;
-    kind: CliOptionKind;
-    required: boolean;
-    variadic?: boolean;
-    nullable?: boolean;
-    choices?: readonly (string | number | boolean)[];
-    defaultValue?: unknown;
-    description?: string;
-};
-type CliCommandSpec = {
-    options: readonly CliOptionSpec[];
-};
-type ZodToCliOptions = {
-    location?: string;
-};
-declare function zodToCli(schema: z.ZodObject<z.ZodRawShape>, options?: ZodToCliOptions): CliCommandSpec;
-
-type ConvexDefault = {
-    path: readonly string[];
-    value: unknown;
-};
-type ZodToConvexOptions = {
-    purpose?: AdapterPurpose;
-    location?: string;
-};
-type ZodToConvexResult = {
-    source: string;
-    defaults: readonly ConvexDefault[];
-};
-declare function zodToConvex(schema: ZodTypeAny, options?: ZodToConvexOptions): ZodToConvexResult;
-declare function tableIndexToConvexSource(index: TableIndex): string;
-
-type JsonSchema = boolean | {
-    $schema?: string;
-    type?: string | readonly string[];
-    properties?: Record<string, JsonSchema>;
-    required?: readonly string[];
-    additionalProperties?: boolean | JsonSchema;
-    items?: JsonSchema;
-    enum?: readonly (string | number | boolean)[];
-    const?: string | number | boolean | null;
-    anyOf?: readonly JsonSchema[];
-    oneOf?: readonly JsonSchema[];
-    default?: unknown;
-    format?: string;
-    description?: string;
-    [key: string]: unknown;
-};
-type ZodToJsonSchemaOptions = {
-    location?: string;
-};
-declare function zodToJsonSchema(schema: ZodTypeAny, options?: ZodToJsonSchemaOptions): JsonSchema;
-
-type dsl_AdapterContext = AdapterContext;
-type dsl_AdapterKind = AdapterKind;
-type dsl_AdapterPurpose = AdapterPurpose;
-declare const dsl_CONVEX_ID_TABLE: typeof CONVEX_ID_TABLE;
-type dsl_CliCommandSpec = CliCommandSpec;
-type dsl_CliOptionKind = CliOptionKind;
-type dsl_CliOptionSpec = CliOptionSpec;
-type dsl_ConvexDefault = ConvexDefault;
-declare const dsl_ConvexIdSchema: typeof ConvexIdSchema;
-declare const dsl_FunctionContract: typeof FunctionContract;
-declare const dsl_FunctionEffect: typeof FunctionEffect;
-type dsl_JsonSchema = JsonSchema;
-type dsl_SchemaAdapterError = SchemaAdapterError;
-declare const dsl_SchemaAdapterError: typeof SchemaAdapterError;
-declare const dsl_TableComponent: typeof TableComponent;
-declare const dsl_TableContract: typeof TableContract;
-declare const dsl_TableDeprecation: typeof TableDeprecation;
-declare const dsl_TableIndex: typeof TableIndex;
-type dsl_ZodToCliOptions = ZodToCliOptions;
-type dsl_ZodToConvexOptions = ZodToConvexOptions;
-type dsl_ZodToConvexResult = ZodToConvexResult;
-type dsl_ZodToJsonSchemaOptions = ZodToJsonSchemaOptions;
-declare const dsl_defineFunction: typeof defineFunction;
-declare const dsl_defineTable: typeof defineTable;
-declare const dsl_getConvexIdTable: typeof getConvexIdTable;
-declare const dsl_idOf: typeof idOf;
-declare const dsl_schemaAdapterError: typeof schemaAdapterError;
-declare const dsl_tableIndexToConvexSource: typeof tableIndexToConvexSource;
-declare const dsl_zodToCli: typeof zodToCli;
-declare const dsl_zodToConvex: typeof zodToConvex;
-declare const dsl_zodToJsonSchema: typeof zodToJsonSchema;
-declare namespace dsl {
-  export { type dsl_AdapterContext as AdapterContext, type dsl_AdapterKind as AdapterKind, type dsl_AdapterPurpose as AdapterPurpose, dsl_CONVEX_ID_TABLE as CONVEX_ID_TABLE, type dsl_CliCommandSpec as CliCommandSpec, type dsl_CliOptionKind as CliOptionKind, type dsl_CliOptionSpec as CliOptionSpec, type dsl_ConvexDefault as ConvexDefault, dsl_ConvexIdSchema as ConvexIdSchema, dsl_FunctionContract as FunctionContract, dsl_FunctionEffect as FunctionEffect, type dsl_JsonSchema as JsonSchema, dsl_SchemaAdapterError as SchemaAdapterError, dsl_TableComponent as TableComponent, dsl_TableContract as TableContract, dsl_TableDeprecation as TableDeprecation, dsl_TableIndex as TableIndex, type dsl_ZodToCliOptions as ZodToCliOptions, type dsl_ZodToConvexOptions as ZodToConvexOptions, type dsl_ZodToConvexResult as ZodToConvexResult, type dsl_ZodToJsonSchemaOptions as ZodToJsonSchemaOptions, dsl_defineFunction as defineFunction, dsl_defineTable as defineTable, dsl_getConvexIdTable as getConvexIdTable, dsl_idOf as idOf, dsl_schemaAdapterError as schemaAdapterError, dsl_tableIndexToConvexSource as tableIndexToConvexSource, dsl_zodToCli as zodToCli, dsl_zodToConvex as zodToConvex, dsl_zodToJsonSchema as zodToJsonSchema };
-}
-
-export { type AdapterContext as A, type CliCommandSpec as C, type JsonSchema as J, SchemaAdapterError as S, type ZodToCliOptions as Z, type AdapterKind as a, type AdapterPurpose as b, type CliOptionKind as c, dsl as d, type CliOptionSpec as e, type ConvexDefault as f, type ZodToConvexOptions as g, type ZodToConvexResult as h, type ZodToJsonSchemaOptions as i, zodToConvex as j, zodToJsonSchema as k, schemaAdapterError as s, tableIndexToConvexSource as t, zodToCli as z };

package/dist/index-CM1Pl_vI.d.ts

@@ -1,28 +0,0 @@
-import { EDGE_TYPE, EDGE_TYPE_VALUES, NODE_TYPE, STORAGE_EDGE_TYPE, STORAGE_EDGE_TYPE_VALUES, TOPIC_STATUS, TOPIC_VISIBILITY } from './schemas/enums.js';
-import { ALL_TABLE_CONTRACTS, CONTROL_PLANE_TABLE_CONTRACTS, KERNEL_TABLE_CONTRACTS, MC_TABLE_CONTRACTS, TABLE_CONTRACTS_BY_COMPONENT, getTableContract, listTableContractsByName } from './schemas/manifest.js';
-import { ComponentTableManifest, ComponentTableManifestSchema } from './schemas/component-table-manifest.js';
-import { SLOpinionInput, SLOpinionInputSchema } from './schemas/sl-opinion.js';
-
-declare const index_ALL_TABLE_CONTRACTS: typeof ALL_TABLE_CONTRACTS;
-declare const index_CONTROL_PLANE_TABLE_CONTRACTS: typeof CONTROL_PLANE_TABLE_CONTRACTS;
-declare const index_ComponentTableManifest: typeof ComponentTableManifest;
-declare const index_ComponentTableManifestSchema: typeof ComponentTableManifestSchema;
-declare const index_EDGE_TYPE: typeof EDGE_TYPE;
-declare const index_EDGE_TYPE_VALUES: typeof EDGE_TYPE_VALUES;
-declare const index_KERNEL_TABLE_CONTRACTS: typeof KERNEL_TABLE_CONTRACTS;
-declare const index_MC_TABLE_CONTRACTS: typeof MC_TABLE_CONTRACTS;
-declare const index_NODE_TYPE: typeof NODE_TYPE;
-declare const index_SLOpinionInput: typeof SLOpinionInput;
-declare const index_SLOpinionInputSchema: typeof SLOpinionInputSchema;
-declare const index_STORAGE_EDGE_TYPE: typeof STORAGE_EDGE_TYPE;
-declare const index_STORAGE_EDGE_TYPE_VALUES: typeof STORAGE_EDGE_TYPE_VALUES;
-declare const index_TABLE_CONTRACTS_BY_COMPONENT: typeof TABLE_CONTRACTS_BY_COMPONENT;
-declare const index_TOPIC_STATUS: typeof TOPIC_STATUS;
-declare const index_TOPIC_VISIBILITY: typeof TOPIC_VISIBILITY;
-declare const index_getTableContract: typeof getTableContract;
-declare const index_listTableContractsByName: typeof listTableContractsByName;
-declare namespace index {
-  export { index_ALL_TABLE_CONTRACTS as ALL_TABLE_CONTRACTS, index_CONTROL_PLANE_TABLE_CONTRACTS as CONTROL_PLANE_TABLE_CONTRACTS, index_ComponentTableManifest as ComponentTableManifest, index_ComponentTableManifestSchema as ComponentTableManifestSchema, index_EDGE_TYPE as EDGE_TYPE, index_EDGE_TYPE_VALUES as EDGE_TYPE_VALUES, index_KERNEL_TABLE_CONTRACTS as KERNEL_TABLE_CONTRACTS, index_MC_TABLE_CONTRACTS as MC_TABLE_CONTRACTS, index_NODE_TYPE as NODE_TYPE, index_SLOpinionInput as SLOpinionInput, index_SLOpinionInputSchema as SLOpinionInputSchema, index_STORAGE_EDGE_TYPE as STORAGE_EDGE_TYPE, index_STORAGE_EDGE_TYPE_VALUES as STORAGE_EDGE_TYPE_VALUES, index_TABLE_CONTRACTS_BY_COMPONENT as TABLE_CONTRACTS_BY_COMPONENT, index_TOPIC_STATUS as TOPIC_STATUS, index_TOPIC_VISIBILITY as TOPIC_VISIBILITY, index_getTableContract as getTableContract, index_listTableContractsByName as listTableContractsByName };
-}
-
-export { index as i };

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

@@ -1,146 +0,0 @@
-import { M as McpToolContract } from './tool-contracts-C_xvM9q2.js';
-
-/**
- * SDK-Only Tool Contract Definitions
- *
- * Tools available in @lucern/sdk but NOT in the MCP gateway.
- * The SDK unfolds deeper capabilities after the MCP gateway shows developers what's possible.
- *
- * Total SDK surface = MCP tools (44) + SDK-only tools (44) = 88 tools
- *
- * These tools are organized into capability tiers:
- * - Advanced workflow & phase management (12 tools)
- * - Deeper graph navigation (6 tools)
- * - Conviction & analytics (7 tools)
- * - Extended question & evidence analytics (1 tool; core lifecycle promoted to MCP)
- * - Task lifecycle (5 tools)
- * - Domain analytics (8 tools)
- * - Bias detection suite (5 tools)
- *
- * CONTRACT SURFACE: These definitions are the external API for SDK consumers.
- * Renaming a tool or changing its description is a BREAKING CHANGE.
- *
- * Git-native naming rules (same as MCP, enforced by lint):
- *   1. Workflow tools use git verbs directly
- *   2. Knowledge tools use epistemic verbs
- *   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)
- */
-
-/** SDK-only tool contract — same shape as MCP but with sdk-only tier marker */
-interface SdkToolContract extends Omit<McpToolContract, "tier"> {
-    tier: "sdk-only";
-}
-declare const START_WORKTREE: SdkToolContract;
-declare const UPDATE_WORKTREE_PHASE: SdkToolContract;
-declare const ADVANCE_WORKTREE_PHASE: SdkToolContract;
-declare const ADD_NOTE_TO_WORKTREE: SdkToolContract;
-declare const LINK_DOCUMENT_TO_WORKTREE: SdkToolContract;
-declare const LINK_EVIDENCE_TO_WORKTREE: SdkToolContract;
-declare const LINK_QUESTION_TO_WORKTREE: SdkToolContract;
-declare const LINK_BELIEF_TO_WORKTREE: SdkToolContract;
-declare const CREATE_SYNTHESIZED_BELIEF: SdkToolContract;
-declare const COMPLETE_HYPOTHESIS_FORMATION: SdkToolContract;
-declare const COMPLETE_EVIDENCE_REVIEW: SdkToolContract;
-declare const REFINE_WORKTREE_BELIEF: SdkToolContract;
-declare const TRACE_PROVENANCE: SdkToolContract;
-declare const GET_BELIEF_RELATIONSHIPS: SdkToolContract;
-declare const GET_BELIEF_SUPPORT_CHAIN: SdkToolContract;
-declare const EXPLORE_CONNECTIONS: SdkToolContract;
-declare const GET_DEEP_LINEAGE: SdkToolContract;
-declare const GRAPH_AWARE_SEARCH: SdkToolContract;
-declare const GET_COLLECTION_CONVICTION: SdkToolContract;
-declare const GET_CONVICTION_TREND: SdkToolContract;
-declare const ANALYZE_BELIEF_CRITICALITY: SdkToolContract;
-declare const ANALYZE_BELIEF_CLUSTER_CANDIDATES: SdkToolContract;
-declare const CREATE_BELIEF_CONDITIONAL: SdkToolContract;
-declare const GET_NECESSARY_EVIDENCE: SdkToolContract;
-declare const ANALYZE_REASONING_DEPTH: SdkToolContract;
-declare const GET_EVIDENCE_BY_METHODOLOGY: SdkToolContract;
-declare const CREATE_EVIDENCE_TASK: SdkToolContract;
-declare const LIST_TASKS: SdkToolContract;
-declare const UPDATE_TASK: SdkToolContract;
-declare const GET_TASK_COUNTS: SdkToolContract;
-declare const ADD_RESEARCH_ACTION: SdkToolContract;
-declare const GET_PREDICTIONS: SdkToolContract;
-declare const GET_SURPRISE_DETECTION: SdkToolContract;
-declare const GET_CHALLENGED_BELIEFS: SdkToolContract;
-declare const GET_CAUSAL_CHAINS: SdkToolContract;
-declare const GET_NON_CONSENSUS_BELIEFS: SdkToolContract;
-declare const GET_BELIEFS_BY_EPISTEMIC_STATUS: SdkToolContract;
-declare const DETECT_ANCHORING_BIAS: SdkToolContract;
-declare const DETECT_SOURCE_CONCENTRATION: SdkToolContract;
-declare const FIND_SOFT_CONTRADICTIONS: SdkToolContract;
-declare const FIND_SEMANTIC_BRIDGES: SdkToolContract;
-declare const FIND_SEMANTIC_ORPHANS: SdkToolContract;
-/** All SDK-only tool contracts, indexed by name */
-declare const SDK_ONLY_TOOL_CONTRACTS: Record<string, SdkToolContract>;
-/** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
-declare const ALL_SDK_TOOL_CONTRACTS: Record<string, McpToolContract | SdkToolContract>;
-/** All SDK-only tool names */
-declare const SDK_ONLY_TOOL_NAMES: string[];
-/** All tool names across the complete SDK surface */
-declare const ALL_SDK_TOOL_NAMES: string[];
-/**
- * Lint validation: every SDK tool description must contain "Like `git" reference.
- * Reuses the same git-semantic validation rule as MCP tools.
- */
-declare function validateSdkGitSemantics(tool: SdkToolContract): {
-    valid: boolean;
-    reason?: string;
-};
-
-declare const sdkTools_contract_ADD_NOTE_TO_WORKTREE: typeof ADD_NOTE_TO_WORKTREE;
-declare const sdkTools_contract_ADD_RESEARCH_ACTION: typeof ADD_RESEARCH_ACTION;
-declare const sdkTools_contract_ADVANCE_WORKTREE_PHASE: typeof ADVANCE_WORKTREE_PHASE;
-declare const sdkTools_contract_ALL_SDK_TOOL_CONTRACTS: typeof ALL_SDK_TOOL_CONTRACTS;
-declare const sdkTools_contract_ALL_SDK_TOOL_NAMES: typeof ALL_SDK_TOOL_NAMES;
-declare const sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES: typeof ANALYZE_BELIEF_CLUSTER_CANDIDATES;
-declare const sdkTools_contract_ANALYZE_BELIEF_CRITICALITY: typeof ANALYZE_BELIEF_CRITICALITY;
-declare const sdkTools_contract_ANALYZE_REASONING_DEPTH: typeof ANALYZE_REASONING_DEPTH;
-declare const sdkTools_contract_COMPLETE_EVIDENCE_REVIEW: typeof COMPLETE_EVIDENCE_REVIEW;
-declare const sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION: typeof COMPLETE_HYPOTHESIS_FORMATION;
-declare const sdkTools_contract_CREATE_BELIEF_CONDITIONAL: typeof CREATE_BELIEF_CONDITIONAL;
-declare const sdkTools_contract_CREATE_EVIDENCE_TASK: typeof CREATE_EVIDENCE_TASK;
-declare const sdkTools_contract_CREATE_SYNTHESIZED_BELIEF: typeof CREATE_SYNTHESIZED_BELIEF;
-declare const sdkTools_contract_DETECT_ANCHORING_BIAS: typeof DETECT_ANCHORING_BIAS;
-declare const sdkTools_contract_DETECT_SOURCE_CONCENTRATION: typeof DETECT_SOURCE_CONCENTRATION;
-declare const sdkTools_contract_EXPLORE_CONNECTIONS: typeof EXPLORE_CONNECTIONS;
-declare const sdkTools_contract_FIND_SEMANTIC_BRIDGES: typeof FIND_SEMANTIC_BRIDGES;
-declare const sdkTools_contract_FIND_SEMANTIC_ORPHANS: typeof FIND_SEMANTIC_ORPHANS;
-declare const sdkTools_contract_FIND_SOFT_CONTRADICTIONS: typeof FIND_SOFT_CONTRADICTIONS;
-declare const sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS: typeof GET_BELIEFS_BY_EPISTEMIC_STATUS;
-declare const sdkTools_contract_GET_BELIEF_RELATIONSHIPS: typeof GET_BELIEF_RELATIONSHIPS;
-declare const sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN: typeof GET_BELIEF_SUPPORT_CHAIN;
-declare const sdkTools_contract_GET_CAUSAL_CHAINS: typeof GET_CAUSAL_CHAINS;
-declare const sdkTools_contract_GET_CHALLENGED_BELIEFS: typeof GET_CHALLENGED_BELIEFS;
-declare const sdkTools_contract_GET_COLLECTION_CONVICTION: typeof GET_COLLECTION_CONVICTION;
-declare const sdkTools_contract_GET_CONVICTION_TREND: typeof GET_CONVICTION_TREND;
-declare const sdkTools_contract_GET_DEEP_LINEAGE: typeof GET_DEEP_LINEAGE;
-declare const sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY: typeof GET_EVIDENCE_BY_METHODOLOGY;
-declare const sdkTools_contract_GET_NECESSARY_EVIDENCE: typeof GET_NECESSARY_EVIDENCE;
-declare const sdkTools_contract_GET_NON_CONSENSUS_BELIEFS: typeof GET_NON_CONSENSUS_BELIEFS;
-declare const sdkTools_contract_GET_PREDICTIONS: typeof GET_PREDICTIONS;
-declare const sdkTools_contract_GET_SURPRISE_DETECTION: typeof GET_SURPRISE_DETECTION;
-declare const sdkTools_contract_GET_TASK_COUNTS: typeof GET_TASK_COUNTS;
-declare const sdkTools_contract_GRAPH_AWARE_SEARCH: typeof GRAPH_AWARE_SEARCH;
-declare const sdkTools_contract_LINK_BELIEF_TO_WORKTREE: typeof LINK_BELIEF_TO_WORKTREE;
-declare const sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE: typeof LINK_DOCUMENT_TO_WORKTREE;
-declare const sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE: typeof LINK_EVIDENCE_TO_WORKTREE;
-declare const sdkTools_contract_LINK_QUESTION_TO_WORKTREE: typeof LINK_QUESTION_TO_WORKTREE;
-declare const sdkTools_contract_LIST_TASKS: typeof LIST_TASKS;
-declare const sdkTools_contract_REFINE_WORKTREE_BELIEF: typeof REFINE_WORKTREE_BELIEF;
-declare const sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS: typeof SDK_ONLY_TOOL_CONTRACTS;
-declare const sdkTools_contract_SDK_ONLY_TOOL_NAMES: typeof SDK_ONLY_TOOL_NAMES;
-declare const sdkTools_contract_START_WORKTREE: typeof START_WORKTREE;
-type sdkTools_contract_SdkToolContract = SdkToolContract;
-declare const sdkTools_contract_TRACE_PROVENANCE: typeof TRACE_PROVENANCE;
-declare const sdkTools_contract_UPDATE_TASK: typeof UPDATE_TASK;
-declare const sdkTools_contract_UPDATE_WORKTREE_PHASE: typeof UPDATE_WORKTREE_PHASE;
-declare const sdkTools_contract_validateSdkGitSemantics: typeof validateSdkGitSemantics;
-declare namespace sdkTools_contract {
-  export { sdkTools_contract_ADD_NOTE_TO_WORKTREE as ADD_NOTE_TO_WORKTREE, sdkTools_contract_ADD_RESEARCH_ACTION as ADD_RESEARCH_ACTION, sdkTools_contract_ADVANCE_WORKTREE_PHASE as ADVANCE_WORKTREE_PHASE, sdkTools_contract_ALL_SDK_TOOL_CONTRACTS as ALL_SDK_TOOL_CONTRACTS, sdkTools_contract_ALL_SDK_TOOL_NAMES as ALL_SDK_TOOL_NAMES, sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES as ANALYZE_BELIEF_CLUSTER_CANDIDATES, sdkTools_contract_ANALYZE_BELIEF_CRITICALITY as ANALYZE_BELIEF_CRITICALITY, sdkTools_contract_ANALYZE_REASONING_DEPTH as ANALYZE_REASONING_DEPTH, sdkTools_contract_COMPLETE_EVIDENCE_REVIEW as COMPLETE_EVIDENCE_REVIEW, sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION as COMPLETE_HYPOTHESIS_FORMATION, sdkTools_contract_CREATE_BELIEF_CONDITIONAL as CREATE_BELIEF_CONDITIONAL, sdkTools_contract_CREATE_EVIDENCE_TASK as CREATE_EVIDENCE_TASK, sdkTools_contract_CREATE_SYNTHESIZED_BELIEF as CREATE_SYNTHESIZED_BELIEF, sdkTools_contract_DETECT_ANCHORING_BIAS as DETECT_ANCHORING_BIAS, sdkTools_contract_DETECT_SOURCE_CONCENTRATION as DETECT_SOURCE_CONCENTRATION, sdkTools_contract_EXPLORE_CONNECTIONS as EXPLORE_CONNECTIONS, sdkTools_contract_FIND_SEMANTIC_BRIDGES as FIND_SEMANTIC_BRIDGES, sdkTools_contract_FIND_SEMANTIC_ORPHANS as FIND_SEMANTIC_ORPHANS, sdkTools_contract_FIND_SOFT_CONTRADICTIONS as FIND_SOFT_CONTRADICTIONS, sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS as GET_BELIEFS_BY_EPISTEMIC_STATUS, sdkTools_contract_GET_BELIEF_RELATIONSHIPS as GET_BELIEF_RELATIONSHIPS, sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN as GET_BELIEF_SUPPORT_CHAIN, sdkTools_contract_GET_CAUSAL_CHAINS as GET_CAUSAL_CHAINS, sdkTools_contract_GET_CHALLENGED_BELIEFS as GET_CHALLENGED_BELIEFS, sdkTools_contract_GET_COLLECTION_CONVICTION as GET_COLLECTION_CONVICTION, sdkTools_contract_GET_CONVICTION_TREND as GET_CONVICTION_TREND, sdkTools_contract_GET_DEEP_LINEAGE as GET_DEEP_LINEAGE, sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY as GET_EVIDENCE_BY_METHODOLOGY, sdkTools_contract_GET_NECESSARY_EVIDENCE as GET_NECESSARY_EVIDENCE, sdkTools_contract_GET_NON_CONSENSUS_BELIEFS as GET_NON_CONSENSUS_BELIEFS, sdkTools_contract_GET_PREDICTIONS as GET_PREDICTIONS, sdkTools_contract_GET_SURPRISE_DETECTION as GET_SURPRISE_DETECTION, sdkTools_contract_GET_TASK_COUNTS as GET_TASK_COUNTS, sdkTools_contract_GRAPH_AWARE_SEARCH as GRAPH_AWARE_SEARCH, sdkTools_contract_LINK_BELIEF_TO_WORKTREE as LINK_BELIEF_TO_WORKTREE, sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE as LINK_DOCUMENT_TO_WORKTREE, sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE as LINK_EVIDENCE_TO_WORKTREE, sdkTools_contract_LINK_QUESTION_TO_WORKTREE as LINK_QUESTION_TO_WORKTREE, sdkTools_contract_LIST_TASKS as LIST_TASKS, sdkTools_contract_REFINE_WORKTREE_BELIEF as REFINE_WORKTREE_BELIEF, sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS as SDK_ONLY_TOOL_CONTRACTS, sdkTools_contract_SDK_ONLY_TOOL_NAMES as SDK_ONLY_TOOL_NAMES, sdkTools_contract_START_WORKTREE as START_WORKTREE, type sdkTools_contract_SdkToolContract as SdkToolContract, sdkTools_contract_TRACE_PROVENANCE as TRACE_PROVENANCE, sdkTools_contract_UPDATE_TASK as UPDATE_TASK, sdkTools_contract_UPDATE_WORKTREE_PHASE as UPDATE_WORKTREE_PHASE, sdkTools_contract_validateSdkGitSemantics as validateSdkGitSemantics };
-}
-
-export { ADD_NOTE_TO_WORKTREE as A, GET_SURPRISE_DETECTION as B, COMPLETE_EVIDENCE_REVIEW as C, DETECT_ANCHORING_BIAS as D, EXPLORE_CONNECTIONS as E, FIND_SEMANTIC_BRIDGES as F, GET_BELIEFS_BY_EPISTEMIC_STATUS as G, GET_TASK_COUNTS as H, GRAPH_AWARE_SEARCH as I, LINK_DOCUMENT_TO_WORKTREE as J, LINK_EVIDENCE_TO_WORKTREE as K, LINK_BELIEF_TO_WORKTREE as L, LINK_QUESTION_TO_WORKTREE as M, LIST_TASKS as N, SDK_ONLY_TOOL_NAMES as O, START_WORKTREE as P, type SdkToolContract as Q, REFINE_WORKTREE_BELIEF as R, SDK_ONLY_TOOL_CONTRACTS as S, TRACE_PROVENANCE as T, UPDATE_TASK as U, UPDATE_WORKTREE_PHASE as V, validateSdkGitSemantics as W, ADD_RESEARCH_ACTION as a, ADVANCE_WORKTREE_PHASE as b, ALL_SDK_TOOL_CONTRACTS as c, ALL_SDK_TOOL_NAMES as d, ANALYZE_BELIEF_CLUSTER_CANDIDATES as e, ANALYZE_BELIEF_CRITICALITY as f, ANALYZE_REASONING_DEPTH as g, COMPLETE_HYPOTHESIS_FORMATION as h, CREATE_BELIEF_CONDITIONAL as i, CREATE_EVIDENCE_TASK as j, CREATE_SYNTHESIZED_BELIEF as k, DETECT_SOURCE_CONCENTRATION as l, FIND_SEMANTIC_ORPHANS as m, FIND_SOFT_CONTRADICTIONS as n, GET_BELIEF_RELATIONSHIPS as o, GET_BELIEF_SUPPORT_CHAIN as p, GET_CAUSAL_CHAINS as q, GET_CHALLENGED_BELIEFS as r, sdkTools_contract as s, GET_COLLECTION_CONVICTION as t, GET_CONVICTION_TREND as u, GET_DEEP_LINEAGE as v, GET_EVIDENCE_BY_METHODOLOGY as w, GET_NECESSARY_EVIDENCE as x, GET_NON_CONSENSUS_BELIEFS as y, GET_PREDICTIONS as z };