@contractspec/lib.contracts 1.46.2 → 1.48.0

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

@@ -22,13 +22,13 @@ const SchemaFormatSchema = z$2.enum([
 */
 const OpenApiSourceConfigSchema = z$2.object({
 	name: z$2.string(),
-	url: z$2.url().optional(),
+	url: z$2.string().url().optional(),
 	file: z$2.string().optional(),
 	syncMode: z$2.enum([
 		"import",
 		"sync",
 		"validate"
-	]).default("validate"),
+	]).default("validate").optional(),
 	tags: z$2.array(z$2.string()).optional(),
 	exclude: z$2.array(z$2.string()).optional(),
 	include: z$2.array(z$2.string()).optional(),
@@ -45,11 +45,11 @@ const OpenApiSourceConfigSchema = z$2.object({
 		"admin"
 	]).optional(),
 	defaultOwners: z$2.array(z$2.string()).optional(),
-	schemaFormat: SchemaFormatSchema.default("contractspec")
+	schemaFormat: SchemaFormatSchema.default("contractspec").optional()
 });
 const OpenApiExportConfigSchema = z$2.object({
-	outputPath: z$2.string().default("./openapi.json"),
-	format: z$2.enum(["json", "yaml"]).default("json"),
+	outputPath: z$2.string().default("./openapi.json").optional(),
+	format: z$2.enum(["json", "yaml"]).default("json").optional(),
 	title: z$2.string().optional(),
 	version: z$2.string().optional(),
 	description: z$2.string().optional(),
@@ -89,12 +89,12 @@ const GroupingRuleSchema = z$2.object({
 * Output directory conventions for generated specs.
 */
 const FolderConventionsSchema = z$2.object({
-	models: z$2.string().default("models"),
-	operations: z$2.string().default("operations/commands|queries"),
-	events: z$2.string().default("events"),
-	presentations: z$2.string().default("presentations"),
-	forms: z$2.string().default("forms"),
-	groupByFeature: z$2.boolean().default(true),
+	models: z$2.string().default("models").optional(),
+	operations: z$2.string().default("operations/commands|queries").optional(),
+	events: z$2.string().default("events").optional(),
+	presentations: z$2.string().default("presentations").optional(),
+	forms: z$2.string().default("forms").optional(),
+	groupByFeature: z$2.boolean().default(true).optional(),
 	operationsGrouping: GroupingRuleSchema.optional(),
 	modelsGrouping: GroupingRuleSchema.optional(),
 	eventsGrouping: GroupingRuleSchema.optional()
@@ -103,24 +103,24 @@ const FolderConventionsSchema = z$2.object({
 * PR comment configuration for CI/CD.
 */
 const PrCommentConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(true),
-	template: z$2.enum(["minimal", "detailed"]).default("detailed"),
-	updateExisting: z$2.boolean().default(true)
+	enabled: z$2.boolean().default(true).optional(),
+	template: z$2.enum(["minimal", "detailed"]).default("detailed").optional(),
+	updateExisting: z$2.boolean().default(true).optional()
 });
 /**
 * GitHub check run configuration for CI/CD.
 */
 const CheckRunConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(true),
-	name: z$2.string().default("ContractSpec Impact"),
-	failOnBreaking: z$2.boolean().default(true),
-	failOnChanges: z$2.boolean().default(false)
+	enabled: z$2.boolean().default(true).optional(),
+	name: z$2.string().default("ContractSpec Impact").optional(),
+	failOnBreaking: z$2.boolean().default(true).optional(),
+	failOnChanges: z$2.boolean().default(false).optional()
 });
 /**
 * Impact detection configuration for CI/CD.
 */
 const ImpactConfigSchema = z$2.object({
-	baseline: z$2.string().default("default-branch"),
+	baseline: z$2.string().default("default-branch").optional(),
 	include: z$2.array(z$2.string()).optional(),
 	exclude: z$2.array(z$2.string()).optional()
 });
@@ -132,10 +132,10 @@ const CiConfigSchema = z$2.object({
 		"structure",
 		"integrity",
 		"deps"
-	]),
+	]).optional(),
 	skipChecks: z$2.array(z$2.string()).optional(),
-	failOnWarnings: z$2.boolean().default(false),
-	uploadSarif: z$2.boolean().default(true),
+	failOnWarnings: z$2.boolean().default(false).optional(),
+	uploadSarif: z$2.boolean().default(true).optional(),
 	prComment: PrCommentConfigSchema.optional(),
 	checkRun: CheckRunConfigSchema.optional(),
 	impact: ImpactConfigSchema.optional()
@@ -147,7 +147,7 @@ const ExternalWorkspaceSchema = z$2.object({
 	alias: z$2.string(),
 	submodule: z$2.string(),
 	packages: z$2.array(z$2.string()).optional(),
-	autoResolve: z$2.boolean().default(true)
+	autoResolve: z$2.boolean().default(true).optional()
 });
 /**
 * Meta-repo configuration section.
@@ -155,7 +155,7 @@ const ExternalWorkspaceSchema = z$2.object({
 const MetaRepoConfigSchema = z$2.object({
 	activeScope: z$2.string().optional(),
 	externalWorkspaces: z$2.array(ExternalWorkspaceSchema).optional(),
-	crossWorkspaceSearch: z$2.boolean().default(false)
+	crossWorkspaceSearch: z$2.boolean().default(false).optional()
 });
 /**
 * Supported formatter tools.
@@ -171,11 +171,11 @@ const FormatterTypeSchema = z$2.enum([
 * Formatter configuration for code generation.
 */
 const FormatterConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(true),
+	enabled: z$2.boolean().default(true).optional(),
 	type: FormatterTypeSchema.optional(),
 	command: z$2.string().optional(),
 	args: z$2.array(z$2.string()).optional(),
-	timeout: z$2.number().default(3e4)
+	timeout: z$2.number().default(3e4).optional()
 });
 /**
 * Bump strategy for version management.
@@ -201,19 +201,19 @@ const ChangelogTierSchema = z$2.enum([
 * Versioning configuration for changelog and version management.
 */
 const VersioningConfigSchema = z$2.object({
-	autoBump: z$2.boolean().default(false),
-	bumpStrategy: BumpStrategySchema.default("impact"),
-	integrateWithChangesets: z$2.boolean().default(false),
+	autoBump: z$2.boolean().default(false).optional(),
+	bumpStrategy: BumpStrategySchema.default("impact").optional(),
+	integrateWithChangesets: z$2.boolean().default(false).optional(),
 	changelogTiers: z$2.array(ChangelogTierSchema).default([
 		"spec",
 		"library",
 		"monorepo"
-	]),
-	format: ChangelogFormatSchema.default("keep-a-changelog"),
-	commitChanges: z$2.boolean().default(false),
-	commitMessage: z$2.string().default("chore: bump spec versions"),
-	createTags: z$2.boolean().default(false),
-	tagPrefix: z$2.string().default("v"),
+	]).optional(),
+	format: ChangelogFormatSchema.default("keep-a-changelog").optional(),
+	commitChanges: z$2.boolean().default(false).optional(),
+	commitMessage: z$2.string().default("chore: bump spec versions").optional(),
+	createTags: z$2.boolean().default(false).optional(),
+	tagPrefix: z$2.string().default("v").optional(),
 	include: z$2.array(z$2.string()).optional(),
 	exclude: z$2.array(z$2.string()).optional()
 });
@@ -233,28 +233,28 @@ const RuleSyncTargetSchema = z$2.enum([
 * Configuration for AI agent rules synchronization (rulesync).
 */
 const RuleSyncConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(false),
-	rulesDir: z$2.string().default("./.rules"),
-	rules: z$2.array(z$2.string()).default(["**/*.rule.md"]),
-	targets: z$2.array(RuleSyncTargetSchema).default(["cursor", "windsurf"]),
-	autoSync: z$2.boolean().default(true),
-	ejectMode: z$2.boolean().default(false)
+	enabled: z$2.boolean().default(false).optional(),
+	rulesDir: z$2.string().default("./.rules").optional(),
+	rules: z$2.array(z$2.string()).default(["**/*.rule.md"]).optional(),
+	targets: z$2.array(RuleSyncTargetSchema).default(["cursor", "windsurf"]).optional(),
+	autoSync: z$2.boolean().default(true).optional(),
+	ejectMode: z$2.boolean().default(false).optional()
 });
 /**
 * Claude Agent SDK configuration.
 */
 const ClaudeAgentSDKConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(false),
+	enabled: z$2.boolean().default(false).optional(),
 	apiKey: z$2.string().optional(),
-	model: z$2.string().default("claude-sonnet-4-20250514"),
-	computerUse: z$2.boolean().default(false),
-	extendedThinking: z$2.boolean().default(false)
+	model: z$2.string().default("claude-sonnet-4-20250514").optional(),
+	computerUse: z$2.boolean().default(false).optional(),
+	extendedThinking: z$2.boolean().default(false).optional()
 });
 /**
 * OpenCode SDK configuration.
 */
 const OpenCodeSDKConfigSchema = z$2.object({
-	enabled: z$2.boolean().default(false),
+	enabled: z$2.boolean().default(false).optional(),
 	serverUrl: z$2.string().optional(),
 	port: z$2.number().optional(),
 	agentType: z$2.enum([
@@ -262,7 +262,7 @@ const OpenCodeSDKConfigSchema = z$2.object({
 		"plan",
 		"general",
 		"explore"
-	]).default("general"),
+	]).default("general").optional(),
 	model: z$2.string().optional()
 });
 /**
@@ -313,6 +313,39 @@ const LintRulesSchema = z$2.object({
 	"data-view-fields": RuleSeveritySchema.optional()
 });
 /**
+* Test linking strategy for discovering test coverage.
+*/
+const TestLinkingStrategySchema = z$2.enum([
+	"target-first",
+	"convention-only",
+	"both"
+]);
+/**
+* Test linking configuration for contract-first test discovery.
+*/
+const TestLinkingConfigSchema = z$2.object({
+	strategy: TestLinkingStrategySchema.default("both").optional(),
+	warnOnConvention: z$2.boolean().default(false).optional()
+});
+/**
+* Testing configuration section.
+*/
+const TestingConfigSchema = z$2.object({
+	runner: z$2.enum([
+		"internal",
+		"jest",
+		"vitest",
+		"bun"
+	]).default("internal").optional(),
+	testMatch: z$2.array(z$2.string()).default(["**/*.{test,spec}.{ts,js}"]).optional(),
+	autoGenerate: z$2.boolean().default(false).optional(),
+	integrity: z$2.object({
+		requireTestsFor: z$2.array(SpecKindSchema).optional(),
+		minCoverage: z$2.number().optional()
+	}).optional(),
+	testLinking: TestLinkingConfigSchema.optional()
+});
+/**
 * Full rules configuration with global defaults and per-kind overrides.
 */
 const RulesConfigSchema = z$2.object({
@@ -333,7 +366,7 @@ const ContractsrcSchema = z$2.object({
 		"openai",
 		"ollama",
 		"custom"
-	]).default("claude"),
+	]).default("claude").optional(),
 	aiModel: z$2.string().optional(),
 	agentMode: z$2.enum([
 		"simple",
@@ -342,13 +375,13 @@ const ContractsrcSchema = z$2.object({
 		"openai-codex",
 		"claude-agent-sdk",
 		"opencode-sdk"
-	]).default("simple"),
+	]).default("simple").optional(),
 	customEndpoint: z$2.url().nullable().optional(),
 	customApiKey: z$2.string().nullable().optional(),
-	outputDir: z$2.string().default("./src"),
-	conventions: FolderConventionsSchema,
-	defaultOwners: z$2.array(z$2.string()).default([]),
-	defaultTags: z$2.array(z$2.string()).default([]),
+	outputDir: z$2.string().default("./src").optional(),
+	conventions: FolderConventionsSchema.optional(),
+	defaultOwners: z$2.array(z$2.string()).default([]).optional(),
+	defaultTags: z$2.array(z$2.string()).default([]).optional(),
 	packages: z$2.array(z$2.string()).optional(),
 	excludePackages: z$2.array(z$2.string()).optional(),
 	recursive: z$2.boolean().optional(),
@@ -356,8 +389,9 @@ const ContractsrcSchema = z$2.object({
 	ci: CiConfigSchema.optional(),
 	metaRepo: MetaRepoConfigSchema.optional(),
 	rules: RulesConfigSchema.optional(),
+	testing: TestingConfigSchema.optional(),
 	hooks: HooksConfigSchema.optional(),
-	schemaFormat: SchemaFormatSchema.default("contractspec"),
+	schemaFormat: SchemaFormatSchema.default("contractspec").optional(),
 	formatter: FormatterConfigSchema.optional(),
 	versioning: VersioningConfigSchema.optional(),
 	ruleSync: RuleSyncConfigSchema.optional(),
@@ -384,4 +418,4 @@ const DEFAULT_CONTRACTSRC = {
 };
 
 //#endregion
-export { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, CheckRunConfigSchema, CiConfigSchema, ClaudeAgentSDKConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalAgentsConfigSchema, ExternalWorkspaceSchema, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, GroupingRuleSchema, GroupingStrategySchema, HooksConfigSchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, OpenCodeSDKConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RuleSyncConfigSchema, RuleSyncTargetSchema, RulesConfigSchema, SchemaFormatSchema, SpecKindSchema, VersioningConfigSchema };
+export { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, CheckRunConfigSchema, CiConfigSchema, ClaudeAgentSDKConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalAgentsConfigSchema, ExternalWorkspaceSchema, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, GroupingRuleSchema, GroupingStrategySchema, HooksConfigSchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, OpenCodeSDKConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RuleSyncConfigSchema, RuleSyncTargetSchema, RulesConfigSchema, SchemaFormatSchema, SpecKindSchema, TestLinkingConfigSchema, TestLinkingStrategySchema, TestingConfigSchema, VersioningConfigSchema };

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

@@ -0,0 +1,346 @@
+//#region src/workspace-config/contractsrc-types.d.ts
+/**
+ * Explicit type definitions for ContractSpec configuration.
+ *
+ * These interfaces mirror the Zod schemas in `contractsrc-schema.ts` but are
+ * statically defined to reduce compiler inference cost and memory usage.
+ */
+type SchemaFormat = 'contractspec' | 'zod' | 'json-schema' | 'graphql';
+type GroupingStrategy = 'by-tag' | 'by-owner' | 'by-domain' | 'by-url-path-single' | 'by-url-path-multi' | 'by-feature' | 'none';
+type FormatterType = 'prettier' | 'eslint' | 'biome' | 'dprint' | 'custom';
+type BumpStrategy = 'impact' | 'conventional';
+type ChangelogFormat = 'keep-a-changelog' | 'conventional' | 'custom';
+type ChangelogTier = 'spec' | 'library' | 'monorepo';
+type RuleSyncTarget = 'cursor' | 'windsurf' | 'cline' | 'claude-code' | 'copilot' | 'subagent' | 'skill';
+type RuleSeverity = 'off' | 'warn' | 'error';
+type SpecKind = 'operation' | 'event' | 'presentation' | 'feature' | 'workflow' | 'data-view' | 'migration' | 'telemetry' | 'experiment' | 'app-config';
+type TestLinkingStrategy = 'target-first' | 'convention-only' | 'both';
+interface OpenApiSourceConfig {
+  /** Friendly name for the source */
+  name: string;
+  /** Remote URL to fetch OpenAPI spec from */
+  url?: string;
+  /** Local file path to OpenAPI spec */
+  file?: string;
+  /** Sync mode: import (one-time), sync (update), validate (check only) */
+  syncMode?: 'import' | 'sync' | 'validate';
+  /** Only import operations with these tags */
+  tags?: string[];
+  /** Exclude operations with these operationIds */
+  exclude?: string[];
+  /** Include operations with these operationIds (overrides exclude) */
+  include?: string[];
+  /** Prefix for generated spec names */
+  prefix?: string;
+  /** Default stability for imported specs */
+  defaultStability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
+  /** Default auth level for imported specs */
+  defaultAuth?: 'anonymous' | 'user' | 'admin';
+  /** Default owners for imported specs */
+  defaultOwners?: string[];
+  /** Output schema format for generated models */
+  schemaFormat?: SchemaFormat;
+}
+interface OpenApiExportConfig {
+  /** Output path for exported OpenAPI document */
+  outputPath?: string;
+  /** Output format */
+  format?: 'json' | 'yaml';
+  /** API title for export */
+  title?: string;
+  /** API version for export */
+  version?: string;
+  /** API description for export */
+  description?: string;
+  /** Server URLs to include in export */
+  servers?: {
+    url: string;
+    description?: string;
+  }[];
+}
+interface OpenApiConfig {
+  /** External OpenAPI sources to import/sync from */
+  sources?: OpenApiSourceConfig[];
+  /** Export configuration */
+  export?: OpenApiExportConfig;
+}
+interface GroupingRule {
+  /** Grouping strategy to apply */
+  strategy: GroupingStrategy;
+  /** For url-path strategies, the level depth (default: 1) */
+  urlPathLevel?: number;
+  /** Custom key extraction pattern (regex or glob) */
+  pattern?: string;
+}
+interface FolderConventions {
+  models?: string;
+  operations?: string;
+  events?: string;
+  presentations?: string;
+  forms?: string;
+  /** Enable feature/module folder grouping (default: true) */
+  groupByFeature?: boolean;
+  /** Grouping rule for operations */
+  operationsGrouping?: GroupingRule;
+  /** Grouping rule for models */
+  modelsGrouping?: GroupingRule;
+  /** Grouping rule for events */
+  eventsGrouping?: GroupingRule;
+}
+interface PrCommentConfig {
+  /** Enable PR comments */
+  enabled?: boolean;
+  /** Comment template: 'minimal' | 'detailed' */
+  template?: 'minimal' | 'detailed';
+  /** Update existing comment instead of creating new */
+  updateExisting?: boolean;
+}
+interface CheckRunConfig {
+  /** Enable GitHub check run creation */
+  enabled?: boolean;
+  /** Check run name */
+  name?: string;
+  /** Fail check on breaking changes */
+  failOnBreaking?: boolean;
+  /** Fail check on any contract changes */
+  failOnChanges?: boolean;
+}
+interface ImpactConfig {
+  /** Baseline for comparison: 'default-branch' | 'base-ref' | 'tag:v*' */
+  baseline?: string;
+  /** Paths to include in impact detection (glob patterns) */
+  include?: string[];
+  /** Paths to exclude from impact detection (glob patterns) */
+  exclude?: string[];
+}
+interface CiConfig {
+  /** Default checks to run */
+  checks?: string[];
+  /** Checks to skip */
+  skipChecks?: string[];
+  /** Fail CI on warnings */
+  failOnWarnings?: boolean;
+  /** Upload SARIF to GitHub Code Scanning */
+  uploadSarif?: boolean;
+  /** PR comment configuration */
+  prComment?: PrCommentConfig;
+  /** GitHub check run configuration */
+  checkRun?: CheckRunConfig;
+  /** Impact detection configuration */
+  impact?: ImpactConfig;
+}
+interface ExternalWorkspace {
+  /** Alias for referencing this workspace (e.g., 'core', 'internal') */
+  alias: string;
+  /** Submodule name or relative path from meta-repo root */
+  submodule: string;
+  /** Package patterns to include from this workspace */
+  packages?: string[];
+  /** Whether to auto-resolve internal dependencies */
+  autoResolve?: boolean;
+}
+interface MetaRepoConfig {
+  /** Active submodule scope (defaults to auto-detected) */
+  activeScope?: string;
+  /** External workspace references for cross-workspace dependencies */
+  externalWorkspaces?: ExternalWorkspace[];
+  /** Whether to search for specs across all submodules */
+  crossWorkspaceSearch?: boolean;
+}
+interface FormatterConfig {
+  /** Enable/disable formatting (default: true if formatter detected) */
+  enabled?: boolean;
+  /** Formatter to use (auto-detected if not specified) */
+  type?: FormatterType;
+  /** Custom command for 'custom' type (e.g., "bunx prettier --write") */
+  command?: string;
+  /** Extra arguments to pass to formatter */
+  args?: string[];
+  /** Timeout in milliseconds (default: 30000) */
+  timeout?: number;
+}
+interface VersioningConfig {
+  /** Enable automated version bumping in CI */
+  autoBump?: boolean;
+  /** Strategy for determining version bumps */
+  bumpStrategy?: BumpStrategy;
+  /** Integrate with Changesets (generate .changeset files) */
+  integrateWithChangesets?: boolean;
+  /** Changelog tiers to generate */
+  changelogTiers?: ChangelogTier[];
+  /** Changelog format template */
+  format?: ChangelogFormat;
+  /** Commit changes after version bump (CI mode) */
+  commitChanges?: boolean;
+  /** Commit message template (supports {version}, {specs}) */
+  commitMessage?: string;
+  /** Create git tags for versions */
+  createTags?: boolean;
+  /** Tag prefix (e.g., "v" -> v1.0.0, "spec-" -> spec-1.0.0) */
+  tagPrefix?: string;
+  /** Paths to include for version analysis (glob patterns) */
+  include?: string[];
+  /** Paths to exclude from version analysis (glob patterns) */
+  exclude?: string[];
+}
+interface RuleSyncConfig {
+  /** Enable automated rule synchronization */
+  enabled?: boolean;
+  /** Root directory for source rule files */
+  rulesDir?: string;
+  /** Source rule files (glob patterns) */
+  rules?: string[];
+  /** Synchronization targets (tools to generate rules for) */
+  targets?: RuleSyncTarget[];
+  /** Automatically synchronize rules on workspace changes or builds */
+  autoSync?: boolean;
+  /** Whether to eject/copy source rules instead of generating from Unified Rules */
+  ejectMode?: boolean;
+}
+interface ClaudeAgentSDKConfig {
+  /** Enable Claude Agent SDK provider */
+  enabled?: boolean;
+  /** API key (defaults to ANTHROPIC_API_KEY env var) */
+  apiKey?: string;
+  /** Model to use (defaults to claude-sonnet-4-20250514) */
+  model?: string;
+  /** Enable computer use capabilities */
+  computerUse?: boolean;
+  /** Enable extended thinking mode */
+  extendedThinking?: boolean;
+}
+interface OpenCodeSDKConfig {
+  /** Enable OpenCode SDK provider */
+  enabled?: boolean;
+  /** Server URL (defaults to http://127.0.0.1:4096) */
+  serverUrl?: string;
+  /** Server port (alternative to full URL) */
+  port?: number;
+  /** Agent type to use */
+  agentType?: 'build' | 'plan' | 'general' | 'explore';
+  /** Model to use */
+  model?: string;
+}
+interface ExternalAgentsConfig {
+  /** Claude Agent SDK configuration */
+  claudeAgent?: ClaudeAgentSDKConfig;
+  /** OpenCode SDK configuration */
+  openCode?: OpenCodeSDKConfig;
+}
+interface LintRules {
+  /** Require acceptance scenarios for operations */
+  'require-acceptance'?: RuleSeverity;
+  /** Require examples for operations */
+  'require-examples'?: RuleSeverity;
+  /** Require stability field */
+  'require-stability'?: RuleSeverity;
+  /** Require owners to follow proper format (@team or Enum) */
+  'require-owners-format'?: RuleSeverity;
+  /** Require event names to use past tense */
+  'event-past-tense'?: RuleSeverity;
+  /** Warn on TODO comments */
+  'no-todo'?: RuleSeverity;
+  /** Require workflow transitions */
+  'workflow-transitions'?: RuleSeverity;
+  /** Require privacy classification for telemetry */
+  'telemetry-privacy'?: RuleSeverity;
+  /** Require allocation config for experiments */
+  'experiment-allocation'?: RuleSeverity;
+  /** Require appId for app blueprints */
+  'app-config-appid'?: RuleSeverity;
+  /** Require capabilities for app blueprints */
+  'app-config-capabilities'?: RuleSeverity;
+  /** Require fields for data views */
+  'data-view-fields'?: RuleSeverity;
+}
+interface TestLinkingConfig {
+  /** Strategy for linking tests to specs */
+  strategy?: TestLinkingStrategy;
+  /** Warn when tests only use naming convention (no TestSpec.target) */
+  warnOnConvention?: boolean;
+}
+interface TestingConfig {
+  /** Test runner to use */
+  runner?: 'internal' | 'jest' | 'vitest' | 'bun';
+  /** Glob patterns for matching test files */
+  testMatch?: string[];
+  /** Enable automatic test generation */
+  autoGenerate?: boolean;
+  /** Integrity requirements for testing */
+  integrity?: {
+    /** Spec types that require test coverage */
+    requireTestsFor?: SpecKind[];
+    /** Minimum coverage percentage (if supported) */
+    minCoverage?: number;
+  };
+  /** Test linking configuration for contract-first test discovery */
+  testLinking?: TestLinkingConfig;
+}
+interface RulesConfig {
+  /** Global default rule severities */
+  defaults?: LintRules;
+  /** Per-kind rule severity overrides */
+  overrides?: Partial<Record<SpecKind, LintRules>>;
+}
+type HooksConfig = Record<string, string[]>;
+/**
+ * Full ContractSpec configuration (.contractsrc.json).
+ */
+/**
+ * Full ContractSpec configuration (.contractsrc.json).
+ * All fields are optional as they come from user configuration.
+ */
+interface ContractsrcFileConfig {
+  aiProvider?: 'claude' | 'openai' | 'ollama' | 'custom';
+  aiModel?: string;
+  agentMode?: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode-sdk';
+  customEndpoint?: string | null;
+  customApiKey?: string | null;
+  outputDir?: string;
+  conventions?: FolderConventions;
+  defaultOwners?: string[];
+  defaultTags?: string[];
+  packages?: string[];
+  excludePackages?: string[];
+  recursive?: boolean;
+  openapi?: OpenApiConfig;
+  ci?: CiConfig;
+  metaRepo?: MetaRepoConfig;
+  rules?: RulesConfig;
+  testing?: TestingConfig;
+  hooks?: HooksConfig;
+  schemaFormat?: SchemaFormat;
+  formatter?: FormatterConfig;
+  versioning?: VersioningConfig;
+  ruleSync?: RuleSyncConfig;
+  externalAgents?: ExternalAgentsConfig;
+}
+/**
+ * Resolved configuration with guaranteed defaults.
+ * This is what the application uses at runtime.
+ */
+interface ResolvedContractsrcConfig extends ContractsrcFileConfig {
+  aiProvider: 'claude' | 'openai' | 'ollama' | 'custom';
+  agentMode: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode-sdk';
+  outputDir: string;
+  conventions: {
+    models: string;
+    operations: string;
+    events: string;
+    presentations: string;
+    forms: string;
+    groupByFeature: boolean;
+    operationsGrouping?: GroupingRule;
+    modelsGrouping?: GroupingRule;
+    eventsGrouping?: GroupingRule;
+  };
+  defaultOwners: string[];
+  defaultTags: string[];
+  schemaFormat: SchemaFormat;
+}
+/**
+ * @deprecated Use ContractsrcFileConfig for file inputs or ResolvedContractsrcConfig for app usage.
+ */
+type ContractsrcConfig = ContractsrcFileConfig;
+//#endregion
+export { BumpStrategy, ChangelogFormat, ChangelogTier, CheckRunConfig, CiConfig, ClaudeAgentSDKConfig, ContractsrcConfig, ContractsrcFileConfig, ExternalAgentsConfig, ExternalWorkspace, FolderConventions, FormatterConfig, FormatterType, GroupingRule, GroupingStrategy, HooksConfig, ImpactConfig, LintRules, MetaRepoConfig, OpenApiConfig, OpenApiExportConfig, OpenApiSourceConfig, OpenCodeSDKConfig, PrCommentConfig, ResolvedContractsrcConfig, RuleSeverity, RuleSyncConfig, RuleSyncTarget, RulesConfig, SchemaFormat, SpecKind, TestLinkingConfig, TestLinkingStrategy, TestingConfig, VersioningConfig };

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

@@ -1,2 +1,3 @@
-import { BumpStrategy, BumpStrategySchema, ChangelogFormat, ChangelogFormatSchema, ChangelogTier, ChangelogTierSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, SchemaFormat, SchemaFormatSchema, VersioningConfig, VersioningConfigSchema } from "./contractsrc-schema.js";
-export { type BumpStrategy, BumpStrategySchema, type ChangelogFormat, ChangelogFormatSchema, type ChangelogTier, ChangelogTierSchema, type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type FormatterConfig, FormatterConfigSchema, type FormatterType, FormatterTypeSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema, type RuleSyncConfig, RuleSyncConfigSchema, type RuleSyncTarget, RuleSyncTargetSchema, type SchemaFormat, SchemaFormatSchema, type VersioningConfig, VersioningConfigSchema };
+import { BumpStrategy, ChangelogFormat, ChangelogTier, ContractsrcConfig, ContractsrcFileConfig, FolderConventions, FormatterConfig, FormatterType, OpenApiConfig, OpenApiExportConfig, OpenApiSourceConfig, ResolvedContractsrcConfig, RuleSyncConfig, RuleSyncTarget, SchemaFormat, VersioningConfig } from "./contractsrc-types.js";
+import { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, RuleSyncConfigSchema, RuleSyncTargetSchema, SchemaFormatSchema, VersioningConfigSchema } from "./contractsrc-schema.js";
+export { type BumpStrategy, BumpStrategySchema, type ChangelogFormat, ChangelogFormatSchema, type ChangelogTier, ChangelogTierSchema, type ContractsrcConfig, type ContractsrcFileConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type FormatterConfig, FormatterConfigSchema, type FormatterType, FormatterTypeSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema, type ResolvedContractsrcConfig, type RuleSyncConfig, RuleSyncConfigSchema, type RuleSyncTarget, RuleSyncTargetSchema, type SchemaFormat, SchemaFormatSchema, type VersioningConfig, VersioningConfigSchema };