@contractspec/lib.contracts 1.46.2 → 1.47.0

package/dist/app-config/lifecycle-contracts.d.ts

@@ -1,52 +1,52 @@
-import { EventSpecMeta } from "../events.js";
 import { OperationSpec } from "../operations/operation.js";
 import { OperationSpecRegistry } from "../operations/registry.js";
 import "../operations/index.js";
+import { EventSpecMeta } from "../events.js";
 import "../index.js";
-import * as _contractspec_lib_schema102 from "@contractspec/lib.schema";
+import * as _contractspec_lib_schema200 from "@contractspec/lib.schema";
 import { SchemaModel } from "@contractspec/lib.schema";
 
 //#region src/app-config/lifecycle-contracts.d.ts
 declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   blueprintName: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   blueprintVersion: {
-    type: _contractspec_lib_schema102.FieldType<number, number>;
+    type: _contractspec_lib_schema200.FieldType<number, number>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
   fromVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
   createdBy: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   createdAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema200.FieldType<Date, string>;
     isOptional: false;
   };
 }>, {
@@ -55,32 +55,32 @@ declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   promotedBy: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   warnings: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
@@ -90,44 +90,44 @@ declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
   publishedBy: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   changeSummary: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   previousVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
   publishedAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema200.FieldType<Date, string>;
     isOptional: false;
   };
 }>, {
@@ -136,40 +136,40 @@ declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   toVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: true;
   };
   rolledBackBy: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   reason: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   newVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   rolledBackFrom: {
-    type: _contractspec_lib_schema102.FieldType<number, number>;
+    type: _contractspec_lib_schema200.FieldType<number, number>;
     isOptional: false;
   };
 }>, {
@@ -178,22 +178,22 @@ declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   versions: {
     type: SchemaModel<{
       meta: {
-        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema200.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
       config: {
-        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema200.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
     }>;
@@ -203,35 +203,35 @@ declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
   transitions: {
     type: SchemaModel<{
       tenantId: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       appId: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       fromStatus: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       toStatus: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       version: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       timestamp: {
-        type: _contractspec_lib_schema102.FieldType<Date, string>;
+        type: _contractspec_lib_schema200.FieldType<Date, string>;
         isOptional: false;
       };
       actor: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: false;
       };
       reason: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema200.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -241,26 +241,26 @@ declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
 }>, undefined>;
 declare const GetTenantConfigVersionQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema200.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
     type: SchemaModel<{
       meta: {
-        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema200.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
       config: {
-        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema200.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
     }>;

package/dist/app-config/runtime.d.ts

@@ -1,7 +1,11 @@
-import { CapabilityRef, CapabilityRegistry, CapabilitySpec } from "../capabilities/capabilities.js";
-import "../capabilities/index.js";
 import { PolicyRef, PolicySpec } from "../policy/spec.js";
 import { TelemetryRegistry, TelemetrySpec } from "../telemetry/spec.js";
+import { CapabilityRef, CapabilityRegistry, CapabilitySpec } from "../capabilities/capabilities.js";
+import "../capabilities/index.js";
+import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
+import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
+import { FeatureRegistry } from "../features/registry.js";
+import "../features/index.js";
 import { DataViewSpec } from "../data-views/spec.js";
 import { DataViewRegistry } from "../data-views/registry.js";
 import "../data-views/index.js";
@@ -17,10 +21,6 @@ import { AppKnowledgeBinding } from "../knowledge/binding.js";
 import { ResolvedBranding } from "./branding.js";
 import { Locale, TranslationEntry } from "../translations/catalog.js";
 import { AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TranslationCatalogPointer } from "./spec.js";
-import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
-import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
-import { FeatureRegistry } from "../features/registry.js";
-import "../features/index.js";
 
 //#region src/app-config/runtime.d.ts
 interface ResolvedIntegration {

package/dist/app-config/spec.d.ts

@@ -1,7 +1,10 @@
 import { OwnerShipMeta } from "../ownership.js";
+import { PolicyRef } from "../policy/spec.js";
 import { CapabilityRef } from "../capabilities/capabilities.js";
 import "../capabilities/index.js";
-import { PolicyRef } from "../policy/spec.js";
+import { ExperimentRef } from "../experiments/spec.js";
+import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
+import "../features/index.js";
 import { ThemeRef } from "../themes.js";
 import { IntegrationCategory, IntegrationOwnershipMode } from "../integrations/spec.js";
 import { AppIntegrationBinding } from "../integrations/binding.js";
@@ -10,9 +13,6 @@ import { BrandingDefaults, TenantBrandingConfig } from "./branding.js";
 import { Locale, TranslationEntry } from "../translations/catalog.js";
 import { ConfigStatus } from "./lifecycle.js";
 import { SpecContractRegistry } from "../registry.js";
-import { ExperimentRef } from "../experiments/spec.js";
-import { FeatureRef } from "../features/types.js";
-import "../features/index.js";
 
 //#region src/app-config/spec.d.ts
 interface SpecPointer {
@@ -167,5 +167,9 @@ interface TenantAppConfig {
   branding?: TenantBrandingConfig;
   notes?: string;
 }
+/**
+ * Helper to define an AppConfig.
+ */
+declare const defineAppConfig: (spec: FeatureModuleSpec) => FeatureModuleSpec;
 //#endregion
-export { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, makeAppBlueprintKey };
+export { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, defineAppConfig, makeAppBlueprintKey };

package/dist/app-config/spec.js

@@ -10,6 +10,10 @@ var AppBlueprintRegistry = class extends SpecContractRegistry {
 function makeAppBlueprintKey(meta) {
 	return blueprintKey(meta);
 }
+/**
+* Helper to define an AppConfig.
+*/
+const defineAppConfig = (spec) => spec;
 
 //#endregion
-export { AppBlueprintRegistry, makeAppBlueprintKey };
+export { AppBlueprintRegistry, defineAppConfig, makeAppBlueprintKey };

package/dist/contract-registry/schemas.d.ts

@@ -46,9 +46,9 @@ declare const ContractRegistryItemSchema: z.ZodObject<{
   description: z.ZodString;
   meta: z.ZodObject<{
     stability: z.ZodEnum<{
+      experimental: "experimental";
       idea: "idea";
       in_creation: "in_creation";
-      experimental: "experimental";
       beta: "beta";
       stable: "stable";
       deprecated: "deprecated";
@@ -95,9 +95,9 @@ declare const ContractRegistryManifestSchema: z.ZodObject<{
     description: z.ZodString;
     meta: z.ZodObject<{
       stability: z.ZodEnum<{
+        experimental: "experimental";
         idea: "idea";
         in_creation: "in_creation";
-        experimental: "experimental";
         beta: "beta";
         stable: "stable";
         deprecated: "deprecated";

package/dist/data-views/runtime.d.ts

@@ -1,10 +1,14 @@
+import { OperationSpecRegistry } from "../operations/registry.js";
+import "../operations/index.js";
 import { DataViewSpec } from "./spec.js";
 import { DataViewRegistry } from "./registry.js";
 import "./index.js";
+import { HandlerCtx } from "../types.js";
 
 //#region src/data-views/runtime.d.ts
 interface DataViewRuntimeConfig {
   registry: DataViewRegistry;
+  operationRegistry: OperationSpecRegistry;
 }
 interface DataViewResult<T = unknown> {
   data: T[];
@@ -19,7 +23,7 @@ declare class DataViewRuntime {
   constructor(config: DataViewRuntimeConfig);
   register(spec: DataViewSpec): void;
   getSpec(name: string, version?: string): DataViewSpec | undefined;
-  executeQuery(specName: string, _params: unknown): Promise<DataViewResult>;
+  executeQuery(specName: string, params: unknown, ctx: HandlerCtx): Promise<DataViewResult>;
   invalidate(specName: string): void;
   subscribe(specName: string, callback: () => void): () => void;
   private notifySubscribers;

package/dist/data-views/runtime.js

@@ -1,6 +1,10 @@
+import "../operations/index.js";
 import "./index.js";
 
 //#region src/data-views/runtime.ts
+function isPaginatedResult(value) {
+	return typeof value === "object" && value !== null && "items" in value && Array.isArray(value.items);
+}
 var DataViewRuntime = class {
 	cache = /* @__PURE__ */ new Map();
 	subscriptions = /* @__PURE__ */ new Map();
@@ -13,13 +17,36 @@ var DataViewRuntime = class {
 	getSpec(name, version) {
 		return this.config.registry.get(name, version);
 	}
-	async executeQuery(specName, _params) {
-		if (!this.getSpec(specName)) throw new Error(`DataView spec not found: ${specName}`);
-		return {
-			data: [],
-			total: 0,
-			loading: false
-		};
+	async executeQuery(specName, params, ctx) {
+		const spec = this.getSpec(specName);
+		if (!spec) throw new Error(`DataView spec not found: ${specName}`);
+		const opRef = spec.source.primary;
+		if (!opRef) throw new Error(`DataView spec ${specName} missing primary source`);
+		try {
+			const result = await this.config.operationRegistry.execute(opRef.key, opRef.version, params, ctx);
+			if (Array.isArray(result)) return {
+				data: result,
+				total: result.length,
+				loading: false
+			};
+			if (isPaginatedResult(result)) return {
+				data: result.items,
+				total: result.total ?? result.items.length,
+				loading: false
+			};
+			return {
+				data: [result],
+				total: 1,
+				loading: false
+			};
+		} catch (error) {
+			return {
+				data: [],
+				total: 0,
+				loading: false,
+				error: error instanceof Error ? error : new Error(String(error))
+			};
+		}
 	}
 	invalidate(specName) {
 		this.cache.delete(specName);

package/dist/data-views/spec.d.ts

@@ -1,5 +1,5 @@
-import { DataViewConfig, DataViewMeta, DataViewSource, DataViewStates } from "./types.js";
 import { ExperimentRef } from "../experiments/spec.js";
+import { DataViewConfig, DataViewMeta, DataViewSource, DataViewStates } from "./types.js";
 
 //#region src/data-views/spec.d.ts
 

package/dist/docs/index.js

@@ -7,11 +7,11 @@ import "./tech/lifecycle-stage-system.docblock.js";
 import "./tech/presentation-runtime.docblock.js";
 import "./tech/auth/better-auth-nextjs.docblock.js";
 import "./tech/schema/README.docblock.js";
-import "./tech/templates/runtime.docblock.js";
 import "../workflow/overview.docblock.js";
 import "./tech/mcp-endpoints.docblock.js";
 import "./tech/vscode-extension.docblock.js";
 import "./tech/telemetry-ingest.docblock.js";
+import "./tech/contracts/README.docblock.js";
 import "./tech/contracts/openapi-export.docblock.js";
 import "./tech/contracts/openapi-import.docblock.js";
 import "../workspace-config/workspace-config.docblock.js";
@@ -25,5 +25,6 @@ import "./tech/studio/learning-journeys.docblock.js";
 import "./tech/studio/project-access-teams.docblock.js";
 import "./tech/studio/team-invitations.docblock.js";
 import "./tech/llm/llm-integration.docblock.js";
+import "./tech/cli.docblock.js";
 
 export { DocRegistry, defaultDocRegistry, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, techContractsDocs };

package/dist/docs/tech/cli.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "../types.js";
+
+//#region src/docs/tech/cli.docblock.d.ts
+declare const tech_cli_DocBlocks: DocBlock[];
+//#endregion
+export { tech_cli_DocBlocks };

package/dist/docs/tech/cli.docblock.js

@@ -0,0 +1,138 @@
+import { registerDocBlocks } from "../registry.js";
+
+//#region src/docs/tech/cli.docblock.ts
+const tech_cli_DocBlocks = [{
+	id: "docs.tech.cli.contractspec",
+	title: "ContractSpec CLI",
+	summary: "The command-line interface for creating, building, and validating contract specifications.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/cli/contractspec",
+	tags: [
+		"cli",
+		"tooling",
+		"reference"
+	],
+	owners: ["@contractspec/app.cli-contractspec"],
+	body: `# ContractSpec CLI
+
+The \`@contractspec/app.cli-contractspec\` package provides the command-line interface for the ContractSpec ecosystem.
+
+It is also exposed via \`@contractspec/apps-registry/contractspec\` for convenience.
+
+## Installation
+
+\`\`\`bash
+bun add -D @contractspec/app.cli-contractspec
+\`\`\`
+
+## Quick Start
+
+\`\`\`bash
+# Create a new contract spec interactively
+contractspec create
+
+# Create with AI assistance
+contractspec create --ai
+
+# Build implementation from spec
+contractspec build src/contracts/mySpec.ts
+
+# Validate a spec
+contractspec validate src/contracts/mySpec.ts
+\`\`\`
+
+## Core Commands
+
+### \`create\`
+
+Interactive wizard to create contract specifications.
+
+\`\`\`bash
+contractspec create --type operation --ai
+\`\`\`
+
+### \`build\`
+
+Generate implementation code from contract specs using AI agents or templates.
+
+\`\`\`bash
+contractspec build src/contracts/signup.contracts.ts --agent-mode claude-code
+\`\`\`
+
+### \`validate\`
+
+Validate contract specifications and verify implementations.
+
+\`\`\`bash
+contractspec validate src/contracts/signup.contracts.ts --check-implementation
+\`\`\`
+
+### \`watch\`
+
+Watch contract specifications and auto-regenerate on changes.
+
+\`\`\`bash
+contractspec watch --build --validate
+\`\`\`
+
+### \`list\`
+
+List all contract specifications in the project.
+
+\`\`\`bash
+contractspec list --owner @team-platform
+\`\`\`
+
+### \`cleanup\` / \`clean\`
+
+Clean generated files and build artifacts.
+
+\`\`\`bash
+contractspec clean
+\`\`\`
+
+### \`deps\`
+
+Analyze contract dependencies and relationships (circular dependencies, missing refs).
+
+\`\`\`bash
+contractspec deps --circular
+\`\`\`
+
+### \`diff\`
+
+Compare contract specifications and show differences (breaking changes, semantic diff).
+
+\`\`\`bash
+contractspec diff spec1.ts spec2.ts --breaking
+\`\`\`
+
+### \`ci\`
+
+Run all validation checks for CI/CD pipelines (structure, integrity, deps, doctor, handlers, tests).
+
+\`\`\`bash
+contractspec ci --format sarif --output results.sarif
+\`\`\`
+
+## Configuration
+
+The CLI is configured via \`.contractsrc.json\` in your project root.
+
+\`\`\`json
+{
+  "aiProvider": "claude",
+  "aiModel": "claude-3-7-sonnet-20250219",
+  "agentMode": "claude-code",
+  "outputDir": "./src"
+}
+\`\`\`
+
+For full documentation, refer to the [package README](https://github.com/contractspec/monorepo/tree/main/packages/apps/cli-contractspec).
+`
+}];
+registerDocBlocks(tech_cli_DocBlocks);
+
+//#endregion
+export { tech_cli_DocBlocks };