@lssm/lib.contracts 1.42.9 → 1.43.0

package/dist/server/contracts-adapter-input.js

@@ -1,7 +1,6 @@
+import { isSchemaModel } from "@lssm/lib.schema";
+
 //#region src/server/contracts-adapter-input.ts
-function isSchemaModel(x) {
-	return typeof x?.getPothosInput === "function" && typeof x?.getZod === "function";
-}
 function isFieldType(x) {
 	return typeof x?.getPothos === "function";
 }
@@ -21,13 +20,16 @@ function createInputTypeBuilder(builder) {
 	const enumTypeCache = /* @__PURE__ */ new Set();
 	function registerEnumsForModel(model) {
 		const entries = Object.entries(model.config.fields);
-		for (const [, field] of entries) if (isSchemaModel(field.type)) registerEnumsForModel(field.type);
-		else if (isEnumType(field.type)) {
-			const enumObj = field.type;
-			const name = enumObj.getName?.() ?? enumObj.getPothos().name;
-			if (!enumTypeCache.has(name)) {
-				builder.enumType(name, { values: enumObj.getEnumValues() });
-				enumTypeCache.add(name);
+		for (const [, field] of entries) {
+			const fieldType = field.type;
+			if (isSchemaModel(fieldType)) registerEnumsForModel(fieldType);
+			else if (isEnumType(field.type)) {
+				const enumObj = field.type;
+				const name = enumObj.getName?.() ?? enumObj.getPothos().name;
+				if (!enumTypeCache.has(name)) {
+					builder.enumType(name, { values: enumObj.getEnumValues() });
+					enumTypeCache.add(name);
+				}
 			}
 		}
 	}
@@ -39,26 +41,29 @@ function createInputTypeBuilder(builder) {
 		const created = builder.inputType(model.getPothosInput(), { fields: (t) => {
 			const entries = Object.entries(model.config.fields);
 			const acc = {};
-			for (const [key, field] of entries) if (isSchemaModel(field.type)) {
-				const nested = ensureInputTypeForModel(field.type);
-				const typeRef = field.isArray ? [nested] : nested;
-				acc[key] = t.field({
-					type: typeRef,
-					required: !field.isOptional
-				});
-			} else if (isFieldType(field.type)) {
-				const typeName$1 = mapScalarName(String(field.type.getPothos().name));
-				const typeRef = field.isArray ? [typeName$1] : typeName$1;
-				acc[key] = t.field({
-					type: typeRef,
-					required: !field.isOptional
-				});
-			} else {
-				const typeRef = field.isArray ? ["JSON"] : "JSON";
-				acc[key] = t.field({
-					type: typeRef,
-					required: !field.isOptional
-				});
+			for (const [key, field] of entries) {
+				const fieldType = field.type;
+				if (isSchemaModel(fieldType)) {
+					const nested = ensureInputTypeForModel(fieldType);
+					const typeRef = field.isArray ? [nested] : nested;
+					acc[key] = t.field({
+						type: typeRef,
+						required: !field.isOptional
+					});
+				} else if (isFieldType(field.type)) {
+					const typeName$1 = mapScalarName(String(field.type.getPothos().name));
+					const typeRef = field.isArray ? [typeName$1] : typeName$1;
+					acc[key] = t.field({
+						type: typeRef,
+						required: !field.isOptional
+					});
+				} else {
+					const typeRef = field.isArray ? ["JSON"] : "JSON";
+					acc[key] = t.field({
+						type: typeRef,
+						required: !field.isOptional
+					});
+				}
 			}
 			return acc;
 		} });
@@ -67,6 +72,7 @@ function createInputTypeBuilder(builder) {
 	}
 	function buildInputFieldArgs(model) {
 		if (!model) return null;
+		if (!isSchemaModel(model)) return null;
 		if (!model.config?.fields || Object.keys(model.config.fields).length === 0) return null;
 		return ensureInputTypeForModel(model);
 	}

package/dist/server/graphql-pothos.js

@@ -1,6 +1,7 @@
 import { defaultGqlField } from "../jsonschema.js";
 import { createInputTypeBuilder } from "./contracts-adapter-input.js";
 import { hydrateResourceIfNeeded, parseReturns } from "./contracts-adapter-hydration.js";
+import { isSchemaModel } from "@lssm/lib.schema";
 import "@pothos/plugin-prisma";
 import "@pothos/plugin-complexity";
 import "@pothos/plugin-relay";
@@ -32,41 +33,47 @@ function registerContractsOnBuilder(builder, reg, resources) {
 		const out = spec.io.output;
 		if (out && "getZod" in out && typeof out.getZod === "function") {
 			const model = out;
-			const typeName = model.config?.name ?? "UnknownOutput";
-			if (!outputTypeCache.has(typeName)) outputTypeCache.set(typeName, model);
+			const typeName = isSchemaModel(model) ? model.config?.name : "UnknownOutput";
+			if (typeName && !outputTypeCache.has(typeName)) outputTypeCache.set(typeName, model);
 		}
 	}
-	for (const [typeName, model] of outputTypeCache.entries()) builder.objectType(typeName, { fields: (t) => {
-		const entries = Object.entries(model.config.fields);
-		const acc = {};
-		for (const [key, field] of entries) {
-			const fieldType = field.type;
-			let gqlType = "JSON";
-			if (fieldType && typeof fieldType.getPothos === "function") {
-				gqlType = fieldType.getPothos().name || "JSON";
-				if (gqlType === "String_unsecure") gqlType = "String";
-				if (gqlType === "Int_unsecure") gqlType = "Int";
-				if (gqlType === "Float_unsecure") gqlType = "Float";
-				if (gqlType === "Boolean_unsecure") gqlType = "Boolean";
-				if (gqlType === "ID_unsecure") gqlType = "ID";
+	for (const [typeName, model] of outputTypeCache.entries()) {
+		if (!isSchemaModel(model)) continue;
+		builder.objectType(typeName, { fields: (t) => {
+			const entries = Object.entries(model.config.fields);
+			const acc = {};
+			for (const [key, field] of entries) {
+				const fieldType = field.type;
+				let gqlType = "JSON";
+				if (fieldType && typeof fieldType.getPothos === "function") {
+					gqlType = fieldType.getPothos().name || "JSON";
+					if (gqlType === "String_unsecure") gqlType = "String";
+					if (gqlType === "Int_unsecure") gqlType = "Int";
+					if (gqlType === "Float_unsecure") gqlType = "Float";
+					if (gqlType === "Boolean_unsecure") gqlType = "Boolean";
+					if (gqlType === "ID_unsecure") gqlType = "ID";
+				}
+				const typeRef = field.isArray ? [gqlType] : gqlType;
+				acc[key] = t.field({
+					type: typeRef,
+					nullable: field.isOptional,
+					resolve: (parent) => parent[key]
+				});
 			}
-			const typeRef = field.isArray ? [gqlType] : gqlType;
-			acc[key] = t.field({
-				type: typeRef,
-				nullable: field.isOptional,
-				resolve: (parent) => parent[key]
-			});
-		}
-		return acc;
-	} });
+			return acc;
+		} });
+	}
 	function resolveGraphQLTypeName(contractSpec) {
 		const returnsName = contractSpec.transport?.gql?.returns;
 		if (returnsName) return returnsName;
 		const out = contractSpec.io.output ?? {};
 		if (out && "kind" in out && out.kind === "resource_ref" && "graphQLType" in out && out.graphQLType) return String(out.graphQLType);
 		if (out && "getZod" in out && typeof out.getZod === "function") {
-			const typeName = out.config?.name;
-			if (typeName && outputTypeCache.has(typeName)) return typeName;
+			const model = out;
+			if (isSchemaModel(model)) {
+				const typeName = model.config?.name;
+				if (typeName && outputTypeCache.has(typeName)) return typeName;
+			}
 		}
 		return "JSON";
 	}

package/dist/server/mcp/createMcpServer.js

@@ -17,8 +17,7 @@ function createMcpServer(server, ops, resources, prompts, ctxFactories) {
 	});
 	registerMcpPresentations(server, {
 		logger: ctxFactories.logger,
-		presentations: ctxFactories.presentations,
-		presentationsV2: ctxFactories.presentationsV2
+		presentations: ctxFactories.presentations
 	});
 	registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
 	return server;

package/dist/server/mcp/mcpTypes.d.ts

@@ -1,4 +1,3 @@
-import { PresentationSpec } from "../../presentations/presentations.js";
 import { HandlerCtx } from "../../types.js";
 import { PresentationRegistry } from "../../presentations/registry.js";
 import "../../presentations/index.js";
@@ -23,8 +22,6 @@ interface McpCtxFactories {
   };
   /** Optional registry for presentations */
   presentations?: PresentationRegistry;
-  /** Optional list of presentation specs */
-  presentationsV2?: PresentationSpec[];
 }
 //#endregion
 export { McpCtxFactories };

package/dist/server/mcp/registerPresentations.d.ts

@@ -2,6 +2,6 @@ import { McpCtxFactories } from "./mcpTypes.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/server/mcp/registerPresentations.d.ts
-declare function registerMcpPresentations(server: McpServer, ctx: Pick<McpCtxFactories, 'logger' | 'presentations' | 'presentationsV2'>): void;
+declare function registerMcpPresentations(server: McpServer, ctx: Pick<McpCtxFactories, 'logger' | 'presentations'>): void;
 //#endregion
 export { registerMcpPresentations };

package/dist/server/mcp/registerPresentations.js

@@ -7,25 +7,24 @@ function isEngineRenderOutput(x) {
 	return "body" in x && typeof x.body === "string";
 }
 function registerMcpPresentations(server, ctx) {
-	const __presentations = ctx.presentations;
-	const __presentationsV2 = ctx.presentationsV2;
+	if (!ctx.presentations?.count()) return;
 	const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
-	if (__presentations) for (const p of __presentations.list()) {
-		const baseKey = `presentation.${p.meta.key.replace(/\./g, "_")}.v${p.meta.version}`;
-		const baseUri = `presentation://${p.meta.key}/v${p.meta.version}`;
+	for (const presentationSpec of ctx.presentations.list()) {
+		const baseKey = `presentation.${presentationSpec.meta.key.replace(/\./g, "_")}.v${presentationSpec.meta.version}`;
+		const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
 		ctx.logger.info(`Registering presentation ${baseUri} for ${baseKey}`);
 		server.registerResource(baseKey, baseUri, {
-			title: `${p.meta.key} v${p.meta.version}`,
-			description: p.meta.description ?? "Presentation",
+			title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+			description: presentationSpec.meta.description ?? "Presentation",
 			mimeType: "application/json"
 		}, async () => {
 			return { contents: [{
 				uri: baseUri,
 				mimeType: "application/json",
 				text: JSON.stringify({
-					meta: p.meta,
-					source: p.source,
-					targets: p.targets
+					meta: presentationSpec.meta,
+					source: presentationSpec.source,
+					targets: presentationSpec.targets
 				}, null, 2)
 			}] };
 		});
@@ -46,58 +45,10 @@ function registerMcpPresentations(server, ctx) {
 			const key = `${baseKey}${v.ext}`;
 			const uri = `${baseUri}${v.ext}`;
 			server.registerResource(key, uri, {
-				title: `${p.meta.key} v${p.meta.version} (${v.ext})`,
-				description: `${p.meta.description ?? "Presentation"} (${v.ext})`
+				title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+				description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
 			}, async () => {
-				const out = await engine.render(v.target, p);
-				return { contents: [{
-					uri,
-					mimeType: isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target,
-					text: isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out)
-				}] };
-			});
-		}
-	}
-	if (__presentationsV2 && __presentationsV2.length) for (const d of __presentationsV2) {
-		const baseKey = `presentation.${d.meta.key.replace(/\./g, "_")}.v${d.meta.version}`;
-		const baseUri = `presentation://${d.meta.key}/v${d.meta.version}`;
-		ctx.logger.info(`Registering presentation descriptor ${baseUri} for ${baseKey}`);
-		server.registerResource(baseKey, baseUri, {
-			title: `${d.meta.key} v${d.meta.version}`,
-			description: d.meta.description ?? "Presentation",
-			mimeType: "application/json"
-		}, async () => {
-			return { contents: [{
-				uri: baseUri,
-				mimeType: "application/json",
-				text: JSON.stringify({
-					meta: d.meta,
-					source: d.source,
-					targets: d.targets
-				}, null, 2)
-			}] };
-		});
-		for (const v of [
-			{
-				ext: ".md",
-				target: "markdown"
-			},
-			{
-				ext: ".json",
-				target: "application/json"
-			},
-			{
-				ext: ".xml",
-				target: "application/xml"
-			}
-		]) {
-			const key = `${baseKey}${v.ext}`;
-			const uri = `${baseUri}${v.ext}`;
-			server.registerResource(key, uri, {
-				title: `${d.meta.key} v${d.meta.version} (${v.ext})`,
-				description: `${d.meta.description ?? "Presentation"} (${v.ext})`
-			}, async () => {
-				const out = await engine.render(v.target, d);
+				const out = await engine.render(v.target, presentationSpec);
 				return { contents: [{
 					uri,
 					mimeType: isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target,

package/dist/{docs/tech/workflows → workflow}/overview.docblock.d.ts

@@ -1,6 +1,6 @@
 import { DocBlock } from "@lssm/lib.contracts/docs";
 
-//#region src/docs/tech/workflows/overview.docblock.d.ts
+//#region src/workflow/overview.docblock.d.ts
 declare const tech_workflows_overview_DocBlocks: DocBlock[];
 //#endregion
 export { tech_workflows_overview_DocBlocks };

package/dist/{docs/tech/workflows → workflow}/overview.docblock.js

@@ -1,6 +1,6 @@
-import { registerDocBlocks } from "../../registry.js";
+import { registerDocBlocks } from "../docs/registry.js";
 
-//#region src/docs/tech/workflows/overview.docblock.ts
+//#region src/workflow/overview.docblock.ts
 const tech_workflows_overview_DocBlocks = [{
 	id: "docs.tech.workflows.overview",
 	title: "WorkflowSpec Overview",

package/dist/workspace-config/contractsrc-schema.d.ts

@@ -2,6 +2,16 @@ import * as z$1 from "zod";
 
 //#region src/workspace-config/contractsrc-schema.d.ts
 
+/**
+ * Schema output format for code generation.
+ * Controls how imported/generated schemas are written.
+ */
+declare const SchemaFormatSchema: z$1.ZodEnum<{
+  contractspec: "contractspec";
+  zod: "zod";
+  "json-schema": "json-schema";
+  graphql: "graphql";
+}>;
 /**
  * OpenAPI source configuration for import/sync/validate operations.
  */
@@ -19,10 +29,10 @@ declare const OpenApiSourceConfigSchema: z$1.ZodObject<{
   include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
   prefix: z$1.ZodOptional<z$1.ZodString>;
   defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+    deprecated: "deprecated";
     experimental: "experimental";
     beta: "beta";
     stable: "stable";
-    deprecated: "deprecated";
   }>>;
   defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
     user: "user";
@@ -30,6 +40,12 @@ declare const OpenApiSourceConfigSchema: z$1.ZodObject<{
     admin: "admin";
   }>>;
   defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  schemaFormat: z$1.ZodDefault<z$1.ZodEnum<{
+    contractspec: "contractspec";
+    zod: "zod";
+    "json-schema": "json-schema";
+    graphql: "graphql";
+  }>>;
 }, z$1.core.$strip>;
 declare const OpenApiExportConfigSchema: z$1.ZodObject<{
   outputPath: z$1.ZodDefault<z$1.ZodString>;
@@ -63,10 +79,10 @@ declare const OpenApiConfigSchema: z$1.ZodObject<{
     include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
     prefix: z$1.ZodOptional<z$1.ZodString>;
     defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+      deprecated: "deprecated";
       experimental: "experimental";
       beta: "beta";
       stable: "stable";
-      deprecated: "deprecated";
     }>>;
     defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
       user: "user";
@@ -74,6 +90,12 @@ declare const OpenApiConfigSchema: z$1.ZodObject<{
       admin: "admin";
     }>>;
     defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    schemaFormat: z$1.ZodDefault<z$1.ZodEnum<{
+      contractspec: "contractspec";
+      zod: "zod";
+      "json-schema": "json-schema";
+      graphql: "graphql";
+    }>>;
   }, z$1.core.$strip>>>;
   export: z$1.ZodOptional<z$1.ZodObject<{
     outputPath: z$1.ZodDefault<z$1.ZodString>;
@@ -486,9 +508,9 @@ declare const ContractsrcSchema: z$1.ZodObject<{
   }>>;
   aiModel: z$1.ZodOptional<z$1.ZodString>;
   agentMode: z$1.ZodDefault<z$1.ZodEnum<{
-    simple: "simple";
     cursor: "cursor";
     "claude-code": "claude-code";
+    simple: "simple";
     "openai-codex": "openai-codex";
   }>>;
   customEndpoint: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodURL>>;
@@ -561,10 +583,10 @@ declare const ContractsrcSchema: z$1.ZodObject<{
       include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
       prefix: z$1.ZodOptional<z$1.ZodString>;
       defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+        deprecated: "deprecated";
         experimental: "experimental";
         beta: "beta";
         stable: "stable";
-        deprecated: "deprecated";
       }>>;
       defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
         user: "user";
@@ -572,6 +594,12 @@ declare const ContractsrcSchema: z$1.ZodObject<{
         admin: "admin";
       }>>;
       defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+      schemaFormat: z$1.ZodDefault<z$1.ZodEnum<{
+        contractspec: "contractspec";
+        zod: "zod";
+        "json-schema": "json-schema";
+        graphql: "graphql";
+      }>>;
     }, z$1.core.$strip>>>;
     export: z$1.ZodOptional<z$1.ZodObject<{
       outputPath: z$1.ZodDefault<z$1.ZodString>;
@@ -760,6 +788,12 @@ declare const ContractsrcSchema: z$1.ZodObject<{
       }>>;
     }, z$1.core.$strip>>>;
   }, z$1.core.$strip>>;
+  schemaFormat: z$1.ZodDefault<z$1.ZodEnum<{
+    contractspec: "contractspec";
+    zod: "zod";
+    "json-schema": "json-schema";
+    graphql: "graphql";
+  }>>;
 }, z$1.core.$strip>;
 type OpenApiSourceConfig = z$1.infer<typeof OpenApiSourceConfigSchema>;
 type OpenApiExportConfig = z$1.infer<typeof OpenApiExportConfigSchema>;
@@ -778,9 +812,10 @@ type RuleSeverity = z$1.infer<typeof RuleSeveritySchema>;
 type SpecKind = z$1.infer<typeof SpecKindSchema>;
 type LintRules = z$1.infer<typeof LintRulesSchema>;
 type RulesConfig = z$1.infer<typeof RulesConfigSchema>;
+type SchemaFormat = z$1.infer<typeof SchemaFormatSchema>;
 /**
  * Default configuration values.
  */
 declare const DEFAULT_CONTRACTSRC: ContractsrcConfig;
 //#endregion
-export { CheckRunConfig, CheckRunConfigSchema, CiConfig, CiConfigSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspace, ExternalWorkspaceSchema, FolderConventions, FolderConventionsSchema, GroupingRule, GroupingRuleSchema, GroupingStrategy, GroupingStrategySchema, ImpactConfig, ImpactConfigSchema, LintRules, LintRulesSchema, MetaRepoConfig, MetaRepoConfigSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, PrCommentConfig, PrCommentConfigSchema, RuleSeverity, RuleSeveritySchema, RulesConfig, RulesConfigSchema, SpecKind, SpecKindSchema };
+export { CheckRunConfig, CheckRunConfigSchema, CiConfig, CiConfigSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspace, ExternalWorkspaceSchema, FolderConventions, FolderConventionsSchema, GroupingRule, GroupingRuleSchema, GroupingStrategy, GroupingStrategySchema, ImpactConfig, ImpactConfigSchema, LintRules, LintRulesSchema, MetaRepoConfig, MetaRepoConfigSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, PrCommentConfig, PrCommentConfigSchema, RuleSeverity, RuleSeveritySchema, RulesConfig, RulesConfigSchema, SchemaFormat, SchemaFormatSchema, SpecKind, SpecKindSchema };

package/dist/workspace-config/contractsrc-schema.js

@@ -8,6 +8,16 @@ import * as z$1 from "zod";
 * and are shared across CLI tools and libraries.
 */
 /**
+* Schema output format for code generation.
+* Controls how imported/generated schemas are written.
+*/
+const SchemaFormatSchema = z$1.enum([
+	"contractspec",
+	"zod",
+	"json-schema",
+	"graphql"
+]);
+/**
 * OpenAPI source configuration for import/sync/validate operations.
 */
 const OpenApiSourceConfigSchema = z$1.object({
@@ -34,7 +44,8 @@ const OpenApiSourceConfigSchema = z$1.object({
 		"user",
 		"admin"
 	]).optional(),
-	defaultOwners: z$1.array(z$1.string()).optional()
+	defaultOwners: z$1.array(z$1.string()).optional(),
+	schemaFormat: SchemaFormatSchema.default("contractspec")
 });
 const OpenApiExportConfigSchema = z$1.object({
 	outputPath: z$1.string().default("./openapi.json"),
@@ -222,7 +233,8 @@ const ContractsrcSchema = z$1.object({
 	openapi: OpenApiConfigSchema.optional(),
 	ci: CiConfigSchema.optional(),
 	metaRepo: MetaRepoConfigSchema.optional(),
-	rules: RulesConfigSchema.optional()
+	rules: RulesConfigSchema.optional(),
+	schemaFormat: SchemaFormatSchema.default("contractspec")
 });
 /**
 * Default configuration values.
@@ -240,8 +252,9 @@ const DEFAULT_CONTRACTSRC = {
 		groupByFeature: true
 	},
 	defaultOwners: [],
-	defaultTags: []
+	defaultTags: [],
+	schemaFormat: "contractspec"
 };
 
 //#endregion
-export { CheckRunConfigSchema, CiConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspaceSchema, FolderConventionsSchema, GroupingRuleSchema, GroupingStrategySchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RulesConfigSchema, SpecKindSchema };
+export { CheckRunConfigSchema, CiConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspaceSchema, FolderConventionsSchema, GroupingRuleSchema, GroupingStrategySchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RulesConfigSchema, SchemaFormatSchema, SpecKindSchema };

package/dist/workspace-config/index.d.ts

@@ -1,2 +1,2 @@
-import { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
-export { type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema };
+import { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, SchemaFormat, SchemaFormatSchema } from "./contractsrc-schema.js";
+export { type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema, type SchemaFormat, SchemaFormatSchema };

package/dist/workspace-config/index.js

@@ -1,3 +1,3 @@
-import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
+import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema } from "./contractsrc-schema.js";
 
-export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema };
+export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema };

package/dist/workspace-config/workspace-config.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/workspace-config/workspace-config.docblock.d.ts
+declare const tech_workspace_config_DocBlocks: DocBlock[];
+//#endregion
+export { tech_workspace_config_DocBlocks };

package/dist/workspace-config/workspace-config.docblock.js

@@ -0,0 +1,45 @@
+import { registerDocBlocks } from "../docs/registry.js";
+
+//#region src/workspace-config/workspace-config.docblock.ts
+const tech_workspace_config_DocBlocks = [{
+	id: "docs.tech.contracts.workspace-config",
+	title: "Workspace Configuration (.contractsrc)",
+	summary: "Configuration-as-code conventions for ContractSpec workspaces (`.contractsrc.json`).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/workspace-config",
+	tags: [
+		"tech",
+		"contracts",
+		"config"
+	],
+	body: `## Workspace Configuration (.contractsrc)
+
+ContractSpec uses a hierarchical configuration system anchored by \`.contractsrc.json\` files. Configuration loader supports standard rc-file discovery (cosmiconfig).
+
+### Schema Formats
+
+The \`schemaFormat\` option controls the output format of schema generation commands (like \`contractspec openapi import\`).
+
+Supported formats:
+- \`contractspec\` (default): Generates standard \`defineSchemaModel\` code.
+- \`zod\`: Generates raw Zod schemas using \`z.object({...})\`.
+- \`json-schema\`: Generates JSON Schema definitions.
+- \`graphql\`: Generates GraphQL SDL type definitions.
+
+### Config Interface
+
+\`\`\`ts
+export interface ContractsrcConfig {
+  // ... existing fields ...
+  schemaFormat?: 'contractspec' | 'zod' | 'json-schema' | 'graphql';
+}
+\`\`\`
+
+Defined in \`@lssm/lib.contracts/workspace-config\`.
+`
+}];
+registerDocBlocks(tech_workspace_config_DocBlocks);
+
+//#endregion
+export { tech_workspace_config_DocBlocks };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.contracts",
-  "version": "1.42.9",
+  "version": "1.43.0",
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
@@ -16,8 +16,8 @@
     "test": "bun run"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "1.42.9",
-    "@lssm/tool.typescript": "1.42.9",
+    "@lssm/tool.tsdown": "1.43.0",
+    "@lssm/tool.typescript": "1.43.0",
     "@types/express": "^5.0.3",
     "@types/turndown": "^5.0.6",
     "tsdown": "^0.18.3",
@@ -35,8 +35,8 @@
     "@elevenlabs/elevenlabs-js": "^2.27.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
-    "@lssm/lib.logger": "1.42.9",
-    "@lssm/lib.schema": "1.42.9",
+    "@lssm/lib.logger": "1.43.0",
+    "@lssm/lib.schema": "1.43.0",
     "@mistralai/mistralai": "^1.11.0",
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@qdrant/js-client-rest": "^1.16.2",
@@ -112,6 +112,7 @@
     "./docs/tech/contracts/graphql-typed-outputs.docblock": "./dist/docs/tech/contracts/graphql-typed-outputs.docblock.js",
     "./docs/tech/contracts/migrations.docblock": "./dist/docs/tech/contracts/migrations.docblock.js",
     "./docs/tech/contracts/openapi-export.docblock": "./dist/docs/tech/contracts/openapi-export.docblock.js",
+    "./docs/tech/contracts/openapi-import.docblock": "./dist/docs/tech/contracts/openapi-import.docblock.js",
     "./docs/tech/contracts/ops-to-presentation-linking.docblock": "./dist/docs/tech/contracts/ops-to-presentation-linking.docblock.js",
     "./docs/tech/contracts/overlays.docblock": "./dist/docs/tech/contracts/overlays.docblock.js",
     "./docs/tech/contracts/README.docblock": "./dist/docs/tech/contracts/README.docblock.js",
@@ -135,7 +136,6 @@
     "./docs/tech/telemetry-ingest.docblock": "./dist/docs/tech/telemetry-ingest.docblock.js",
     "./docs/tech/templates/runtime.docblock": "./dist/docs/tech/templates/runtime.docblock.js",
     "./docs/tech/vscode-extension.docblock": "./dist/docs/tech/vscode-extension.docblock.js",
-    "./docs/tech/workflows/overview.docblock": "./dist/docs/tech/workflows/overview.docblock.js",
     "./docs/types": "./dist/docs/types.js",
     "./events": "./dist/events.js",
     "./experiments/docs/experiments.docblock": "./dist/experiments/docs/experiments.docblock.js",
@@ -317,6 +317,7 @@
     "./workflow/adapters/file-adapter": "./dist/workflow/adapters/file-adapter.js",
     "./workflow/adapters/memory-store": "./dist/workflow/adapters/memory-store.js",
     "./workflow/expression": "./dist/workflow/expression.js",
+    "./workflow/overview.docblock": "./dist/workflow/overview.docblock.js",
     "./workflow/runner": "./dist/workflow/runner.js",
     "./workflow/sla-monitor": "./dist/workflow/sla-monitor.js",
     "./workflow/spec": "./dist/workflow/spec.js",
@@ -324,6 +325,7 @@
     "./workflow/validation": "./dist/workflow/validation.js",
     "./workspace-config": "./dist/workspace-config/index.js",
     "./workspace-config/contractsrc-schema": "./dist/workspace-config/contractsrc-schema.js",
+    "./workspace-config/workspace-config.docblock": "./dist/workspace-config/workspace-config.docblock.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -584,5 +586,6 @@
     "type": "git",
     "url": "https://github.com/lssm-tech/contractspec.git",
     "directory": "packages/libs/contracts"
-  }
+  },
+  "homepage": "https://contractspec.io"
 }