@lucern/contracts 0.3.0-alpha.2 → 0.3.0-alpha.4

package/dist/schemas/tables/mc/pack.d.ts

@@ -135,46 +135,46 @@ declare const packVersions: TableContract<{
             idempotent: z.ZodBoolean;
             sideEffectLevel: z.ZodEnum<["none", "low", "high"]>;
         }, "strip", z.ZodTypeAny, {
-            readOnly: boolean;
             idempotent: boolean;
+            readOnly: boolean;
             sideEffectLevel: "high" | "low" | "none";
         }, {
-            readOnly: boolean;
             idempotent: boolean;
+            readOnly: boolean;
             sideEffectLevel: "high" | "low" | "none";
         }>>;
     }, "strip", z.ZodTypeAny, {
         toolName: string;
         toolVersion: string;
         description?: string | undefined;
+        surfaces?: ("cli" | "mcp" | "sdk" | "chat" | "voice" | "sprint" | "api")[] | undefined;
+        category?: "read" | "write" | "admin" | "system" | undefined;
         executionAdapter?: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed" | undefined;
         parameterSchema?: Record<string, any> | undefined;
-        category?: "read" | "write" | "admin" | "system" | undefined;
         requiredRole?: "platform_admin" | "tenant_admin" | "workspace_admin" | "editor" | "viewer" | "auditor" | "service_agent" | undefined;
-        requiredAction?: "read" | "admin" | "mutate" | "summarize" | "export" | "create" | "delete" | "grant" | "revoke" | undefined;
-        surfaces?: ("cli" | "mcp" | "chat" | "voice" | "sprint" | "api" | "sdk")[] | undefined;
+        requiredAction?: "delete" | "read" | "admin" | "create" | "mutate" | "summarize" | "export" | "grant" | "revoke" | undefined;
         returnSchema?: Record<string, any> | undefined;
         handlerRef?: string | undefined;
         safetyMetadata?: {
-            readOnly: boolean;
             idempotent: boolean;
+            readOnly: boolean;
             sideEffectLevel: "high" | "low" | "none";
         } | undefined;
     }, {
         toolName: string;
         toolVersion: string;
         description?: string | undefined;
+        surfaces?: ("cli" | "mcp" | "sdk" | "chat" | "voice" | "sprint" | "api")[] | undefined;
+        category?: "read" | "write" | "admin" | "system" | undefined;
         executionAdapter?: "convex_mutation" | "convex_action" | "http_callback" | "mcp_tool" | "sdk_invocation" | "external_observed" | undefined;
         parameterSchema?: Record<string, any> | undefined;
-        category?: "read" | "write" | "admin" | "system" | undefined;
         requiredRole?: "platform_admin" | "tenant_admin" | "workspace_admin" | "editor" | "viewer" | "auditor" | "service_agent" | undefined;
-        requiredAction?: "read" | "admin" | "mutate" | "summarize" | "export" | "create" | "delete" | "grant" | "revoke" | undefined;
-        surfaces?: ("cli" | "mcp" | "chat" | "voice" | "sprint" | "api" | "sdk")[] | undefined;
+        requiredAction?: "delete" | "read" | "admin" | "create" | "mutate" | "summarize" | "export" | "grant" | "revoke" | undefined;
         returnSchema?: Record<string, any> | undefined;
         handlerRef?: string | undefined;
         safetyMetadata?: {
-            readOnly: boolean;
             idempotent: boolean;
+            readOnly: boolean;
             sideEffectLevel: "high" | "low" | "none";
         } | undefined;
     }>, "many">;
@@ -326,17 +326,17 @@ declare const packVersions: TableContract<{
             promptRef: string;
             required?: boolean | undefined;
             version?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             role?: string | undefined;
-            phase?: string | undefined;
         }, {
             key: string;
             promptRef: string;
             required?: boolean | undefined;
             version?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             role?: string | undefined;
-            phase?: string | undefined;
         }>, "many">;
         workflowTemplates: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -403,16 +403,16 @@ declare const packVersions: TableContract<{
             key: string;
             title: string;
             description?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             priority?: "critical" | "high" | "medium" | "low" | undefined;
-            phase?: string | undefined;
         }, {
             key: string;
             title: string;
             description?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             priority?: "critical" | "high" | "medium" | "low" | undefined;
-            phase?: string | undefined;
         }>, "many">;
         questionTemplates: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -444,9 +444,9 @@ declare const packVersions: TableContract<{
             promptRef: string;
             required?: boolean | undefined;
             version?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             role?: string | undefined;
-            phase?: string | undefined;
         }[];
         workflowTemplates: {
             name: string;
@@ -466,13 +466,14 @@ declare const packVersions: TableContract<{
             key: string;
             title: string;
             description?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             priority?: "critical" | "high" | "medium" | "low" | undefined;
-            phase?: string | undefined;
         }[];
         lensKey: string;
         description?: string | undefined;
         metadata?: any;
+        filterCriteria?: any;
         questionTemplates?: {
             key: string;
             text: string;
@@ -480,7 +481,6 @@ declare const packVersions: TableContract<{
             priority?: "critical" | "high" | "medium" | "low" | undefined;
             linkedBeliefKey?: string | undefined;
         }[] | undefined;
-        filterCriteria?: any;
         topicTypeAffinity?: string[] | undefined;
     }, {
         name: string;
@@ -490,9 +490,9 @@ declare const packVersions: TableContract<{
             promptRef: string;
             required?: boolean | undefined;
             version?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             role?: string | undefined;
-            phase?: string | undefined;
         }[];
         workflowTemplates: {
             name: string;
@@ -512,13 +512,14 @@ declare const packVersions: TableContract<{
             key: string;
             title: string;
             description?: string | undefined;
+            phase?: string | undefined;
             metadata?: any;
             priority?: "critical" | "high" | "medium" | "low" | undefined;
-            phase?: string | undefined;
         }[];
         lensKey: string;
         description?: string | undefined;
         metadata?: any;
+        filterCriteria?: any;
         questionTemplates?: {
             key: string;
             text: string;
@@ -526,7 +527,6 @@ declare const packVersions: TableContract<{
             priority?: "critical" | "high" | "medium" | "low" | undefined;
             linkedBeliefKey?: string | undefined;
         }[] | undefined;
-        filterCriteria?: any;
         topicTypeAffinity?: string[] | undefined;
     }>, "many">>;
     configSnapshot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;

package/dist/schemas/tables/mc/registry.d.ts

@@ -93,12 +93,12 @@ declare const toolCatalog: TableContract<{
         idempotent: z.ZodBoolean;
         sideEffectLevel: z.ZodEnum<["none", "low", "high"]>;
     }, "strip", z.ZodTypeAny, {
-        readOnly: boolean;
         idempotent: boolean;
+        readOnly: boolean;
         sideEffectLevel: "high" | "low" | "none";
     }, {
-        readOnly: boolean;
         idempotent: boolean;
+        readOnly: boolean;
         sideEffectLevel: "high" | "low" | "none";
     }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -122,12 +122,12 @@ declare const toolRegistryEntries: TableContract<{
         idempotent: z.ZodBoolean;
         sideEffectLevel: z.ZodEnum<["none", "low", "high"]>;
     }, "strip", z.ZodTypeAny, {
-        readOnly: boolean;
         idempotent: boolean;
+        readOnly: boolean;
         sideEffectLevel: "high" | "low" | "none";
     }, {
-        readOnly: boolean;
         idempotent: boolean;
+        readOnly: boolean;
         sideEffectLevel: "high" | "low" | "none";
     }>;
     exampleInvocations: z.ZodArray<z.ZodObject<{

package/dist/schemas/tables/mc/workspace.d.ts

@@ -11,13 +11,19 @@ declare const workspaces: TableContract<{
     defaultProjectVisibility: z.ZodOptional<z.ZodEnum<["private", "team", "firm", "external", "public"]>>;
     deployments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         url: z.ZodString;
-        encryptedDeployKey: z.ZodString;
+        target: z.ZodOptional<z.ZodEnum<["kernelDeployment", "appDeployment"]>>;
+        encryptedDeployKey: z.ZodOptional<z.ZodString>;
+        credentialRef: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        encryptedDeployKey: string;
         url: string;
+        credentialRef?: string | undefined;
+        target?: "kernelDeployment" | "appDeployment" | undefined;
+        encryptedDeployKey?: string | undefined;
     }, {
-        encryptedDeployKey: string;
         url: string;
+        credentialRef?: string | undefined;
+        target?: "kernelDeployment" | "appDeployment" | undefined;
+        encryptedDeployKey?: string | undefined;
     }>>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     createdBy: z.ZodOptional<z.ZodString>;

package/dist/schemas/tables/mc/workspace.js

@@ -32,7 +32,9 @@ var workspaces = defineTable({
     "defaultProjectVisibility": z.enum(["private", "team", "firm", "external", "public"]).optional(),
     "deployments": z.record(z.object({
       "url": z.string(),
-      "encryptedDeployKey": z.string()
+      "target": z.enum(["kernelDeployment", "appDeployment"]).optional(),
+      "encryptedDeployKey": z.string().optional(),
+      "credentialRef": z.string().optional()
     })).optional(),
     "metadata": z.record(z.any()).optional(),
     "createdBy": z.string().optional(),

package/dist/schemas/tables/mc/workspace.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/dsl/defineTable.ts","../../../../src/dsl/idOf.ts","../../../../src/schemas/tables/mc/workspace.ts"],"names":["z"],"mappings":";;;;;AAwCO,SAAS,YACd,IAAA,EACkB;AAClB,EAAA,OAAO,IAAA;AACT;AC1CO,IAAM,eAAA,mBAAkB,MAAA,CAAO,GAAA,CAAI,gCAAgC,CAAA;AASnE,SAAS,KAAuB,KAAA,EAA6B;AAClE,EAAA,MAAM,MAAA,GAAS,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,EAAkB;AAC5C,EAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,eAAA,EAAiB;AAAA,IAC7C,YAAA,EAAc,KAAA;AAAA,IACd,UAAA,EAAY,KAAA;AAAA,IACZ,KAAA,EAAO,KAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACX,CAAA;AACD,EAAA,OAAO,MAAA;AACT;;;ACVO,IAAM,aAAa,WAAA,CAAY;AAAA,EACpC,IAAA,EAAM,YAAA;AAAA,EACN,SAAA,EAAW,IAAA;AAAA,EACX,QAAA,EAAU,WAAA;AAAA,EACV,KAAA,EAAOA,EAAE,MAAA,CAAO;AAAA,IACd,UAAA,EAAY,KAAK,SAAS,CAAA;AAAA,IAC1B,KAAA,EAAOA,EAAE,MAAA,EAAO;AAAA,IAChB,MAAA,EAAQA,EAAE,MAAA,EAAO;AAAA,IACjB,MAAA,EAAQA,EAAE,MAAA,EAAO;AAAA,IACjB,UAAUA,CAAAA,CAAE,IAAA,CAAK,CAAC,QAAA,EAAU,UAAU,CAAC,CAAA;AAAA,IACvC,0BAAA,EAA4BA,CAAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAW,MAAA,EAAQ,MAAA,EAAQ,UAAA,EAAY,QAAQ,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/F,aAAA,EAAeA,CAAAA,CAAE,MAAA,CAAOA,CAAAA,CAAE,MAAA,CAAO;AAAA,MACjC,KAAA,EAAOA,EAAE,MAAA,EAAO;AAAA,MAChB,oBAAA,EAAsBA,EAAE,MAAA;AAAO,KAChC,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IACX,YAAYA,CAAAA,CAAE,MAAA,CAAOA,EAAE,GAAA,EAAK,EAAE,QAAA,EAAS;AAAA,IACvC,WAAA,EAAaA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IACjC,WAAA,EAAaA,EAAE,MAAA,EAAO;AAAA,IACtB,WAAA,EAAaA,EAAE,MAAA;AAAO,GACvB,CAAA;AAAA,EACD,OAAA,EAAS;AAAA,IACL,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,eAAe,OAAA,EAAS,CAAC,UAAU,CAAA,EAAE;AAAA,IAC5D,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,mBAAmB,OAAA,EAAS,CAAC,UAAA,EAAY,KAAK,CAAA,EAAE;AAAA,IACvE,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,oBAAoB,OAAA,EAAS,CAAC,UAAA,EAAY,MAAM,CAAA,EAAE;AAAA,IACzE,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,aAAa,OAAA,EAAS,CAAC,QAAQ,CAAA;AAAE;AAE9D,CAAC","file":"workspace.js","sourcesContent":["import type { ZodObject, ZodRawShape } from \"zod\";\n\nexport type TableComponent = \"mc\" | \"kernel\" | \"identity\" | \"developer-pack\";\n\nexport type TableIndex =\n  | {\n      kind: \"index\";\n      name: string;\n      columns: readonly string[];\n    }\n  | {\n      kind: \"search\";\n      name: string;\n      searchField: string;\n      filterFields?: readonly string[];\n    }\n  | {\n      kind: \"vector\";\n      name: string;\n      vectorField: string;\n      dimensions: number;\n      filterFields?: readonly string[];\n    };\n\nexport type TableDeprecation = {\n  since: string;\n  reason: string;\n  replacement?: string;\n};\n\nexport type TableContract<S extends ZodRawShape = ZodRawShape> = {\n  name: string;\n  component: TableComponent;\n  category: string;\n  shape: ZodObject<S>;\n  indices: readonly TableIndex[];\n  deprecated?: TableDeprecation;\n  invariants?: readonly string[];\n};\n\nexport function defineTable<S extends ZodRawShape>(\n  spec: TableContract<S>\n): TableContract<S> {\n  return spec;\n}\n","import { z } from \"zod\";\n\nexport const CONVEX_ID_TABLE = Symbol.for(\"lucern.contracts.convexIdTable\");\n\nexport type ConvexIdSchema<T extends string> = z.ZodBranded<\n  z.ZodString,\n  `Id<${T}>`\n> & {\n  readonly [CONVEX_ID_TABLE]: T;\n};\n\nexport function idOf<T extends string>(table: T): ConvexIdSchema<T> {\n  const schema = z.string().brand<`Id<${T}>`>();\n  Object.defineProperty(schema, CONVEX_ID_TABLE, {\n    configurable: false,\n    enumerable: false,\n    value: table,\n    writable: false,\n  });\n  return schema as ConvexIdSchema<T>;\n}\n\nexport function getConvexIdTable(schema: z.ZodTypeAny): string | undefined {\n  return (schema as Partial<Record<typeof CONVEX_ID_TABLE, string>>)[\n    CONVEX_ID_TABLE\n  ];\n}\n","/**\n * Schema contracts for mc/workspace.\n *\n * Mirrored from:\n *   - services/master-control/convex/schema.ts\n */\n\nimport { z } from 'zod';\nimport { defineTable, idOf } from '../../../dsl.js';\n\nexport const workspaces = defineTable({\n  name: \"workspaces\",\n  component: \"mc\",\n  category: \"workspace\",\n  shape: z.object({\n    \"tenantId\": idOf(\"tenants\"),\n    \"key\": z.string(),\n    \"slug\": z.string(),\n    \"name\": z.string(),\n    \"status\": z.enum([\"active\", \"archived\"]),\n    \"defaultProjectVisibility\": z.enum([\"private\", \"team\", \"firm\", \"external\", \"public\"]).optional(),\n    \"deployments\": z.record(z.object({\n    \"url\": z.string(),\n    \"encryptedDeployKey\": z.string()\n  })).optional(),\n    \"metadata\": z.record(z.any()).optional(),\n    \"createdBy\": z.string().optional(),\n    \"createdAt\": z.number(),\n    \"updatedAt\": z.number()\n  }),\n  indices: [\n      { kind: 'index', name: \"by_tenantId\", columns: [\"tenantId\"] },\n      { kind: 'index', name: \"by_tenantId_key\", columns: [\"tenantId\", \"key\"] },\n      { kind: 'index', name: \"by_tenantId_slug\", columns: [\"tenantId\", \"slug\"] },\n      { kind: 'index', name: \"by_status\", columns: [\"status\"] }\n    ],\n});\n"]}
+{"version":3,"sources":["../../../../src/dsl/defineTable.ts","../../../../src/dsl/idOf.ts","../../../../src/schemas/tables/mc/workspace.ts"],"names":["z"],"mappings":";;;;;AAwCO,SAAS,YACd,IAAA,EACkB;AAClB,EAAA,OAAO,IAAA;AACT;AC1CO,IAAM,eAAA,mBAAkB,MAAA,CAAO,GAAA,CAAI,gCAAgC,CAAA;AASnE,SAAS,KAAuB,KAAA,EAA6B;AAClE,EAAA,MAAM,MAAA,GAAS,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,EAAkB;AAC5C,EAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,eAAA,EAAiB;AAAA,IAC7C,YAAA,EAAc,KAAA;AAAA,IACd,UAAA,EAAY,KAAA;AAAA,IACZ,KAAA,EAAO,KAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACX,CAAA;AACD,EAAA,OAAO,MAAA;AACT;;;ACVO,IAAM,aAAa,WAAA,CAAY;AAAA,EACpC,IAAA,EAAM,YAAA;AAAA,EACN,SAAA,EAAW,IAAA;AAAA,EACX,QAAA,EAAU,WAAA;AAAA,EACV,KAAA,EAAOA,EAAE,MAAA,CAAO;AAAA,IACd,UAAA,EAAY,KAAK,SAAS,CAAA;AAAA,IAC1B,KAAA,EAAOA,EAAE,MAAA,EAAO;AAAA,IAChB,MAAA,EAAQA,EAAE,MAAA,EAAO;AAAA,IACjB,MAAA,EAAQA,EAAE,MAAA,EAAO;AAAA,IACjB,UAAUA,CAAAA,CAAE,IAAA,CAAK,CAAC,QAAA,EAAU,UAAU,CAAC,CAAA;AAAA,IACvC,0BAAA,EAA4BA,CAAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAW,MAAA,EAAQ,MAAA,EAAQ,UAAA,EAAY,QAAQ,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/F,aAAA,EAAeA,CAAAA,CAAE,MAAA,CAAOA,CAAAA,CAAE,MAAA,CAAO;AAAA,MACjC,KAAA,EAAOA,EAAE,MAAA,EAAO;AAAA,MAChB,QAAA,EAAUA,EAAE,IAAA,CAAK,CAAC,oBAAoB,eAAe,CAAC,EAAE,QAAA,EAAS;AAAA,MACjE,oBAAA,EAAsBA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,MAC1C,eAAA,EAAiBA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,KACtC,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IACX,YAAYA,CAAAA,CAAE,MAAA,CAAOA,EAAE,GAAA,EAAK,EAAE,QAAA,EAAS;AAAA,IACvC,WAAA,EAAaA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IACjC,WAAA,EAAaA,EAAE,MAAA,EAAO;AAAA,IACtB,WAAA,EAAaA,EAAE,MAAA;AAAO,GACvB,CAAA;AAAA,EACD,OAAA,EAAS;AAAA,IACL,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,eAAe,OAAA,EAAS,CAAC,UAAU,CAAA,EAAE;AAAA,IAC5D,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,mBAAmB,OAAA,EAAS,CAAC,UAAA,EAAY,KAAK,CAAA,EAAE;AAAA,IACvE,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,oBAAoB,OAAA,EAAS,CAAC,UAAA,EAAY,MAAM,CAAA,EAAE;AAAA,IACzE,EAAE,MAAM,OAAA,EAAS,IAAA,EAAM,aAAa,OAAA,EAAS,CAAC,QAAQ,CAAA;AAAE;AAE9D,CAAC","file":"workspace.js","sourcesContent":["import type { ZodObject, ZodRawShape } from \"zod\";\n\nexport type TableComponent = \"mc\" | \"kernel\" | \"identity\" | \"developer-pack\";\n\nexport type TableIndex =\n  | {\n      kind: \"index\";\n      name: string;\n      columns: readonly string[];\n    }\n  | {\n      kind: \"search\";\n      name: string;\n      searchField: string;\n      filterFields?: readonly string[];\n    }\n  | {\n      kind: \"vector\";\n      name: string;\n      vectorField: string;\n      dimensions: number;\n      filterFields?: readonly string[];\n    };\n\nexport type TableDeprecation = {\n  since: string;\n  reason: string;\n  replacement?: string;\n};\n\nexport type TableContract<S extends ZodRawShape = ZodRawShape> = {\n  name: string;\n  component: TableComponent;\n  category: string;\n  shape: ZodObject<S>;\n  indices: readonly TableIndex[];\n  deprecated?: TableDeprecation;\n  invariants?: readonly string[];\n};\n\nexport function defineTable<S extends ZodRawShape>(\n  spec: TableContract<S>\n): TableContract<S> {\n  return spec;\n}\n","import { z } from \"zod\";\n\nexport const CONVEX_ID_TABLE = Symbol.for(\"lucern.contracts.convexIdTable\");\n\nexport type ConvexIdSchema<T extends string> = z.ZodBranded<\n  z.ZodString,\n  `Id<${T}>`\n> & {\n  readonly [CONVEX_ID_TABLE]: T;\n};\n\nexport function idOf<T extends string>(table: T): ConvexIdSchema<T> {\n  const schema = z.string().brand<`Id<${T}>`>();\n  Object.defineProperty(schema, CONVEX_ID_TABLE, {\n    configurable: false,\n    enumerable: false,\n    value: table,\n    writable: false,\n  });\n  return schema as ConvexIdSchema<T>;\n}\n\nexport function getConvexIdTable(schema: z.ZodTypeAny): string | undefined {\n  return (schema as Partial<Record<typeof CONVEX_ID_TABLE, string>>)[\n    CONVEX_ID_TABLE\n  ];\n}\n","/**\n * Schema contracts for mc/workspace.\n *\n * Mirrored from:\n *   - services/master-control/convex/schema.ts\n */\n\nimport { z } from 'zod';\nimport { defineTable, idOf } from '../../../dsl.js';\n\nexport const workspaces = defineTable({\n  name: \"workspaces\",\n  component: \"mc\",\n  category: \"workspace\",\n  shape: z.object({\n    \"tenantId\": idOf(\"tenants\"),\n    \"key\": z.string(),\n    \"slug\": z.string(),\n    \"name\": z.string(),\n    \"status\": z.enum([\"active\", \"archived\"]),\n    \"defaultProjectVisibility\": z.enum([\"private\", \"team\", \"firm\", \"external\", \"public\"]).optional(),\n    \"deployments\": z.record(z.object({\n    \"url\": z.string(),\n    \"target\": z.enum([\"kernelDeployment\", \"appDeployment\"]).optional(),\n    \"encryptedDeployKey\": z.string().optional(),\n    \"credentialRef\": z.string().optional()\n  })).optional(),\n    \"metadata\": z.record(z.any()).optional(),\n    \"createdBy\": z.string().optional(),\n    \"createdAt\": z.number(),\n    \"updatedAt\": z.number()\n  }),\n  indices: [\n      { kind: 'index', name: \"by_tenantId\", columns: [\"tenantId\"] },\n      { kind: 'index', name: \"by_tenantId_key\", columns: [\"tenantId\", \"key\"] },\n      { kind: 'index', name: \"by_tenantId_slug\", columns: [\"tenantId\", \"slug\"] },\n      { kind: 'index', name: \"by_status\", columns: [\"status\"] }\n    ],\n});\n"]}

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-CD-N1Jf7.d.ts}

@@ -1,4 +1,4 @@
-import { M as McpToolContract } from './tool-contracts-C92-9ueT.js';
+import { M as McpToolContract } from './tool-contracts-BcKz-VGj.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-BcKz-VGj.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-CD-N1Jf7.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" }
   },
@@ -3518,6 +3607,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,
@@ -3611,6 +3763,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,