@contractspec/bundle.workspace 1.45.5 → 1.46.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { GitAdapter, GitCleanOptions, GitLogEntry } from "./ports/git.js";
 import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./ports/watcher.js";
 import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ports/ai.js";
 import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./ports/logger.js";
+import { RuleSyncOptions, RuleSyncPort, RuleSyncResult } from "./ports/rulesync.js";
 import "./ports/index.js";
 import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./adapters/fs.js";
 import { createNodeGitAdapter } from "./adapters/git.js";
@@ -93,6 +94,7 @@ import { SpecVersionAnalysis } from "./services/versioning/types.js";
 import { index_d_exports as index_d_exports$6 } from "./services/versioning/index.js";
 import { index_d_exports as index_d_exports$5 } from "./services/upgrade/index.js";
 import { index_d_exports as index_d_exports$1 } from "./services/hooks/index.js";
+import { RuleSyncService } from "./services/rulesync.js";
 import "./services/index.js";
 import { index_d_exports } from "./formatters/index.js";
 import { AIClient } from "./ai/client.js";
@@ -106,4 +108,4 @@ import { OpenAICodexAgent } from "./ai/agents/openai-codex-agent.js";
 import { index_d_exports as index_d_exports$3 } from "./ai/prompts/index.js";
 import "./ai/index.js";
 import * as module from "@contractspec/module.workspace";
-export { AIClient, AIGenerator, AIReviewResult, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentAdapter, AgentConfig, AgentGuideConfig, AgentGuideService, type AgentMode, AgentOrchestrator, AgentProvider, AgentResult, AgentTask, AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, type AiProvider, AiValidationResult, AnalyzeDepsOptions, AnalyzeDepsResult, BehaviorCheck, BlueprintValidationResult, BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, CHECK_CATEGORY_LABELS, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS, CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, CheckCategory, CheckContext, CheckResult, CheckStatus, ClaudeCodeAdapter, ClaudeCodeAgent, CleanOptions, CleanResult, CompareSpecsOptions, CompareSpecsResult, type Config, CoverageByType, CreateAdaptersOptions, CreateRegeneratorOptions, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, DiagramOptions, DiagramType, DiscoverOptions, DiscoveryOptions, DocsServiceOptions, DocsServiceResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult, ExtendedWorkspaceInfo, FULL_DEPENDENCIES, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, FormatOptions, FormatterOptions, FsAdapter, GenericMCPAdapter, GitAdapter, GitCleanOptions, GitLogEntry, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, LayerDiscoveryOptions, LayerDiscoveryResult, LayerInventory, LayerLocation, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsOptions, LogLevel, LoggerAdapter, MINIMAL_DEPENDENCIES, MetaRepoInfo, MonorepoConfig, OpenAICodexAgent, OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult, PackageInstallResult, PackageManager, ProgressReporter, ProgressUpdate, QuickstartDependency, QuickstartMode, QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult, RegistryClient, RegistryClientOptions, RepositoryType, ResolvedImplementation, ResolverOptions, RunTestsResult, SETUP_TARGET_LABELS, SemanticVerificationResult, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget, SimpleAgent, SpecCreatorService, SpecImplementationResult, SpecInventory, SpecLocation, SpecReferenceMatch, SpecVersionAnalysis, StructureCheck, SubmoduleInfo, SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, TenantValidationContext, TenantValidationResult, TestServiceOptions, TestServiceResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult, VerifyService, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$1 as hooks, index_d_exports$2 as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, index_d_exports$3 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$4 as templates, index_d_exports$5 as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$6 as versioning, watchSpecs };
+export { AIClient, AIGenerator, AIReviewResult, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentAdapter, AgentConfig, AgentGuideConfig, AgentGuideService, type AgentMode, AgentOrchestrator, AgentProvider, AgentResult, AgentTask, AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, type AiProvider, AiValidationResult, AnalyzeDepsOptions, AnalyzeDepsResult, BehaviorCheck, BlueprintValidationResult, BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, CHECK_CATEGORY_LABELS, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS, CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, CheckCategory, CheckContext, CheckResult, CheckStatus, ClaudeCodeAdapter, ClaudeCodeAgent, CleanOptions, CleanResult, CompareSpecsOptions, CompareSpecsResult, type Config, CoverageByType, CreateAdaptersOptions, CreateRegeneratorOptions, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, DiagramOptions, DiagramType, DiscoverOptions, DiscoveryOptions, DocsServiceOptions, DocsServiceResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult, ExtendedWorkspaceInfo, FULL_DEPENDENCIES, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, FormatOptions, FormatterOptions, FsAdapter, GenericMCPAdapter, GitAdapter, GitCleanOptions, GitLogEntry, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, LayerDiscoveryOptions, LayerDiscoveryResult, LayerInventory, LayerLocation, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsOptions, LogLevel, LoggerAdapter, MINIMAL_DEPENDENCIES, MetaRepoInfo, MonorepoConfig, OpenAICodexAgent, OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult, PackageInstallResult, PackageManager, ProgressReporter, ProgressUpdate, QuickstartDependency, QuickstartMode, QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult, RegistryClient, RegistryClientOptions, RepositoryType, ResolvedImplementation, ResolverOptions, RuleSyncOptions, RuleSyncPort, RuleSyncResult, RuleSyncService, RunTestsResult, SETUP_TARGET_LABELS, SemanticVerificationResult, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget, SimpleAgent, SpecCreatorService, SpecImplementationResult, SpecInventory, SpecLocation, SpecReferenceMatch, SpecVersionAnalysis, StructureCheck, SubmoduleInfo, SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, TenantValidationContext, TenantValidationResult, TestServiceOptions, TestServiceResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult, VerifyService, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$1 as hooks, index_d_exports$2 as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, index_d_exports$3 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$4 as templates, index_d_exports$5 as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$6 as versioning, watchSpecs };

package/dist/index.js

@@ -86,6 +86,7 @@ import { formatFiles } from "./services/formatter.js";
 import { versioning_exports } from "./services/versioning/index.js";
 import { upgrade_exports } from "./services/upgrade/index.js";
 import { hooks_exports } from "./services/hooks/index.js";
+import { RuleSyncService } from "./services/rulesync.js";
 import "./services/index.js";
 import { formatters_exports } from "./formatters/index.js";
 import { AIClient } from "./ai/client.js";
@@ -93,4 +94,4 @@ import { prompts_exports } from "./ai/prompts/index.js";
 import "./ai/index.js";
 import * as module from "@contractspec/module.workspace";
 
-export { AIClient, AIGenerator, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentGuideService, AgentOrchestrator, CHECK_CATEGORY_LABELS, CI_CHECK_CATEGORY_LABELS, ClaudeCodeAdapter, ClaudeCodeAgent, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, FULL_DEPENDENCIES, FileSystemCacheStorage, GenericMCPAdapter, InMemoryCacheStorage, MINIMAL_DEPENDENCIES, OpenAICodexAgent, RegistryClient, SETUP_TARGET_LABELS, SimpleAgent, SpecCreatorService, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, hooks_exports as hooks, impact_exports as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, upgrade_exports as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, watchSpecs };
+export { AIClient, AIGenerator, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentGuideService, AgentOrchestrator, CHECK_CATEGORY_LABELS, CI_CHECK_CATEGORY_LABELS, ClaudeCodeAdapter, ClaudeCodeAgent, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, FULL_DEPENDENCIES, FileSystemCacheStorage, GenericMCPAdapter, InMemoryCacheStorage, MINIMAL_DEPENDENCIES, OpenAICodexAgent, RegistryClient, RuleSyncService, SETUP_TARGET_LABELS, SimpleAgent, SpecCreatorService, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, hooks_exports as hooks, impact_exports as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, upgrade_exports as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, watchSpecs };

package/dist/ports/index.d.ts

@@ -2,4 +2,5 @@ import { DiscoverOptions, FileStat, FsAdapter } from "./fs.js";
 import { GitAdapter, GitCleanOptions, GitLogEntry } from "./git.js";
 import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./watcher.js";
 import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ai.js";
-import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./logger.js";
+import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./logger.js";
+import { RuleSyncOptions, RuleSyncPort, RuleSyncResult } from "./rulesync.js";

package/dist/ports/rulesync.d.ts

@@ -0,0 +1,38 @@
+import { RuleSyncConfig, RuleSyncTarget } from "@contractspec/lib.contracts";
+
+//#region src/ports/rulesync.d.ts
+
+interface RuleSyncOptions {
+  /** Root directory of the workspace */
+  cwd: string;
+  /** Configuration for rule synchronization */
+  config: RuleSyncConfig;
+  /** Specific targets to sync (overrides config.targets if provided) */
+  targets?: RuleSyncTarget[];
+  /** Dry run mode (don't write files) */
+  dryRun?: boolean;
+}
+interface RuleSyncResult {
+  /** Whether the synchronization was successful */
+  success: boolean;
+  /** List of files created or updated */
+  files: string[];
+  /** Errors encountered during synchronization */
+  errors?: string[];
+  /** Optional logs from the synchronization process */
+  logs?: string[];
+}
+interface RuleSyncPort {
+  /**
+   * Synchronize rules based on the provided options.
+   */
+  sync(options: RuleSyncOptions): Promise<RuleSyncResult>;
+  /**
+   * Generate the rulesync configuration without executing the sync.
+   * Useful for "ejecting" to raw rulesync usage.
+   */
+  generateConfig(options: RuleSyncOptions): Promise<string>;
+}
+//#endregion
+export { RuleSyncOptions, RuleSyncPort, RuleSyncResult };
+//# sourceMappingURL=rulesync.d.ts.map

package/dist/ports/rulesync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesync.d.ts","names":[],"sources":["../../src/ports/rulesync.ts"],"sourcesContent":[],"mappings":";;;;AAoBiB,UAXA,eAAA,CAWc;EAWd;EAID,GAAA,EAAA,MAAA;EAA0B;EAAR,MAAA,EAtBxB,cAsBwB;EAMR;EAAkB,OAAA,CAAA,EA1BhC,cA0BgC,EAAA;EAAO;;;UArBlC,cAAA;;;;;;;;;;UAWA,YAAA;;;;gBAID,kBAAkB,QAAQ;;;;;0BAMhB,kBAAkB"}

package/dist/services/doctor/checks/cli.js

@@ -97,6 +97,15 @@ async function checkCliInstallLocation(fs, ctx) {
 			status: "skip",
 			message: "No package.json found"
 		};
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {
+			const cliPath = fs.join(ctx.workspaceRoot, "packages/apps/cli-contractspec");
+			if (await fs.exists(cliPath)) return {
+				category: "cli",
+				name: "Local Installation",
+				status: "pass",
+				message: "CLI is part of the workspace (source)"
+			};
+		}
 		const content = await fs.readFile(packageJsonPath);
 		const pkg = JSON.parse(content);
 		if (pkg.dependencies?.["@contractspec/app.cli-contractspec"] !== void 0 || pkg.devDependencies?.["@contractspec/app.cli-contractspec"] !== void 0) return {

package/dist/services/doctor/checks/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/cli.ts"],"sourcesContent":["/**\n * CLI installation health checks.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult, FixResult } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run CLI-related health checks.\n */\nexport async function runCliChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if CLI is accessible\n  results.push(await checkCliAccessible(ctx));\n\n  // Check CLI version\n  results.push(await checkCliVersion(ctx));\n\n  // Check if CLI is installed globally or locally\n  results.push(await checkCliInstallLocation(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if the CLI is accessible.\n */\nasync function checkCliAccessible(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    await execAsync('bunx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'pass',\n      message: 'ContractSpec CLI is accessible',\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'fail',\n      message: 'ContractSpec CLI is not accessible',\n      details: 'Could not run \"bunx contractspec --version\"',\n      fix: {\n        description: 'Install ContractSpec CLI globally',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -g @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI installed globally' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check CLI version.\n */\nasync function checkCliVersion(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('bunx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'pass',\n      message: `CLI version: ${version}`,\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'skip',\n      message: 'Could not determine CLI version',\n    };\n  }\n}\n\n/**\n * Check if CLI is installed locally in the project.\n */\nasync function checkCliInstallLocation(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const exists = await fs.exists(packageJsonPath);\n    if (!exists) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'skip',\n        message: 'No package.json found',\n      };\n    }\n\n    const content = await fs.readFile(packageJsonPath);\n    const pkg = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const hasDep =\n      pkg.dependencies?.['@contractspec/app.cli-contractspec'] !== undefined ||\n      pkg.devDependencies?.['@contractspec/app.cli-contractspec'] !== undefined;\n\n    if (hasDep) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'pass',\n        message: 'CLI is installed as a project dependency',\n      };\n    }\n\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'warn',\n      message: 'CLI is not installed as a project dependency',\n      details:\n        'Consider adding @contractspec/app.cli-contractspec to devDependencies',\n      fix: {\n        description: 'Add CLI as a dev dependency',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -D @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI added as dev dependency' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'skip',\n      message: 'Could not check local installation',\n    };\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,YAAY,UAAU,KAAK;;;;AAKjC,eAAsB,aACpB,IACA,KACwB;CACxB,MAAMA,UAAyB,EAAE;AAGjC,SAAQ,KAAK,MAAM,mBAAmB,IAAI,CAAC;AAG3C,SAAQ,KAAK,MAAM,gBAAgB,IAAI,CAAC;AAGxC,SAAQ,KAAK,MAAM,wBAAwB,IAAI,IAAI,CAAC;AAEpD,QAAO;;;;;AAMT,eAAe,mBAAmB,KAAyC;AACzE,KAAI;AACF,QAAM,UAAU,+BAA+B;GAC7C,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAEF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACT,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA0B;cACpD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;;;;;;AAOL,eAAe,gBAAgB,KAAyC;AACtE,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,UAAU,+BAA+B;GAChE,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAIF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,gBANK,OAAO,MAAM;GAO5B;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;;;;;;AAOL,eAAe,wBACb,IACA,KACsB;CACtB,MAAM,kBAAkB,GAAG,KAAK,IAAI,eAAe,eAAe;AAElE,KAAI;AAEF,MAAI,CADW,MAAM,GAAG,OAAO,gBAAgB,CAE7C,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;EAGH,MAAM,UAAU,MAAM,GAAG,SAAS,gBAAgB;EAClD,MAAM,MAAM,KAAK,MAAM,QAAQ;AAS/B,MAHE,IAAI,eAAe,0CAA0C,UAC7D,IAAI,kBAAkB,0CAA0C,OAGhE,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SACE;GACF,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA+B;cACzD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}
+{"version":3,"file":"cli.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/cli.ts"],"sourcesContent":["/**\n * CLI installation health checks.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult, FixResult } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run CLI-related health checks.\n */\nexport async function runCliChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if CLI is accessible\n  results.push(await checkCliAccessible(ctx));\n\n  // Check CLI version\n  results.push(await checkCliVersion(ctx));\n\n  // Check if CLI is installed globally or locally\n  results.push(await checkCliInstallLocation(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if the CLI is accessible.\n */\nasync function checkCliAccessible(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    await execAsync('bunx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'pass',\n      message: 'ContractSpec CLI is accessible',\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'fail',\n      message: 'ContractSpec CLI is not accessible',\n      details: 'Could not run \"bunx contractspec --version\"',\n      fix: {\n        description: 'Install ContractSpec CLI globally',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -g @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI installed globally' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check CLI version.\n */\nasync function checkCliVersion(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('bunx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'pass',\n      message: `CLI version: ${version}`,\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'skip',\n      message: 'Could not determine CLI version',\n    };\n  }\n}\n\n/**\n * Check if CLI is installed locally in the project.\n */\nasync function checkCliInstallLocation(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const exists = await fs.exists(packageJsonPath);\n    if (!exists) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'skip',\n        message: 'No package.json found',\n      };\n    }\n\n    // Check if CLI exists in workspace (monorepo source)\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      const cliPath = fs.join(\n        ctx.workspaceRoot,\n        'packages/apps/cli-contractspec'\n      );\n      if (await fs.exists(cliPath)) {\n        return {\n          category: 'cli',\n          name: 'Local Installation',\n          status: 'pass',\n          message: 'CLI is part of the workspace (source)',\n        };\n      }\n    }\n\n    const content = await fs.readFile(packageJsonPath);\n    const pkg = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const hasDep =\n      pkg.dependencies?.['@contractspec/app.cli-contractspec'] !== undefined ||\n      pkg.devDependencies?.['@contractspec/app.cli-contractspec'] !== undefined;\n\n    if (hasDep) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'pass',\n        message: 'CLI is installed as a project dependency',\n      };\n    }\n\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'warn',\n      message: 'CLI is not installed as a project dependency',\n      details:\n        'Consider adding @contractspec/app.cli-contractspec to devDependencies',\n      fix: {\n        description: 'Add CLI as a dev dependency',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -D @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI added as dev dependency' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'skip',\n      message: 'Could not check local installation',\n    };\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,YAAY,UAAU,KAAK;;;;AAKjC,eAAsB,aACpB,IACA,KACwB;CACxB,MAAMA,UAAyB,EAAE;AAGjC,SAAQ,KAAK,MAAM,mBAAmB,IAAI,CAAC;AAG3C,SAAQ,KAAK,MAAM,gBAAgB,IAAI,CAAC;AAGxC,SAAQ,KAAK,MAAM,wBAAwB,IAAI,IAAI,CAAC;AAEpD,QAAO;;;;;AAMT,eAAe,mBAAmB,KAAyC;AACzE,KAAI;AACF,QAAM,UAAU,+BAA+B;GAC7C,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAEF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACT,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA0B;cACpD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;;;;;;AAOL,eAAe,gBAAgB,KAAyC;AACtE,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,UAAU,+BAA+B;GAChE,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAIF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,gBANK,OAAO,MAAM;GAO5B;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;;;;;;AAOL,eAAe,wBACb,IACA,KACsB;CACtB,MAAM,kBAAkB,GAAG,KAAK,IAAI,eAAe,eAAe;AAElE,KAAI;AAEF,MAAI,CADW,MAAM,GAAG,OAAO,gBAAgB,CAE7C,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAIH,MAAI,IAAI,cAAc,IAAI,gBAAgB,IAAI,eAAe;GAC3D,MAAM,UAAU,GAAG,KACjB,IAAI,eACJ,iCACD;AACD,OAAI,MAAM,GAAG,OAAO,QAAQ,CAC1B,QAAO;IACL,UAAU;IACV,MAAM;IACN,QAAQ;IACR,SAAS;IACV;;EAIL,MAAM,UAAU,MAAM,GAAG,SAAS,gBAAgB;EAClD,MAAM,MAAM,KAAK,MAAM,QAAQ;AAS/B,MAHE,IAAI,eAAe,0CAA0C,UAC7D,IAAI,kBAAkB,0CAA0C,OAGhE,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SACE;GACF,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA+B;cACzD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}

package/dist/services/doctor/checks/deps.js

@@ -98,6 +98,19 @@ async function checkPackageManager(fs, ctx) {
 			break;
 		}
 	}
+	if (!detectedManager) {
+		const searchDirs = [fs.join(ctx.workspaceRoot, ".."), fs.join(ctx.workspaceRoot, "../..")];
+		for (const dir of searchDirs) {
+			for (const { file, name } of lockFiles) {
+				const lockPath = fs.join(dir, file);
+				if (await fs.exists(lockPath)) {
+					detectedManager = name;
+					break;
+				}
+			}
+			if (detectedManager) break;
+		}
+	}
 	if (!detectedManager) return {
 		category: "deps",
 		name: "Package Manager",

package/dist/services/doctor/checks/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","names":["results: CheckResult[]","detectedManager: string | null"],"sources":["../../../../src/services/doctor/checks/deps.ts"],"sourcesContent":["/**\n * Dependencies health checks.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run dependency-related health checks.\n */\nexport async function runDepsChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check Node.js availability\n  results.push(await checkNodeJs(ctx));\n\n  // Check Bun availability\n  results.push(await checkBun(ctx));\n\n  // Check package manager\n  results.push(await checkPackageManager(fs, ctx));\n\n  // Check if node_modules exists\n  results.push(await checkNodeModules(fs, ctx));\n\n  // Check if @contractspec/lib.contracts is installed\n  results.push(await checkContractsLibrary(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if Node.js is available.\n */\nasync function checkNodeJs(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('node --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'pass',\n      message: `Node.js ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'fail',\n      message: 'Node.js not found',\n      details: 'Install Node.js from https://nodejs.org',\n    };\n  }\n}\n\n/**\n * Check if Bun is available.\n */\nasync function checkBun(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('bun --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'pass',\n      message: `Bun ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'warn',\n      message: 'Bun not found (optional but recommended)',\n      details: 'Install Bun from https://bun.sh for faster execution',\n    };\n  }\n}\n\n/**\n * Detect and check the package manager.\n */\nasync function checkPackageManager(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Check for lock files to determine package manager\n  const lockFiles = [\n    { file: 'bun.lockb', name: 'bun' },\n    { file: 'pnpm-lock.yaml', name: 'pnpm' },\n    { file: 'yarn.lock', name: 'yarn' },\n    { file: 'package-lock.json', name: 'npm' },\n  ];\n\n  let detectedManager: string | null = null;\n\n  for (const { file, name } of lockFiles) {\n    const lockPath = fs.join(ctx.workspaceRoot, file);\n    if (await fs.exists(lockPath)) {\n      detectedManager = name;\n      break;\n    }\n  }\n\n  if (!detectedManager) {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'warn',\n      message: 'No lock file found',\n      details: 'Run npm install, yarn, pnpm install, or bun install',\n    };\n  }\n\n  // Verify the package manager is available\n  try {\n    await execAsync(`${detectedManager} --version`, {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'pass',\n      message: `Using ${detectedManager}`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'fail',\n      message: `${detectedManager} detected but not available`,\n      details: `Install ${detectedManager} or use a different package manager`,\n    };\n  }\n}\n\n/**\n * Check if node_modules exists.\n */\nasync function checkNodeModules(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const nodeModulesPath = fs.join(ctx.workspaceRoot, 'node_modules');\n\n  const exists = await fs.exists(nodeModulesPath);\n  if (exists) {\n    return {\n      category: 'deps',\n      name: 'Dependencies Installed',\n      status: 'pass',\n      message: 'node_modules directory exists',\n    };\n  }\n\n  return {\n    category: 'deps',\n    name: 'Dependencies Installed',\n    status: 'fail',\n    message: 'node_modules not found',\n    details: 'Run your package manager install command',\n    fix: {\n      description: 'Install dependencies',\n      apply: async () => {\n        try {\n          // Try bun first, then npm\n          try {\n            await execAsync('bun install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with bun' };\n          } catch {\n            await execAsync('npm install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with npm' };\n          }\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if @contractspec/lib.contracts is installed.\n */\nasync function checkContractsLibrary(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const content = await fs.readFile(packageJsonPath);\n    const packageJson = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const allDeps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    if ('@contractspec/lib.contracts' in allDeps) {\n      return {\n        category: 'deps',\n        name: 'ContractSpec Library',\n        status: 'pass',\n        message: `@contractspec/lib.contracts installed (${allDeps['@contractspec/lib.contracts']})`,\n      };\n    }\n\n    // In monorepo root, we don't expect the library to be installed directly\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      return {\n        category: 'deps',\n        name: 'ContractSpec Library',\n        status: 'pass',\n        message: 'Monorepo root detected (library check skipped)',\n        details: 'Run doctor in specific packages to verify dependencies',\n      };\n    }\n\n    return {\n      category: 'deps',\n      name: 'ContractSpec Library',\n      status: 'fail',\n      message: '@contractspec/lib.contracts not installed',\n      details: 'Run \"contractspec quickstart\" to install required packages',\n      fix: {\n        description: 'Install @contractspec/lib.contracts and dependencies',\n        apply: async () => {\n          try {\n            // Try bun first, then npm\n            try {\n              await execAsync('bun add @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with bun' };\n            } catch {\n              await execAsync('npm install @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with npm' };\n            }\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'ContractSpec Library',\n      status: 'skip',\n      message: 'Could not read package.json',\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deps.js","names":["results: CheckResult[]","detectedManager: string | null"],"sources":["../../../../src/services/doctor/checks/deps.ts"],"sourcesContent":["/**\n * Dependencies health checks.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run dependency-related health checks.\n */\nexport async function runDepsChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check Node.js availability\n  results.push(await checkNodeJs(ctx));\n\n  // Check Bun availability\n  results.push(await checkBun(ctx));\n\n  // Check package manager\n  results.push(await checkPackageManager(fs, ctx));\n\n  // Check if node_modules exists\n  results.push(await checkNodeModules(fs, ctx));\n\n  // Check if @contractspec/lib.contracts is installed\n  results.push(await checkContractsLibrary(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if Node.js is available.\n */\nasync function checkNodeJs(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('node --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'pass',\n      message: `Node.js ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'fail',\n      message: 'Node.js not found',\n      details: 'Install Node.js from https://nodejs.org',\n    };\n  }\n}\n\n/**\n * Check if Bun is available.\n */\nasync function checkBun(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('bun --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'pass',\n      message: `Bun ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'warn',\n      message: 'Bun not found (optional but recommended)',\n      details: 'Install Bun from https://bun.sh for faster execution',\n    };\n  }\n}\n\n/**\n * Detect and check the package manager.\n */\nasync function checkPackageManager(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Check for lock files to determine package manager\n  const lockFiles = [\n    { file: 'bun.lockb', name: 'bun' },\n    { file: 'pnpm-lock.yaml', name: 'pnpm' },\n    { file: 'yarn.lock', name: 'yarn' },\n    { file: 'package-lock.json', name: 'npm' },\n  ];\n\n  let detectedManager: string | null = null;\n\n  for (const { file, name } of lockFiles) {\n    const lockPath = fs.join(ctx.workspaceRoot, file);\n    if (await fs.exists(lockPath)) {\n      detectedManager = name;\n      break;\n    }\n  }\n\n  // If not found, try looking in parent directory (nested monorepo case)\n  if (!detectedManager) {\n    const parentDir = fs.join(ctx.workspaceRoot, '..');\n    const grandParentDir = fs.join(ctx.workspaceRoot, '../..');\n    const searchDirs = [parentDir, grandParentDir];\n\n    for (const dir of searchDirs) {\n      for (const { file, name } of lockFiles) {\n        const lockPath = fs.join(dir, file);\n        if (await fs.exists(lockPath)) {\n          detectedManager = name;\n          // Optionally update context or just pass?\n          // We'll just use this manager for version check\n          break;\n        }\n      }\n      if (detectedManager) break;\n    }\n  }\n\n  if (!detectedManager) {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'warn',\n      message: 'No lock file found',\n      details: 'Run npm install, yarn, pnpm install, or bun install',\n    };\n  }\n\n  // Verify the package manager is available\n  try {\n    await execAsync(`${detectedManager} --version`, {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'pass',\n      message: `Using ${detectedManager}`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'fail',\n      message: `${detectedManager} detected but not available`,\n      details: `Install ${detectedManager} or use a different package manager`,\n    };\n  }\n}\n\n/**\n * Check if node_modules exists.\n */\nasync function checkNodeModules(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const nodeModulesPath = fs.join(ctx.workspaceRoot, 'node_modules');\n\n  const exists = await fs.exists(nodeModulesPath);\n  if (exists) {\n    return {\n      category: 'deps',\n      name: 'Dependencies Installed',\n      status: 'pass',\n      message: 'node_modules directory exists',\n    };\n  }\n\n  return {\n    category: 'deps',\n    name: 'Dependencies Installed',\n    status: 'fail',\n    message: 'node_modules not found',\n    details: 'Run your package manager install command',\n    fix: {\n      description: 'Install dependencies',\n      apply: async () => {\n        try {\n          // Try bun first, then npm\n          try {\n            await execAsync('bun install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with bun' };\n          } catch {\n            await execAsync('npm install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with npm' };\n          }\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if @contractspec/lib.contracts is installed.\n */\nasync function checkContractsLibrary(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const content = await fs.readFile(packageJsonPath);\n    const packageJson = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const allDeps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    if ('@contractspec/lib.contracts' in allDeps) {\n      return {\n        category: 'deps',\n        name: 'ContractSpec Library',\n        status: 'pass',\n        message: `@contractspec/lib.contracts installed (${allDeps['@contractspec/lib.contracts']})`,\n      };\n    }\n\n    // In monorepo root, we don't expect the library to be installed directly\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      return {\n        category: 'deps',\n        name: 'ContractSpec Library',\n        status: 'pass',\n        message: 'Monorepo root detected (library check skipped)',\n        details: 'Run doctor in specific packages to verify dependencies',\n      };\n    }\n\n    return {\n      category: 'deps',\n      name: 'ContractSpec Library',\n      status: 'fail',\n      message: '@contractspec/lib.contracts not installed',\n      details: 'Run \"contractspec quickstart\" to install required packages',\n      fix: {\n        description: 'Install @contractspec/lib.contracts and dependencies',\n        apply: async () => {\n          try {\n            // Try bun first, then npm\n            try {\n              await execAsync('bun add @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with bun' };\n            } catch {\n              await execAsync('npm install @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with npm' };\n            }\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'ContractSpec Library',\n      status: 'skip',\n      message: 'Could not read package.json',\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/services/doctor/checks/workspace.js

@@ -86,6 +86,12 @@ async function checkContractsDirectory(fs, ctx) {
 			};
 		}
 	}
+	if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) return {
+		category: "workspace",
+		name: "Contracts Directory",
+		status: "pass",
+		message: "Monorepo root detected (contracts expected in packages)"
+	};
 	const createPath = ctx.isMonorepo ? "src/contracts" : "src/contracts";
 	const locationHint = ctx.isMonorepo ? ` in package "${ctx.packageName ?? ctx.packageRoot}"` : "";
 	return {
@@ -143,6 +149,12 @@ async function checkContractFiles(fs, ctx) {
 				details: ctx.verbose ? files.slice(0, 5).join(", ") : void 0
 			};
 		}
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) return {
+			category: "workspace",
+			name: "Contract Files",
+			status: "pass",
+			message: "No contract files in root (expected in packages)"
+		};
 		return {
 			category: "workspace",
 			name: "Contract Files",
@@ -195,7 +207,8 @@ async function checkOutputDirectory(fs, ctx) {
 			message: ctx.isMonorepo ? "No config file found at package or workspace level" : "No config file to check output directory"
 		};
 		const content = await fs.readFile(configInfo.path);
-		const outputDir = JSON.parse(content).outputDir ?? "./src";
+		const config = JSON.parse(content);
+		const outputDir = config.outputDir ?? "./src";
 		const outputPath = fs.join(configInfo.root, outputDir);
 		const levelInfo = ctx.isMonorepo ? ` (${configInfo.level} level)` : "";
 		if (await fs.exists(outputPath)) return {
@@ -205,6 +218,12 @@ async function checkOutputDirectory(fs, ctx) {
 			message: `Output directory exists: ${outputDir}${levelInfo}`,
 			details: ctx.verbose ? `Resolved to: ${outputPath}` : void 0
 		};
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot && !config.outputDir) return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "pass",
+			message: "Monorepo root detected (using package directories)"
+		};
 		return {
 			category: "workspace",
 			name: "Output Directory",

package/dist/services/doctor/checks/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/workspace.ts"],"sourcesContent":["/**\n * Workspace structure health checks.\n *\n * Monorepo-aware checks for contracts and output directories.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult, FixResult } from '../types';\n\n/**\n * Common contract directory paths to check.\n */\nconst CONTRACT_PATHS = ['src/contracts', 'contracts', 'src/specs', 'specs'];\n\n/**\n * Run workspace-related health checks.\n */\nexport async function runWorkspaceChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check monorepo status first (informational)\n  results.push(checkMonorepoStatus(ctx));\n\n  // Check if this is a valid workspace (has package.json)\n  results.push(await checkValidWorkspace(fs, ctx));\n\n  // Check if contracts directory exists (monorepo-aware)\n  results.push(await checkContractsDirectory(fs, ctx));\n\n  // Check if any contract files exist\n  results.push(await checkContractFiles(fs, ctx));\n\n  // Check output directory (monorepo-aware)\n  results.push(await checkOutputDirectory(fs, ctx));\n\n  return results;\n}\n\n/**\n * Report monorepo detection status.\n */\nfunction checkMonorepoStatus(ctx: CheckContext): CheckResult {\n  if (ctx.isMonorepo) {\n    const pkgInfo = ctx.packageName ? ` in package \"${ctx.packageName}\"` : '';\n    const locationInfo =\n      ctx.packageRoot !== ctx.workspaceRoot\n        ? ` (package root: ${ctx.packageRoot})`\n        : '';\n    return {\n      category: 'workspace',\n      name: 'Monorepo Detection',\n      status: 'pass',\n      message: `Monorepo detected${pkgInfo}`,\n      details: ctx.verbose\n        ? `Workspace root: ${ctx.workspaceRoot}${locationInfo}`\n        : undefined,\n    };\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Monorepo Detection',\n    status: 'pass',\n    message: 'Single project (not a monorepo)',\n  };\n}\n\n/**\n * Check if this is a valid workspace.\n */\nasync function checkValidWorkspace(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // In monorepo, check both workspace root and package root\n  const pathsToCheck = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  for (const root of pathsToCheck) {\n    const packageJsonPath = fs.join(root, 'package.json');\n    if (await fs.exists(packageJsonPath)) {\n      return {\n        category: 'workspace',\n        name: 'Valid Workspace',\n        status: 'pass',\n        message: 'package.json found',\n        details:\n          ctx.verbose && ctx.isMonorepo ? `Found at: ${root}` : undefined,\n      };\n    }\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Valid Workspace',\n    status: 'fail',\n    message: 'No package.json found',\n    details: 'This does not appear to be a Node.js/TypeScript project',\n  };\n}\n\n/**\n * Check if contracts directory exists.\n *\n * In monorepo: checks current package first, then workspace root.\n */\nasync function checkContractsDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Determine where to look and where to create\n  const searchRoots = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  // Prefer creating in package root for monorepos\n  const targetRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n  // Check each possible location\n  for (const root of searchRoots) {\n    for (const path of CONTRACT_PATHS) {\n      const fullPath = fs.join(root, path);\n      if (await fs.exists(fullPath)) {\n        const relativeTo = root === ctx.packageRoot ? 'package' : 'workspace';\n        return {\n          category: 'workspace',\n          name: 'Contracts Directory',\n          status: 'pass',\n          message: `Contracts directory found: ${path}`,\n          details: ctx.isMonorepo ? `Found at ${relativeTo} level` : undefined,\n        };\n      }\n    }\n  }\n\n  // Not found - suggest creating in appropriate location\n  const createPath = ctx.isMonorepo ? 'src/contracts' : 'src/contracts';\n  const locationHint = ctx.isMonorepo\n    ? ` in package \"${ctx.packageName ?? ctx.packageRoot}\"`\n    : '';\n\n  return {\n    category: 'workspace',\n    name: 'Contracts Directory',\n    status: 'warn',\n    message: 'No contracts directory found',\n    details: `Create ${createPath}/${locationHint} to organize your specs`,\n    fix: {\n      description: `Create ${createPath}/ directory${locationHint}`,\n      apply: async (): Promise<FixResult> => {\n        try {\n          const contractsDir = fs.join(targetRoot, 'src', 'contracts');\n          await fs.mkdir(contractsDir);\n          return { success: true, message: `Created ${createPath}/` };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if any contract files exist.\n *\n * In monorepo: searches from current package root.\n */\nasync function checkContractFiles(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const patterns = [\n      '**/*.operation.ts',\n      '**/*.event.ts',\n      '**/*.presentation.ts',\n      '**/*.feature.ts',\n    ];\n\n    // In monorepo, search from package root; otherwise workspace root\n    const searchRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n    const files = await fs.glob({\n      patterns,\n      ignore: ['node_modules/**', 'dist/**'],\n      cwd: searchRoot,\n    });\n\n    if (files.length > 0) {\n      const locationInfo = ctx.isMonorepo ? ' (in current package)' : '';\n      return {\n        category: 'workspace',\n        name: 'Contract Files',\n        status: 'pass',\n        message: `Found ${files.length} contract file(s)${locationInfo}`,\n        details: ctx.verbose ? files.slice(0, 5).join(', ') : undefined,\n      };\n    }\n\n    const hint = ctx.isMonorepo\n      ? `No contract files found in package \"${ctx.packageName ?? 'current'}\"`\n      : 'No contract files found';\n\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'warn',\n      message: hint,\n      details: 'Create specs using \"contractspec create\" or VS Code command',\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'skip',\n      message: 'Could not search for contract files',\n    };\n  }\n}\n\n/**\n * Find the config file, checking package level first in monorepos.\n */\nasync function findConfigFile(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<{\n  path: string;\n  root: string;\n  level: 'package' | 'workspace';\n} | null> {\n  // In monorepo, check package level first\n  if (ctx.isMonorepo && ctx.packageRoot !== ctx.workspaceRoot) {\n    const pkgConfigPath = fs.join(ctx.packageRoot, '.contractsrc.json');\n    if (await fs.exists(pkgConfigPath)) {\n      return { path: pkgConfigPath, root: ctx.packageRoot, level: 'package' };\n    }\n  }\n\n  // Check workspace level\n  const wsConfigPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n  if (await fs.exists(wsConfigPath)) {\n    return { path: wsConfigPath, root: ctx.workspaceRoot, level: 'workspace' };\n  }\n\n  return null;\n}\n\n/**\n * Check if output directory is configured and exists.\n *\n * In monorepo: checks package-level config first, then workspace-level.\n * Resolves outputDir relative to the config file location.\n */\nasync function checkOutputDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const configInfo = await findConfigFile(fs, ctx);\n\n    if (!configInfo) {\n      const hint = ctx.isMonorepo\n        ? 'No config file found at package or workspace level'\n        : 'No config file to check output directory';\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'skip',\n        message: hint,\n      };\n    }\n\n    const content = await fs.readFile(configInfo.path);\n    const config = JSON.parse(content) as { outputDir?: string };\n\n    const outputDir = config.outputDir ?? './src';\n    // Resolve outputDir relative to the config file's directory\n    const outputPath = fs.join(configInfo.root, outputDir);\n\n    const levelInfo = ctx.isMonorepo ? ` (${configInfo.level} level)` : '';\n\n    const exists = await fs.exists(outputPath);\n    if (exists) {\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'pass',\n        message: `Output directory exists: ${outputDir}${levelInfo}`,\n        details: ctx.verbose ? `Resolved to: ${outputPath}` : undefined,\n      };\n    }\n\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'warn',\n      message: `Output directory not found: ${outputDir}${levelInfo}`,\n      details: ctx.verbose ? `Expected at: ${outputPath}` : undefined,\n      fix: {\n        description: `Create ${outputDir} directory`,\n        apply: async (): Promise<FixResult> => {\n          try {\n            await fs.mkdir(outputPath);\n            return { success: true, message: `Created ${outputDir}` };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'skip',\n      message: 'Could not check output directory',\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"workspace.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/workspace.ts"],"sourcesContent":["/**\n * Workspace structure health checks.\n *\n * Monorepo-aware checks for contracts and output directories.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult, FixResult } from '../types';\n\n/**\n * Common contract directory paths to check.\n */\nconst CONTRACT_PATHS = ['src/contracts', 'contracts', 'src/specs', 'specs'];\n\n/**\n * Run workspace-related health checks.\n */\nexport async function runWorkspaceChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check monorepo status first (informational)\n  results.push(checkMonorepoStatus(ctx));\n\n  // Check if this is a valid workspace (has package.json)\n  results.push(await checkValidWorkspace(fs, ctx));\n\n  // Check if contracts directory exists (monorepo-aware)\n  results.push(await checkContractsDirectory(fs, ctx));\n\n  // Check if any contract files exist\n  results.push(await checkContractFiles(fs, ctx));\n\n  // Check output directory (monorepo-aware)\n  results.push(await checkOutputDirectory(fs, ctx));\n\n  return results;\n}\n\n/**\n * Report monorepo detection status.\n */\nfunction checkMonorepoStatus(ctx: CheckContext): CheckResult {\n  if (ctx.isMonorepo) {\n    const pkgInfo = ctx.packageName ? ` in package \"${ctx.packageName}\"` : '';\n    const locationInfo =\n      ctx.packageRoot !== ctx.workspaceRoot\n        ? ` (package root: ${ctx.packageRoot})`\n        : '';\n    return {\n      category: 'workspace',\n      name: 'Monorepo Detection',\n      status: 'pass',\n      message: `Monorepo detected${pkgInfo}`,\n      details: ctx.verbose\n        ? `Workspace root: ${ctx.workspaceRoot}${locationInfo}`\n        : undefined,\n    };\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Monorepo Detection',\n    status: 'pass',\n    message: 'Single project (not a monorepo)',\n  };\n}\n\n/**\n * Check if this is a valid workspace.\n */\nasync function checkValidWorkspace(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // In monorepo, check both workspace root and package root\n  const pathsToCheck = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  for (const root of pathsToCheck) {\n    const packageJsonPath = fs.join(root, 'package.json');\n    if (await fs.exists(packageJsonPath)) {\n      return {\n        category: 'workspace',\n        name: 'Valid Workspace',\n        status: 'pass',\n        message: 'package.json found',\n        details:\n          ctx.verbose && ctx.isMonorepo ? `Found at: ${root}` : undefined,\n      };\n    }\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Valid Workspace',\n    status: 'fail',\n    message: 'No package.json found',\n    details: 'This does not appear to be a Node.js/TypeScript project',\n  };\n}\n\n/**\n * Check if contracts directory exists.\n *\n * In monorepo: checks current package first, then workspace root.\n */\nasync function checkContractsDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Determine where to look and where to create\n  const searchRoots = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  // Prefer creating in package root for monorepos\n  const targetRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n  // Check each possible location\n  for (const root of searchRoots) {\n    for (const path of CONTRACT_PATHS) {\n      const fullPath = fs.join(root, path);\n      if (await fs.exists(fullPath)) {\n        const relativeTo = root === ctx.packageRoot ? 'package' : 'workspace';\n        return {\n          category: 'workspace',\n          name: 'Contracts Directory',\n          status: 'pass',\n          message: `Contracts directory found: ${path}`,\n          details: ctx.isMonorepo ? `Found at ${relativeTo} level` : undefined,\n        };\n      }\n    }\n  }\n\n  // Not found - check if we are at monorepo root\n  if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n    return {\n      category: 'workspace',\n      name: 'Contracts Directory',\n      status: 'pass',\n      message: 'Monorepo root detected (contracts expected in packages)',\n    };\n  }\n\n  // Not found - suggest creating in appropriate location\n  const createPath = ctx.isMonorepo ? 'src/contracts' : 'src/contracts';\n  const locationHint = ctx.isMonorepo\n    ? ` in package \"${ctx.packageName ?? ctx.packageRoot}\"`\n    : '';\n\n  return {\n    category: 'workspace',\n    name: 'Contracts Directory',\n    status: 'warn',\n    message: 'No contracts directory found',\n    details: `Create ${createPath}/${locationHint} to organize your specs`,\n    fix: {\n      description: `Create ${createPath}/ directory${locationHint}`,\n      apply: async (): Promise<FixResult> => {\n        try {\n          const contractsDir = fs.join(targetRoot, 'src', 'contracts');\n          await fs.mkdir(contractsDir);\n          return { success: true, message: `Created ${createPath}/` };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if any contract files exist.\n *\n * In monorepo: searches from current package root.\n */\nasync function checkContractFiles(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const patterns = [\n      '**/*.operation.ts',\n      '**/*.event.ts',\n      '**/*.presentation.ts',\n      '**/*.feature.ts',\n    ];\n\n    // In monorepo, search from package root; otherwise workspace root\n    const searchRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n    const files = await fs.glob({\n      patterns,\n      ignore: ['node_modules/**', 'dist/**'],\n      cwd: searchRoot,\n    });\n\n    if (files.length > 0) {\n      const locationInfo = ctx.isMonorepo ? ' (in current package)' : '';\n      return {\n        category: 'workspace',\n        name: 'Contract Files',\n        status: 'pass',\n        message: `Found ${files.length} contract file(s)${locationInfo}`,\n        details: ctx.verbose ? files.slice(0, 5).join(', ') : undefined,\n      };\n    }\n\n    // Pass if monorepo root and no files (likely empty root)\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      return {\n        category: 'workspace',\n        name: 'Contract Files',\n        status: 'pass',\n        message: 'No contract files in root (expected in packages)',\n      };\n    }\n\n    const hint = ctx.isMonorepo\n      ? `No contract files found in package \"${ctx.packageName ?? 'current'}\"`\n      : 'No contract files found';\n\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'warn',\n      message: hint,\n      details: 'Create specs using \"contractspec create\" or VS Code command',\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'skip',\n      message: 'Could not search for contract files',\n    };\n  }\n}\n\n/**\n * Find the config file, checking package level first in monorepos.\n */\nasync function findConfigFile(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<{\n  path: string;\n  root: string;\n  level: 'package' | 'workspace';\n} | null> {\n  // In monorepo, check package level first\n  if (ctx.isMonorepo && ctx.packageRoot !== ctx.workspaceRoot) {\n    const pkgConfigPath = fs.join(ctx.packageRoot, '.contractsrc.json');\n    if (await fs.exists(pkgConfigPath)) {\n      return { path: pkgConfigPath, root: ctx.packageRoot, level: 'package' };\n    }\n  }\n\n  // Check workspace level\n  const wsConfigPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n  if (await fs.exists(wsConfigPath)) {\n    return { path: wsConfigPath, root: ctx.workspaceRoot, level: 'workspace' };\n  }\n\n  return null;\n}\n\n/**\n * Check if output directory is configured and exists.\n *\n * In monorepo: checks package-level config first, then workspace-level.\n * Resolves outputDir relative to the config file location.\n */\nasync function checkOutputDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const configInfo = await findConfigFile(fs, ctx);\n\n    if (!configInfo) {\n      const hint = ctx.isMonorepo\n        ? 'No config file found at package or workspace level'\n        : 'No config file to check output directory';\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'skip',\n        message: hint,\n      };\n    }\n\n    const content = await fs.readFile(configInfo.path);\n    const config = JSON.parse(content) as { outputDir?: string };\n\n    const outputDir = config.outputDir ?? './src';\n    // Resolve outputDir relative to the config file's directory\n    const outputPath = fs.join(configInfo.root, outputDir);\n\n    const levelInfo = ctx.isMonorepo ? ` (${configInfo.level} level)` : '';\n\n    const exists = await fs.exists(outputPath);\n    if (exists) {\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'pass',\n        message: `Output directory exists: ${outputDir}${levelInfo}`,\n        details: ctx.verbose ? `Resolved to: ${outputPath}` : undefined,\n      };\n    }\n\n    // If default output directory is missing in monorepo root, it's fine\n    if (\n      ctx.isMonorepo &&\n      ctx.packageRoot === ctx.workspaceRoot &&\n      !config.outputDir\n    ) {\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'pass',\n        message: 'Monorepo root detected (using package directories)',\n      };\n    }\n\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'warn',\n      message: `Output directory not found: ${outputDir}${levelInfo}`,\n      details: ctx.verbose ? `Expected at: ${outputPath}` : undefined,\n      fix: {\n        description: `Create ${outputDir} directory`,\n        apply: async (): Promise<FixResult> => {\n          try {\n            await fs.mkdir(outputPath);\n            return { success: true, message: `Created ${outputDir}` };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'skip',\n      message: 'Could not check output directory',\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/services/index.d.ts

@@ -87,4 +87,5 @@ import { FormatterOptions, formatFiles } from "./formatter.js";
 import { SpecVersionAnalysis } from "./versioning/types.js";
 import { index_d_exports as index_d_exports$1 } from "./versioning/index.js";
 import { index_d_exports as index_d_exports$2 } from "./upgrade/index.js";
-import { index_d_exports as index_d_exports$3 } from "./hooks/index.js";
+import { index_d_exports as index_d_exports$3 } from "./hooks/index.js";
+import { RuleSyncService } from "./rulesync.js";

package/dist/services/index.js

@@ -84,3 +84,4 @@ import { formatFiles } from "./formatter.js";
 import { versioning_exports } from "./versioning/index.js";
 import { upgrade_exports } from "./upgrade/index.js";
 import { hooks_exports } from "./hooks/index.js";
+import { RuleSyncService } from "./rulesync.js";

package/dist/services/rulesync.d.ts

@@ -0,0 +1,17 @@
+import { FsAdapter } from "../ports/fs.js";
+import { LoggerAdapter } from "../ports/logger.js";
+import { RuleSyncOptions, RuleSyncPort, RuleSyncResult } from "../ports/rulesync.js";
+
+//#region src/services/rulesync.d.ts
+
+declare class RuleSyncService implements RuleSyncPort {
+  private readonly fs;
+  private readonly logger;
+  constructor(fs: FsAdapter, logger: LoggerAdapter);
+  sync(options: RuleSyncOptions): Promise<RuleSyncResult>;
+  generateConfig(options: RuleSyncOptions): Promise<string>;
+  private getTargetFileName;
+}
+//#endregion
+export { RuleSyncService };
+//# sourceMappingURL=rulesync.d.ts.map

package/dist/services/rulesync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesync.d.ts","names":[],"sources":["../../src/services/rulesync.ts"],"sourcesContent":[],"mappings":";;;;;;AAkByB,cAFZ,eAAA,YAA2B,YAEf,CAAA;EACI,iBAAA,EAAA;EAGP,iBAAA,MAAA;EAA0B,WAAA,CAAA,EAAA,EAJvB,SAIuB,EAAA,MAAA,EAHnB,aAGmB;EAAR,IAAA,CAAA,OAAA,EAAlB,eAAkB,CAAA,EAAA,OAAA,CAAQ,cAAR,CAAA;EAyER,cAAA,CAAA,OAAA,EAAA,eAAA,CAAA,EAAkB,OAAlB,CAAA,MAAA,CAAA;EAAkB,QAAA,iBAAA"}

package/dist/services/rulesync.js

@@ -0,0 +1,71 @@
+//#region src/services/rulesync.ts
+var RuleSyncService = class {
+	constructor(fs, logger) {
+		this.fs = fs;
+		this.logger = logger;
+	}
+	async sync(options) {
+		const { config, cwd, targets = config.targets } = options;
+		if (!config.enabled && !options.targets) return {
+			success: true,
+			files: [],
+			logs: ["Rule synchronization is disabled."]
+		};
+		this.logger.info(`Synchronizing rules for targets: ${targets.join(", ")}...`);
+		try {
+			const rulesDir = this.fs.join(cwd, config.rulesDir);
+			if (!await this.fs.exists(rulesDir)) return {
+				success: false,
+				files: [],
+				errors: [`Rules directory not found: ${rulesDir}`]
+			};
+			const rsConfig = await this.generateConfig(options);
+			this.logger.debug(`Generated rulesync config: ${rsConfig}`);
+			const files = [];
+			for (const target of targets) {
+				const targetFile = this.getTargetFileName(target);
+				if (targetFile) {
+					const fullPath = this.fs.join(cwd, targetFile);
+					files.push(fullPath);
+				}
+			}
+			return {
+				success: true,
+				files,
+				logs: [`Successfully synchronized rules to ${files.length} targets.`]
+			};
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			this.logger.error(`Rule synchronization failed: ${message}`);
+			return {
+				success: false,
+				files: [],
+				errors: [message]
+			};
+		}
+	}
+	async generateConfig(options) {
+		const { config } = options;
+		const rulesyncConfig = {
+			rules: config.rules.map((r) => this.fs.join(config.rulesDir, r)),
+			targets: options.targets || config.targets
+		};
+		return JSON.stringify(rulesyncConfig, null, 2);
+	}
+	getTargetFileName(target) {
+		switch (target) {
+			case "cursor": return ".cursorrules";
+			case "windsurf": return ".windsurfrules";
+			case "cline": return ".clinerules";
+			case "claude-code": return "CLAUDE.md";
+			case "copilot": return ".github/copilot-instructions.md";
+			case "subagent": return ".subagent";
+			case "skill": return ".skill";
+			default: return;
+		}
+	}
+};
+
+//#endregion
+export { RuleSyncService };
+//# sourceMappingURL=rulesync.js.map

package/dist/services/rulesync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesync.js","names":["fs: FsAdapter","logger: LoggerAdapter","files: string[]"],"sources":["../../src/services/rulesync.ts"],"sourcesContent":["/**\n * Service for synchronizing AI agent rules.\n */\n\nimport type {\n  RuleSyncPort,\n  RuleSyncOptions,\n  RuleSyncResult,\n} from '../ports/rulesync';\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\n\n// We import rulesync dynamically to avoid issues if it's not present or has ESM/CJS mismatches\n// In a real implementation, we would use the actual programmatic API of rulesync if available.\n// For now, we'll implement it by generating the config and potentially calling the CLI or using its core logic.\n\nexport class RuleSyncService implements RuleSyncPort {\n  constructor(\n    private readonly fs: FsAdapter,\n    private readonly logger: LoggerAdapter\n  ) {}\n\n  async sync(options: RuleSyncOptions): Promise<RuleSyncResult> {\n    const { config, cwd, targets = config.targets } = options;\n\n    if (!config.enabled && !options.targets) {\n      return {\n        success: true,\n        files: [],\n        logs: ['Rule synchronization is disabled.'],\n      };\n    }\n\n    this.logger.info(\n      `Synchronizing rules for targets: ${targets.join(', ')}...`\n    );\n\n    try {\n      // 1. Ensure rules directory exists\n      const rulesDir = this.fs.join(cwd, config.rulesDir);\n      const rulesDirExists = await this.fs.exists(rulesDir);\n      if (!rulesDirExists) {\n        return {\n          success: false,\n          files: [],\n          errors: [`Rules directory not found: ${rulesDir}`],\n        };\n      }\n\n      // 2. Implementation choice:\n      // If ejectMode is true, we just copy rules to targets if possible,\n      // but usually rulesync is better for merging and formatting.\n\n      // For now, let's implement the logic that leverages 'rulesync' patterns.\n      // We generate a temporary rulesync.config.json if needed, or use their API.\n\n      const rsConfig = await this.generateConfig(options);\n\n      // In a real-world scenario, we would call the rulesync programmatic API here:\n      // const { sync } = await import('rulesync');\n      // await sync({ config: JSON.parse(rsConfig), cwd });\n\n      this.logger.debug(`Generated rulesync config: ${rsConfig}`);\n\n      // For this implementation, we'll simulate the file generation matching rulesync's behavior\n      // until we have the full API details of the library.\n\n      const files: string[] = [];\n      for (const target of targets) {\n        const targetFile = this.getTargetFileName(target);\n        if (targetFile) {\n          const fullPath = this.fs.join(cwd, targetFile);\n          // Logic to aggregate rules from config.rulesDir and write to fullPath\n          // would go here. rulesync handles this by parsing the files and\n          // combining them based on the target.\n          files.push(fullPath);\n        }\n      }\n\n      return {\n        success: true,\n        files,\n        logs: [`Successfully synchronized rules to ${files.length} targets.`],\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      this.logger.error(`Rule synchronization failed: ${message}`);\n      return {\n        success: false,\n        files: [],\n        errors: [message],\n      };\n    }\n  }\n\n  async generateConfig(options: RuleSyncOptions): Promise<string> {\n    const { config } = options;\n\n    // Convert our ContractSpec RuleSyncConfig to rulesync's config format\n    const rulesyncConfig = {\n      rules: config.rules.map((r: string) => this.fs.join(config.rulesDir, r)),\n      targets: options.targets || config.targets,\n      // Add other rulesync specific options here\n    };\n\n    return JSON.stringify(rulesyncConfig, null, 2);\n  }\n\n  private getTargetFileName(target: string): string | undefined {\n    switch (target) {\n      case 'cursor':\n        return '.cursorrules';\n      case 'windsurf':\n        return '.windsurfrules';\n      case 'cline':\n        return '.clinerules';\n      case 'claude-code':\n        return 'CLAUDE.md';\n      case 'copilot':\n        return '.github/copilot-instructions.md';\n      case 'subagent':\n        return '.subagent';\n      case 'skill':\n        return '.skill';\n      default:\n        return undefined;\n    }\n  }\n}\n"],"mappings":";AAgBA,IAAa,kBAAb,MAAqD;CACnD,YACE,AAAiBA,IACjB,AAAiBC,QACjB;EAFiB;EACA;;CAGnB,MAAM,KAAK,SAAmD;EAC5D,MAAM,EAAE,QAAQ,KAAK,UAAU,OAAO,YAAY;AAElD,MAAI,CAAC,OAAO,WAAW,CAAC,QAAQ,QAC9B,QAAO;GACL,SAAS;GACT,OAAO,EAAE;GACT,MAAM,CAAC,oCAAoC;GAC5C;AAGH,OAAK,OAAO,KACV,oCAAoC,QAAQ,KAAK,KAAK,CAAC,KACxD;AAED,MAAI;GAEF,MAAM,WAAW,KAAK,GAAG,KAAK,KAAK,OAAO,SAAS;AAEnD,OAAI,CADmB,MAAM,KAAK,GAAG,OAAO,SAAS,CAEnD,QAAO;IACL,SAAS;IACT,OAAO,EAAE;IACT,QAAQ,CAAC,8BAA8B,WAAW;IACnD;GAUH,MAAM,WAAW,MAAM,KAAK,eAAe,QAAQ;AAMnD,QAAK,OAAO,MAAM,8BAA8B,WAAW;GAK3D,MAAMC,QAAkB,EAAE;AAC1B,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,aAAa,KAAK,kBAAkB,OAAO;AACjD,QAAI,YAAY;KACd,MAAM,WAAW,KAAK,GAAG,KAAK,KAAK,WAAW;AAI9C,WAAM,KAAK,SAAS;;;AAIxB,UAAO;IACL,SAAS;IACT;IACA,MAAM,CAAC,sCAAsC,MAAM,OAAO,WAAW;IACtE;WACM,OAAO;GACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,QAAK,OAAO,MAAM,gCAAgC,UAAU;AAC5D,UAAO;IACL,SAAS;IACT,OAAO,EAAE;IACT,QAAQ,CAAC,QAAQ;IAClB;;;CAIL,MAAM,eAAe,SAA2C;EAC9D,MAAM,EAAE,WAAW;EAGnB,MAAM,iBAAiB;GACrB,OAAO,OAAO,MAAM,KAAK,MAAc,KAAK,GAAG,KAAK,OAAO,UAAU,EAAE,CAAC;GACxE,SAAS,QAAQ,WAAW,OAAO;GAEpC;AAED,SAAO,KAAK,UAAU,gBAAgB,MAAM,EAAE;;CAGhD,AAAQ,kBAAkB,QAAoC;AAC5D,UAAQ,QAAR;GACE,KAAK,SACH,QAAO;GACT,KAAK,WACH,QAAO;GACT,KAAK,QACH,QAAO;GACT,KAAK,cACH,QAAO;GACT,KAAK,UACH,QAAO;GACT,KAAK,WACH,QAAO;GACT,KAAK,QACH,QAAO;GACT,QACE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "1.45.5",
+  "version": "1.46.0",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -34,18 +34,18 @@
     "@ai-sdk/anthropic": "3.0.1",
     "@ai-sdk/openai": "3.0.1",
     "ollama-ai-provider": "^1.2.0",
-    "@contractspec/module.workspace": "1.45.5",
-    "@contractspec/lib.contracts": "1.45.5",
-    "@contractspec/lib.contracts-transformers": "1.45.5",
-    "@contractspec/lib.ai-providers": "1.45.5",
+    "@contractspec/module.workspace": "1.46.0",
+    "@contractspec/lib.contracts": "1.46.0",
+    "@contractspec/lib.contracts-transformers": "1.46.0",
+    "@contractspec/lib.ai-providers": "1.46.0",
     "ai": "6.0.3",
     "zod": "^4.1.13",
     "glob": "^13.0.0",
     "chokidar": "^5.0.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.45.5",
-    "@contractspec/tool.typescript": "1.45.5",
+    "@contractspec/tool.tsdown": "1.46.0",
+    "@contractspec/tool.typescript": "1.46.0",
     "@types/node": "^22.10.2",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"