@contractspec/lib.contracts 0.0.0-canary-20260119224949 → 0.0.0-canary-20260128200020

package/dist/workflow/validation.js

@@ -171,6 +171,199 @@ function detectCycles(adjacency, issues) {
 	};
 	for (const node of adjacency.keys()) dfs(node);
 }
+/**
+* Validate workflow consistency across registries.
+*
+* Checks that:
+* - All workflow specs are internally valid
+* - Operations referenced by steps exist
+* - Forms referenced by steps exist
+* - Capabilities required by steps exist
+*
+* @param deps - Registry dependencies
+* @returns Validation result
+*/
+function validateWorkflowConsistency(deps) {
+	const issues = [];
+	for (const workflow of deps.workflows.list()) {
+		const specIssues = validateWorkflowSpec(workflow, {
+			operations: deps.operations,
+			forms: deps.forms
+		});
+		issues.push(...specIssues.map((i) => ({
+			...i,
+			message: `[${workflow.meta.key}.v${workflow.meta.version}] ${i.message}`
+		})));
+		if (deps.capabilities) {
+			for (const step of workflow.definition.steps) for (const capRef of step.requiredCapabilities ?? []) if (!deps.capabilities.get(capRef.key, capRef.version)) issues.push({
+				level: "error",
+				message: `[${workflow.meta.key}.v${workflow.meta.version}] Step "${step.id}" references unknown capability "${capRef.key}.v${capRef.version}"`,
+				context: {
+					stepId: step.id,
+					capability: capRef
+				}
+			});
+		}
+		if (workflow.definition.compensation && deps.operations) {
+			for (const compStep of workflow.definition.compensation.steps) if (!deps.operations.get(compStep.operation.key, compStep.operation.version)) issues.push({
+				level: "error",
+				message: `[${workflow.meta.key}.v${workflow.meta.version}] Compensation for step "${compStep.stepId}" references unknown operation "${compStep.operation.key}.v${compStep.operation.version}"`,
+				context: {
+					stepId: compStep.stepId,
+					operation: compStep.operation
+				}
+			});
+		}
+		if (workflow.definition.sla?.stepDurationMs) {
+			const stepIds = new Set(workflow.definition.steps.map((s) => s.id));
+			for (const stepId of Object.keys(workflow.definition.sla.stepDurationMs)) if (!stepIds.has(stepId)) issues.push({
+				level: "warning",
+				message: `[${workflow.meta.key}.v${workflow.meta.version}] SLA references unknown step "${stepId}"`,
+				context: { stepId }
+			});
+		}
+	}
+	return {
+		valid: issues.filter((i) => i.level === "error").length === 0,
+		issues
+	};
+}
+/**
+* Assert workflow consistency across registries.
+*
+* @param deps - Registry dependencies
+* @throws {WorkflowValidationError} If validation fails
+*/
+function assertWorkflowConsistency(deps) {
+	const result = validateWorkflowConsistency(deps);
+	if (!result.valid) throw new WorkflowValidationError("Workflow consistency check failed", result.issues);
+}
+/**
+* Validate SLA configuration is reasonable.
+*
+* @param spec - Workflow spec to validate
+* @returns Array of validation issues
+*/
+function validateSlaConfig(spec) {
+	const issues = [];
+	const sla = spec.definition.sla;
+	if (!sla) return issues;
+	if (sla.totalDurationMs !== void 0 && sla.totalDurationMs <= 0) issues.push({
+		level: "error",
+		message: "SLA totalDurationMs must be positive",
+		context: { totalDurationMs: sla.totalDurationMs }
+	});
+	if (sla.stepDurationMs) {
+		for (const [stepId, duration] of Object.entries(sla.stepDurationMs)) if (duration <= 0) issues.push({
+			level: "error",
+			message: `SLA stepDurationMs for "${stepId}" must be positive`,
+			context: {
+				stepId,
+				duration
+			}
+		});
+		const stepDurationsSum = Object.values(sla.stepDurationMs).reduce((sum, d) => sum + d, 0);
+		if (sla.totalDurationMs && stepDurationsSum > sla.totalDurationMs) issues.push({
+			level: "warning",
+			message: `Sum of step durations (${stepDurationsSum}ms) exceeds total duration (${sla.totalDurationMs}ms)`,
+			context: {
+				stepDurationsSum,
+				totalDurationMs: sla.totalDurationMs
+			}
+		});
+	}
+	return issues;
+}
+/**
+* Validate compensation configuration.
+*
+* @param spec - Workflow spec to validate
+* @returns Array of validation issues
+*/
+function validateCompensation(spec) {
+	const issues = [];
+	const compensation = spec.definition.compensation;
+	if (!compensation) return issues;
+	const stepIds = new Set(spec.definition.steps.map((s) => s.id));
+	const coveredSteps = /* @__PURE__ */ new Set();
+	for (const compStep of compensation.steps) {
+		if (!stepIds.has(compStep.stepId)) issues.push({
+			level: "error",
+			message: `Compensation references unknown step "${compStep.stepId}"`,
+			context: { stepId: compStep.stepId }
+		});
+		if (coveredSteps.has(compStep.stepId)) issues.push({
+			level: "warning",
+			message: `Multiple compensation handlers for step "${compStep.stepId}"`,
+			context: { stepId: compStep.stepId }
+		});
+		coveredSteps.add(compStep.stepId);
+		if (!compStep.operation?.key || !compStep.operation?.version) issues.push({
+			level: "error",
+			message: `Compensation for step "${compStep.stepId}" must specify operation with key and version`,
+			context: { stepId: compStep.stepId }
+		});
+	}
+	const automationSteps = spec.definition.steps.filter((s) => s.type === "automation");
+	for (const step of automationSteps) if (!coveredSteps.has(step.id)) issues.push({
+		level: "warning",
+		message: `Automation step "${step.id}" has no compensation handler`,
+		context: { stepId: step.id }
+	});
+	return issues;
+}
+/**
+* Validate retry configuration.
+*
+* @param spec - Workflow spec to validate
+* @returns Array of validation issues
+*/
+function validateRetryConfig(spec) {
+	const issues = [];
+	for (const step of spec.definition.steps) {
+		if (!step.retry) continue;
+		if (step.retry.maxAttempts <= 0) issues.push({
+			level: "error",
+			message: `Step "${step.id}" retry maxAttempts must be positive`,
+			context: {
+				stepId: step.id,
+				maxAttempts: step.retry.maxAttempts
+			}
+		});
+		if (step.retry.delayMs <= 0) issues.push({
+			level: "error",
+			message: `Step "${step.id}" retry delayMs must be positive`,
+			context: {
+				stepId: step.id,
+				delayMs: step.retry.delayMs
+			}
+		});
+		if (step.retry.maxDelayMs !== void 0 && step.retry.maxDelayMs < step.retry.delayMs) issues.push({
+			level: "warning",
+			message: `Step "${step.id}" retry maxDelayMs (${step.retry.maxDelayMs}) is less than delayMs (${step.retry.delayMs})`,
+			context: { stepId: step.id }
+		});
+	}
+	return issues;
+}
+/**
+* Perform comprehensive workflow validation.
+*
+* @param spec - Workflow spec to validate
+* @param options - Validation options
+* @returns Validation result
+*/
+function validateWorkflowComprehensive(spec, options = {}) {
+	const issues = [];
+	issues.push(...validateWorkflowSpec(spec, options));
+	issues.push(...validateSlaConfig(spec));
+	issues.push(...validateCompensation(spec));
+	issues.push(...validateRetryConfig(spec));
+	return {
+		valid: issues.filter((i) => i.level === "error").length === 0,
+		issues
+	};
+}
 
 //#endregion
-export { WorkflowValidationError, assertWorkflowSpecValid, validateWorkflowSpec };
+export { WorkflowValidationError, assertWorkflowConsistency, assertWorkflowSpecValid, validateCompensation, validateRetryConfig, validateSlaConfig, validateWorkflowComprehensive, validateWorkflowConsistency, validateWorkflowSpec };

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

@@ -374,6 +374,7 @@ const ContractsrcSchema = z$2.object({
 		"claude-code",
 		"openai-codex",
 		"claude-agent-sdk",
+		"opencode",
 		"opencode-sdk"
 	]).default("simple").optional(),
 	customEndpoint: z$2.url().nullable().optional(),

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

@@ -238,7 +238,7 @@ interface LintRules {
   'require-owners-format'?: RuleSeverity;
   /** Require event names to use past tense */
   'event-past-tense'?: RuleSeverity;
-  /** Warn on TODO comments */
+  /** Warn on placeholder comments */
   'no-todo'?: RuleSeverity;
   /** Require workflow transitions */
   'workflow-transitions'?: RuleSeverity;
@@ -293,7 +293,7 @@ type HooksConfig = Record<string, string[]>;
 interface ContractsrcFileConfig {
   aiProvider?: 'claude' | 'openai' | 'ollama' | 'custom';
   aiModel?: string;
-  agentMode?: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode-sdk';
+  agentMode?: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode' | 'opencode-sdk';
   customEndpoint?: string | null;
   customApiKey?: string | null;
   outputDir?: string;
@@ -321,7 +321,7 @@ interface ContractsrcFileConfig {
  */
 interface ResolvedContractsrcConfig extends ContractsrcFileConfig {
   aiProvider: 'claude' | 'openai' | 'ollama' | 'custom';
-  agentMode: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode-sdk';
+  agentMode: 'simple' | 'cursor' | 'claude-code' | 'openai-codex' | 'claude-agent-sdk' | 'opencode' | 'opencode-sdk';
   outputDir: string;
   conventions: {
     models: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts",
-  "version": "0.0.0-canary-20260119224949",
+  "version": "0.0.0-canary-20260128200020",
   "description": "Core contract specification definitions and runtime",
   "keywords": [
     "contractspec",
@@ -14,7 +14,7 @@
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
     "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
+    "build:bundle": "NODE_OPTIONS=--max-old-space-size=8192 tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
     "registry:build": "bun run scripts/build-registry.ts",
@@ -25,18 +25,19 @@
     "test": "bun test"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.48.0",
-    "@contractspec/tool.typescript": "1.48.0",
+    "@contractspec/tool.tsdown": "1.52.0",
+    "@contractspec/tool.typescript": "1.52.0",
     "@types/express": "^5.0.3",
     "@types/turndown": "^5.0.6",
     "tsdown": "^0.19.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@aws-sdk/client-secrets-manager": "^3.966.0",
     "@aws-sdk/client-sqs": "^3.966.0",
-    "@contractspec/lib.logger": "1.48.0",
-    "@contractspec/lib.schema": "1.48.0",
+    "@contractspec/lib.logger": "1.52.0",
+    "@contractspec/lib.schema": "1.52.0",
     "@elevenlabs/elevenlabs-js": "^2.30.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
@@ -95,8 +96,11 @@
     "./app-config/validation": "./dist/app-config/validation.js",
     "./capabilities": "./dist/capabilities/index.js",
     "./capabilities/capabilities": "./dist/capabilities/capabilities.js",
+    "./capabilities/context": "./dist/capabilities/context.js",
     "./capabilities/docs/capabilities.docblock": "./dist/capabilities/docs/capabilities.docblock.js",
+    "./capabilities/guards": "./dist/capabilities/guards.js",
     "./capabilities/openbanking": "./dist/capabilities/openbanking.js",
+    "./capabilities/validation": "./dist/capabilities/validation.js",
     "./client": "./dist/client/index.js",
     "./client/react": "./dist/client/react/index.js",
     "./client/react/drivers/rn-reusables": "./dist/client/react/drivers/rn-reusables.js",
@@ -116,8 +120,26 @@
     "./data-views/types": "./dist/data-views/types.js",
     "./docs": "./dist/docs/index.js",
     "./docs/accessibility_wcag_compliance_specs.docblock": "./dist/docs/accessibility_wcag_compliance_specs.docblock.js",
+    "./docs/capabilities": "./dist/docs/capabilities/index.js",
+    "./docs/capabilities/documentationSystem.capability": "./dist/docs/capabilities/documentationSystem.capability.js",
+    "./docs/commands": "./dist/docs/commands/index.js",
+    "./docs/commands/docsGenerate.command": "./dist/docs/commands/docsGenerate.command.js",
+    "./docs/commands/docsPublish.command": "./dist/docs/commands/docsPublish.command.js",
+    "./docs/constants": "./dist/docs/constants.js",
+    "./docs/contracts": "./dist/docs/contracts.js",
+    "./docs/ensure-docblocks": "./dist/docs/ensure-docblocks.js",
+    "./docs/events": "./dist/docs/events/index.js",
+    "./docs/events/docsGenerated.event": "./dist/docs/events/docsGenerated.event.js",
+    "./docs/events/docsPublished.event": "./dist/docs/events/docsPublished.event.js",
+    "./docs/forms": "./dist/docs/forms/index.js",
+    "./docs/forms/docsSearch.form": "./dist/docs/forms/docsSearch.form.js",
     "./docs/meta.docs": "./dist/docs/meta.docs.js",
-    "./docs/presentations": "./dist/docs/presentations.js",
+    "./docs/presentations": "./dist/docs/presentations/index.js",
+    "./docs/presentations/docsLayout.presentation": "./dist/docs/presentations/docsLayout.presentation.js",
+    "./docs/presentations/docsReferencePage.presentation": "./dist/docs/presentations/docsReferencePage.presentation.js",
+    "./docs/queries": "./dist/docs/queries/index.js",
+    "./docs/queries/contractReference.query": "./dist/docs/queries/contractReference.query.js",
+    "./docs/queries/docsIndex.query": "./dist/docs/queries/docsIndex.query.js",
     "./docs/registry": "./dist/docs/registry.js",
     "./docs/tech-contracts.docs": "./dist/docs/tech-contracts.docs.js",
     "./docs/tech/auth/better-auth-nextjs.docblock": "./dist/docs/tech/auth/better-auth-nextjs.docblock.js",
@@ -131,6 +153,7 @@
     "./docs/tech/contracts/tests.docblock": "./dist/docs/tech/contracts/tests.docblock.js",
     "./docs/tech/contracts/themes.docblock": "./dist/docs/tech/contracts/themes.docblock.js",
     "./docs/tech/contracts/vertical-pocket-family-office.docblock": "./dist/docs/tech/contracts/vertical-pocket-family-office.docblock.js",
+    "./docs/tech/docs-system.docblock": "./dist/docs/tech/docs-system.docblock.js",
     "./docs/tech/lifecycle-stage-system.docblock": "./dist/docs/tech/lifecycle-stage-system.docblock.js",
     "./docs/tech/llm/llm-integration.docblock": "./dist/docs/tech/llm/llm-integration.docblock.js",
     "./docs/tech/mcp-endpoints.docblock": "./dist/docs/tech/mcp-endpoints.docblock.js",
@@ -148,6 +171,10 @@
     "./docs/tech/telemetry-ingest.docblock": "./dist/docs/tech/telemetry-ingest.docblock.js",
     "./docs/tech/vscode-extension.docblock": "./dist/docs/tech/vscode-extension.docblock.js",
     "./docs/types": "./dist/docs/types.js",
+    "./docs/views": "./dist/docs/views/index.js",
+    "./docs/views/contractReference.dataView": "./dist/docs/views/contractReference.dataView.js",
+    "./docs/views/docsIndex.dataView": "./dist/docs/views/docsIndex.dataView.js",
+    "./docs/views/exampleCatalog.dataView": "./dist/docs/views/exampleCatalog.dataView.js",
     "./events": "./dist/events.js",
     "./examples": "./dist/examples/index.js",
     "./examples/docs/examples.docblock": "./dist/examples/docs/examples.docblock.js",
@@ -282,11 +309,14 @@
     "./operations/registry": "./dist/operations/registry.js",
     "./ownership": "./dist/ownership.js",
     "./policy": "./dist/policy/index.js",
+    "./policy/context": "./dist/policy/context.js",
     "./policy/docs/policy.docblock": "./dist/policy/docs/policy.docblock.js",
     "./policy/engine": "./dist/policy/engine.js",
+    "./policy/guards": "./dist/policy/guards.js",
     "./policy/opa-adapter": "./dist/policy/opa-adapter.js",
     "./policy/registry": "./dist/policy/registry.js",
     "./policy/spec": "./dist/policy/spec.js",
+    "./policy/validation": "./dist/policy/validation.js",
     "./presentations": "./dist/presentations/index.js",
     "./presentations/docs/presentations-conventions.docblock": "./dist/presentations/docs/presentations-conventions.docblock.js",
     "./presentations/presentations": "./dist/presentations/presentations.js",
@@ -306,6 +336,9 @@
     "./registry-utils": "./dist/registry-utils.js",
     "./resources": "./dist/resources.js",
     "./schema-to-markdown": "./dist/schema-to-markdown.js",
+    "./serialization": "./dist/serialization/index.js",
+    "./serialization/serializers": "./dist/serialization/serializers.js",
+    "./serialization/types": "./dist/serialization/types.js",
     "./server": "./dist/server/index.js",
     "./server/contracts-adapter-hydration": "./dist/server/contracts-adapter-hydration.js",
     "./server/contracts-adapter-input": "./dist/server/contracts-adapter-input.js",
@@ -332,10 +365,15 @@
     "./tests/runner": "./dist/tests/runner.js",
     "./tests/spec": "./dist/tests/spec.js",
     "./themes": "./dist/themes.js",
+    "./translations": "./dist/translations/index.js",
     "./translations/catalog": "./dist/translations/catalog.js",
+    "./translations/registry": "./dist/translations/registry.js",
+    "./translations/spec": "./dist/translations/spec.js",
     "./translations/tenant": "./dist/translations/tenant.js",
+    "./translations/validation": "./dist/translations/validation.js",
     "./types": "./dist/types.js",
     "./versioning": "./dist/versioning/index.js",
+    "./versioning/refs": "./dist/versioning/refs.js",
     "./versioning/types": "./dist/versioning/types.js",
     "./versioning/utils": "./dist/versioning/utils.js",
     "./workflow": "./dist/workflow/index.js",
@@ -343,6 +381,7 @@
     "./workflow/adapters/db-adapter": "./dist/workflow/adapters/db-adapter.js",
     "./workflow/adapters/file-adapter": "./dist/workflow/adapters/file-adapter.js",
     "./workflow/adapters/memory-store": "./dist/workflow/adapters/memory-store.js",
+    "./workflow/context": "./dist/workflow/context.js",
     "./workflow/expression": "./dist/workflow/expression.js",
     "./workflow/overview.docblock": "./dist/workflow/overview.docblock.js",
     "./workflow/runner": "./dist/workflow/runner.js",