@contractspec/bundle.workspace 1.48.1 → 1.50.0

package/dist/adapters/git.mjs

@@ -75,6 +75,21 @@ function createNodeGitAdapter(cwd) {
 			} catch {
 				return [];
 			}
+		},
+		async diffFiles(baseline, patterns) {
+			try {
+				return execSync(`git diff --name-only ${baseline}...HEAD ${patterns && patterns.length > 0 ? `-- ${patterns.map((p) => `'${p}'`).join(" ")}` : ""}`, {
+					cwd: baseCwd,
+					encoding: "utf-8",
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					]
+				}).trim().split("\n").filter(Boolean);
+			} catch {
+				return [];
+			}
 		}
 	};
 }

package/dist/adapters/git.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"git.mjs","names":["path"],"sources":["../../src/adapters/git.ts"],"sourcesContent":["/**\n * Node.js git adapter implementation.\n */\n\nimport { execSync } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { GitAdapter, GitCleanOptions, GitLogEntry } from '../ports/git';\n\n/**\n * Create a Node.js git adapter.\n */\nexport function createNodeGitAdapter(cwd?: string): GitAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async showFile(ref: string, filePath: string): Promise<string> {\n      try {\n        return execSync(`git show ${ref}:${filePath}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n      } catch (error) {\n        throw new Error(\n          `Could not load ${filePath} at ref ${ref}: ${\n            error instanceof Error ? error.message : String(error)\n          }`\n        );\n      }\n    },\n\n    async clean(options?: GitCleanOptions): Promise<void> {\n      const flags: string[] = [];\n      if (options?.force) flags.push('-f');\n      if (options?.directories) flags.push('-d');\n      if (options?.ignored) flags.push('-x');\n      if (options?.dryRun) flags.push('--dry-run');\n\n      execSync(`git clean ${flags.join(' ')}`, {\n        cwd: baseCwd,\n        stdio: 'inherit',\n      });\n    },\n\n    async isGitRepo(path?: string): Promise<boolean> {\n      const targetPath = path ? resolve(baseCwd, path) : baseCwd;\n      try {\n        await access(resolve(targetPath, '.git'));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async log(baseline?: string): Promise<GitLogEntry[]> {\n      const ref = baseline ?? 'HEAD~10';\n      const format = '--format=%H|||%s|||%an|||%aI';\n\n      try {\n        const output = execSync(`git log ${ref}..HEAD ${format}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n\n        const entries: GitLogEntry[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n          if (!line) continue;\n          const [hash, message, author, date] = line.split('|||');\n          if (hash && message) {\n            entries.push({ hash, message, author, date });\n          }\n        }\n\n        return entries;\n      } catch {\n        // Return empty if git log fails (e.g., not enough commits)\n        return [];\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBAAqB,KAA0B;CAC7D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,SAAS,KAAa,UAAmC;AAC7D,OAAI;AACF,WAAO,SAAS,YAAY,IAAI,GAAG,YAAY;KAC7C,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;YACK,OAAO;AACd,UAAM,IAAI,MACR,kBAAkB,SAAS,UAAU,IAAI,IACvC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAEzD;;;EAIL,MAAM,MAAM,SAA0C;GACpD,MAAM,QAAkB,EAAE;AAC1B,OAAI,SAAS,MAAO,OAAM,KAAK,KAAK;AACpC,OAAI,SAAS,YAAa,OAAM,KAAK,KAAK;AAC1C,OAAI,SAAS,QAAS,OAAM,KAAK,KAAK;AACtC,OAAI,SAAS,OAAQ,OAAM,KAAK,YAAY;AAE5C,YAAS,aAAa,MAAM,KAAK,IAAI,IAAI;IACvC,KAAK;IACL,OAAO;IACR,CAAC;;EAGJ,MAAM,UAAU,QAAiC;GAC/C,MAAM,aAAaA,SAAO,QAAQ,SAASA,OAAK,GAAG;AACnD,OAAI;AACF,UAAM,OAAO,QAAQ,YAAY,OAAO,CAAC;AACzC,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,IAAI,UAA2C;GACnD,MAAM,MAAM,YAAY;GACxB,MAAM,SAAS;AAEf,OAAI;IACF,MAAM,SAAS,SAAS,WAAW,IAAI,SAAS,UAAU;KACxD,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;IAEF,MAAM,UAAyB,EAAE;AAEjC,SAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;AAC5C,SAAI,CAAC,KAAM;KACX,MAAM,CAAC,MAAM,SAAS,QAAQ,QAAQ,KAAK,MAAM,MAAM;AACvD,SAAI,QAAQ,QACV,SAAQ,KAAK;MAAE;MAAM;MAAS;MAAQ;MAAM,CAAC;;AAIjD,WAAO;WACD;AAEN,WAAO,EAAE;;;EAGd"}
+{"version":3,"file":"git.mjs","names":["path"],"sources":["../../src/adapters/git.ts"],"sourcesContent":["/**\n * Node.js git adapter implementation.\n */\n\nimport { execSync } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { GitAdapter, GitCleanOptions, GitLogEntry } from '../ports/git';\n\n/**\n * Create a Node.js git adapter.\n */\nexport function createNodeGitAdapter(cwd?: string): GitAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async showFile(ref: string, filePath: string): Promise<string> {\n      try {\n        return execSync(`git show ${ref}:${filePath}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n      } catch (error) {\n        throw new Error(\n          `Could not load ${filePath} at ref ${ref}: ${\n            error instanceof Error ? error.message : String(error)\n          }`\n        );\n      }\n    },\n\n    async clean(options?: GitCleanOptions): Promise<void> {\n      const flags: string[] = [];\n      if (options?.force) flags.push('-f');\n      if (options?.directories) flags.push('-d');\n      if (options?.ignored) flags.push('-x');\n      if (options?.dryRun) flags.push('--dry-run');\n\n      execSync(`git clean ${flags.join(' ')}`, {\n        cwd: baseCwd,\n        stdio: 'inherit',\n      });\n    },\n\n    async isGitRepo(path?: string): Promise<boolean> {\n      const targetPath = path ? resolve(baseCwd, path) : baseCwd;\n      try {\n        await access(resolve(targetPath, '.git'));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async log(baseline?: string): Promise<GitLogEntry[]> {\n      const ref = baseline ?? 'HEAD~10';\n      const format = '--format=%H|||%s|||%an|||%aI';\n\n      try {\n        const output = execSync(`git log ${ref}..HEAD ${format}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n\n        const entries: GitLogEntry[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n          if (!line) continue;\n          const [hash, message, author, date] = line.split('|||');\n          if (hash && message) {\n            entries.push({ hash, message, author, date });\n          }\n        }\n\n        return entries;\n      } catch {\n        // Return empty if git log fails (e.g., not enough commits)\n        return [];\n      }\n    },\n\n    async diffFiles(baseline: string, patterns?: string[]): Promise<string[]> {\n      try {\n        const pathSpecs =\n          patterns && patterns.length > 0\n            ? `-- ${patterns.map((p) => `'${p}'`).join(' ')}`\n            : '';\n\n        const output = execSync(\n          `git diff --name-only ${baseline}...HEAD ${pathSpecs}`,\n          {\n            cwd: baseCwd,\n            encoding: 'utf-8',\n            stdio: ['ignore', 'pipe', 'pipe'],\n          }\n        );\n\n        return output.trim().split('\\n').filter(Boolean);\n      } catch {\n        // Return empty array if diff fails (e.g., baseline doesn't exist)\n        return [];\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBAAqB,KAA0B;CAC7D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,SAAS,KAAa,UAAmC;AAC7D,OAAI;AACF,WAAO,SAAS,YAAY,IAAI,GAAG,YAAY;KAC7C,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;YACK,OAAO;AACd,UAAM,IAAI,MACR,kBAAkB,SAAS,UAAU,IAAI,IACvC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAEzD;;;EAIL,MAAM,MAAM,SAA0C;GACpD,MAAM,QAAkB,EAAE;AAC1B,OAAI,SAAS,MAAO,OAAM,KAAK,KAAK;AACpC,OAAI,SAAS,YAAa,OAAM,KAAK,KAAK;AAC1C,OAAI,SAAS,QAAS,OAAM,KAAK,KAAK;AACtC,OAAI,SAAS,OAAQ,OAAM,KAAK,YAAY;AAE5C,YAAS,aAAa,MAAM,KAAK,IAAI,IAAI;IACvC,KAAK;IACL,OAAO;IACR,CAAC;;EAGJ,MAAM,UAAU,QAAiC;GAC/C,MAAM,aAAaA,SAAO,QAAQ,SAASA,OAAK,GAAG;AACnD,OAAI;AACF,UAAM,OAAO,QAAQ,YAAY,OAAO,CAAC;AACzC,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,IAAI,UAA2C;GACnD,MAAM,MAAM,YAAY;GACxB,MAAM,SAAS;AAEf,OAAI;IACF,MAAM,SAAS,SAAS,WAAW,IAAI,SAAS,UAAU;KACxD,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;IAEF,MAAM,UAAyB,EAAE;AAEjC,SAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;AAC5C,SAAI,CAAC,KAAM;KACX,MAAM,CAAC,MAAM,SAAS,QAAQ,QAAQ,KAAK,MAAM,MAAM;AACvD,SAAI,QAAQ,QACV,SAAQ,KAAK;MAAE;MAAM;MAAS;MAAQ;MAAM,CAAC;;AAIjD,WAAO;WACD;AAEN,WAAO,EAAE;;;EAIb,MAAM,UAAU,UAAkB,UAAwC;AACxE,OAAI;AAeF,WATe,SACb,wBAAwB,SAAS,UALjC,YAAY,SAAS,SAAS,IAC1B,MAAM,SAAS,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI,KAC7C,MAIJ;KACE,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CACF,CAEa,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,QAAQ;WAC1C;AAEN,WAAO,EAAE;;;EAGd"}

package/dist/index.d.mts

@@ -103,7 +103,7 @@ import { index_d_exports as index_d_exports$3 } from "./services/hooks/index.mjs
 import { RuleSyncService } from "./services/rulesync.mjs";
 import { FixStrategyType, FixableIssue } from "./services/fix/types.mjs";
 import { index_d_exports as index_d_exports$1 } from "./services/fix/index.mjs";
-import { ViewAudience, generateView } from "./services/view/index.mjs";
+import { GenerateViewsOptions, GenerateViewsResult, ListSpecsForViewOptions, ListSpecsForViewResult, VALID_AUDIENCES, ViewAudience, ViewEntry, generateView, generateViews, listSpecsForView, validateAudience } from "./services/view/index.mjs";
 import { GapAnalysisResult, analyzeGap } from "./services/gap.mjs";
 import { GenerateArtifactsResult, generateArtifacts } from "./services/generate-artifacts.mjs";
 import { ExtractOptions, extractContracts } from "./services/extract.mjs";
@@ -125,4 +125,4 @@ import { index_d_exports as index_d_exports$5 } from "./ai/prompts/index.mjs";
 import "./ai/index.mjs";
 import { index_d_exports as index_d_exports$8 } from "./utils/index.mjs";
 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, EndpointVerification, ExtendedWorkspaceInfo, ExtractOptions, FULL_DEPENDENCIES, FeatureSpecParams, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, type FixStrategyType, type FixableIssue, FormatOptions, FormatterOptions, FsAdapter, GapAnalysisResult, GenerateArtifactsResult, GenericMCPAdapter, GitAdapter, GitCleanOptions, GitLogEntry, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, ImportServiceAdapters, ImportServiceOptions, ImportServiceResult, VerificationIssue as ImportVerificationIssue, VerifyOptions as ImportVerifyOptions, VerifyResult as ImportVerifyResult, 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, ReportOptions, 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, TestGeneratorOptions, TestGeneratorService, TestServiceOptions, TestServiceResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue$1 as VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions$1 as VerifyOptions, VerifyResult$1 as VerifyResult, VerifyService, ViewAudience, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeGap, 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, determineStatus, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractContracts, extractSpecReferences, index_d_exports as features, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, index_d_exports$1 as fix, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports$2 as formatters, generateAgentsMd, generateAppBlueprintSpec, generateArtifacts, generateClaudeMcpConfig, generateCliReport, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateFeatureSpec, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMarkdownReport, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateView, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getConventionPaths, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getSpecKeyVariants, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$3 as hooks, index_d_exports$4 as impact, importFromOpenApiService, importFromSourceService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, listTests, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseExplicitImplementations, parseGitModules, index_d_exports$5 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$6 as templates, toKebabCase, index_d_exports$7 as upgrade, index_d_exports$8 as utils, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifyImportedContracts, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$9 as versioning, index_d_exports$10 as vibe, 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, EndpointVerification, ExtendedWorkspaceInfo, ExtractOptions, FULL_DEPENDENCIES, FeatureSpecParams, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, type FixStrategyType, type FixableIssue, FormatOptions, FormatterOptions, FsAdapter, GapAnalysisResult, GenerateArtifactsResult, GenerateViewsOptions, GenerateViewsResult, GenericMCPAdapter, GitAdapter, GitCleanOptions, GitLogEntry, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, ImportServiceAdapters, ImportServiceOptions, ImportServiceResult, VerificationIssue as ImportVerificationIssue, VerifyOptions as ImportVerifyOptions, VerifyResult as ImportVerifyResult, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, LayerDiscoveryOptions, LayerDiscoveryResult, LayerInventory, LayerLocation, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsForViewOptions, ListSpecsForViewResult, 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, ReportOptions, 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, TestGeneratorOptions, TestGeneratorService, TestServiceOptions, TestServiceResult, VALID_AUDIENCES, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue$1 as VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions$1 as VerifyOptions, VerifyResult$1 as VerifyResult, VerifyService, ViewAudience, ViewEntry, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeGap, 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, determineStatus, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractContracts, extractSpecReferences, index_d_exports as features, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, index_d_exports$1 as fix, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports$2 as formatters, generateAgentsMd, generateAppBlueprintSpec, generateArtifacts, generateClaudeMcpConfig, generateCliReport, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateFeatureSpec, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMarkdownReport, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateView, generateViews, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getConventionPaths, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getSpecKeyVariants, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$3 as hooks, index_d_exports$4 as impact, importFromOpenApiService, importFromSourceService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, listSpecsForView, listTests, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseExplicitImplementations, parseGitModules, index_d_exports$5 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$6 as templates, toKebabCase, index_d_exports$7 as upgrade, index_d_exports$8 as utils, validateAgainstOpenApiService, validateAudience, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifyImportedContracts, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$9 as versioning, index_d_exports$10 as vibe, watchSpecs };

package/dist/index.mjs

@@ -96,7 +96,7 @@ import { upgrade_exports } from "./services/upgrade/index.mjs";
 import { hooks_exports } from "./services/hooks/index.mjs";
 import { RuleSyncService } from "./services/rulesync.mjs";
 import { fix_exports } from "./services/fix/index.mjs";
-import { generateView } from "./services/view/index.mjs";
+import { VALID_AUDIENCES, generateView, generateViews, listSpecsForView, validateAudience } from "./services/view/index.mjs";
 import { analyzeGap } from "./services/gap.mjs";
 import { extractContracts } from "./services/extract.mjs";
 import { vibe_exports } from "./services/vibe/index.mjs";
@@ -110,4 +110,4 @@ import { prompts_exports } from "./ai/prompts/index.mjs";
 import "./ai/index.mjs";
 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, RuleSyncService, SETUP_TARGET_LABELS, SimpleAgent, SpecCreatorService, TestGeneratorService, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeGap, 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, determineStatus, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractContracts, extractSpecReferences, features_exports as features, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, fix_exports as fix, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateArtifacts, generateClaudeMcpConfig, generateCliReport, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateFeatureSpec, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMarkdownReport, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateView, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getConventionPaths, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getSpecKeyVariants, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, hooks_exports as hooks, impact_exports as impact, importFromOpenApiService, importFromSourceService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, listTests, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseExplicitImplementations, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, toKebabCase, upgrade_exports as upgrade, utils_exports as utils, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifyImportedContracts, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, vibe_exports as vibe, 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, TestGeneratorService, VALID_AUDIENCES, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeGap, 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, determineStatus, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractContracts, extractSpecReferences, features_exports as features, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, fix_exports as fix, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateArtifacts, generateClaudeMcpConfig, generateCliReport, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateFeatureSpec, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMarkdownReport, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateView, generateViews, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getConventionPaths, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getSpecKeyVariants, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, hooks_exports as hooks, impact_exports as impact, importFromOpenApiService, importFromSourceService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, listSpecsForView, listTests, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseExplicitImplementations, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, toKebabCase, upgrade_exports as upgrade, utils_exports as utils, validateAgainstOpenApiService, validateAudience, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifyImportedContracts, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, vibe_exports as vibe, watchSpecs };

package/dist/ports/git.d.mts

@@ -22,6 +22,11 @@ interface GitAdapter {
    * Get commit log since a baseline ref.
    */
   log(baseline?: string): Promise<GitLogEntry[]>;
+  /**
+   * Get list of files changed between baseline and HEAD.
+   * Uses three-dot diff (baseline...HEAD) to show changes since branches diverged.
+   */
+  diffFiles(baseline: string, patterns?: string[]): Promise<string[]>;
 }
 /**
  * Entry from git log.

package/dist/ports/git.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.mts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAmBkC,UAnBjB,UAAA,CAmBiB;EAAR;;AAM1B;EAUiB,QAAA,CAAA,GAAA,EAAA,MAAe,EAAA,QAAA,EAAA,MAAA,CAAA,EA/BW,OA+BX,CAAA,MAAA,CAAA;;;;kBA1Bd,kBAAkB;;;;4BAKR;;;;0BAKF,QAAQ;;;;;UAMjB,WAAA;;;;;;;;;UAUA,eAAA"}
+{"version":3,"file":"git.d.mts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAmBkC,UAnBjB,UAAA,CAmBiB;EAAR;;;EAYT,QAAA,CAAA,GAAA,EAAW,MAAA,EAAA,QAAA,EAAA,MAAA,CAAA,EA3Be,OA2Bf,CAAA,MAAA,CAAA;EAUX;;;kBAhCC,kBAAkB;;;;4BAKR;;;;0BAKF,QAAQ;;;;;oDAMkB;;;;;UAMnC,WAAA;;;;;;;;;UAUA,eAAA"}

package/dist/services/index.d.mts

@@ -96,7 +96,7 @@ import { index_d_exports as index_d_exports$3 } from "./upgrade/index.mjs";
 import { index_d_exports as index_d_exports$4 } from "./hooks/index.mjs";
 import { RuleSyncService } from "./rulesync.mjs";
 import { index_d_exports as index_d_exports$5 } from "./fix/index.mjs";
-import { ViewAudience, generateView } from "./view/index.mjs";
+import { GenerateViewsOptions, GenerateViewsResult, ListSpecsForViewOptions, ListSpecsForViewResult, VALID_AUDIENCES, ViewAudience, ViewEntry, generateView, generateViews, listSpecsForView, validateAudience } from "./view/index.mjs";
 import { GapAnalysisResult, analyzeGap } from "./gap.mjs";
 import { GenerateArtifactsResult, generateArtifacts } from "./generate-artifacts.mjs";
 import { ExtractOptions, extractContracts } from "./extract.mjs";

package/dist/services/index.mjs

@@ -92,7 +92,7 @@ import { upgrade_exports } from "./upgrade/index.mjs";
 import { hooks_exports } from "./hooks/index.mjs";
 import { RuleSyncService } from "./rulesync.mjs";
 import { fix_exports } from "./fix/index.mjs";
-import { generateView } from "./view/index.mjs";
+import { VALID_AUDIENCES, generateView, generateViews, listSpecsForView, validateAudience } from "./view/index.mjs";
 import { analyzeGap } from "./gap.mjs";
 import { extractContracts } from "./extract.mjs";
 import { vibe_exports } from "./vibe/index.mjs";

package/dist/services/view/index.d.mts

@@ -2,10 +2,110 @@ import { WorkspaceAdapters } from "../../ports/logger.mjs";
 
 //#region src/services/view/index.d.ts
 type ViewAudience = 'product' | 'eng' | 'qa';
+/**
+ * Valid audience types for view generation.
+ */
+declare const VALID_AUDIENCES: ViewAudience[];
+/**
+ * Options for generating views.
+ */
+interface GenerateViewsOptions {
+  /**
+   * Target audience for the views.
+   */
+  audience: ViewAudience;
+  /**
+   * Explicit spec files to process (if not provided, scans workspace).
+   */
+  specFiles?: string[];
+  /**
+   * Git ref to compare against (only include specs changed since baseline).
+   * Only used when specFiles is not provided.
+   */
+  baseline?: string;
+}
+/**
+ * A single view entry with file path and content.
+ */
+interface ViewEntry {
+  filePath: string;
+  content: string;
+}
+/**
+ * Result of generating views.
+ */
+interface GenerateViewsResult {
+  /**
+   * Generated views.
+   */
+  views: ViewEntry[];
+  /**
+   * Total number of specs found in workspace (when scanning).
+   */
+  totalSpecs?: number;
+  /**
+   * Number of changed files since baseline (when baseline is provided).
+   */
+  changedFilesCount?: number;
+  /**
+   * Status of the operation.
+   */
+  status: 'success' | 'no_specs' | 'no_changes' | 'no_changed_specs';
+}
+/**
+ * Validate that the audience is a valid ViewAudience.
+ */
+declare function validateAudience(audience: string): audience is ViewAudience;
+/**
+ * Generate audience-specific views for specs.
+ *
+ * This is the main entry point for view generation. It handles:
+ * - Audience validation
+ * - Spec file resolution (explicit files or workspace scan with optional baseline filtering)
+ * - View generation for all matching specs
+ */
+declare function generateViews(adapters: WorkspaceAdapters, options: GenerateViewsOptions): Promise<GenerateViewsResult>;
+/**
+ * Options for listing specs for view generation.
+ */
+interface ListSpecsForViewOptions {
+  /**
+   * Git ref to compare against (only include specs changed since baseline).
+   */
+  baseline?: string;
+}
+/**
+ * Result of listing specs for view generation.
+ */
+interface ListSpecsForViewResult {
+  /**
+   * List of spec file paths to process.
+   */
+  specFiles: string[];
+  /**
+   * Total number of specs found in workspace.
+   */
+  totalSpecs: number;
+  /**
+   * Number of changed files (when baseline is provided).
+   */
+  changedFilesCount?: number;
+  /**
+   * Whether any changes were detected (when baseline is provided).
+   */
+  hasChanges?: boolean;
+}
+/**
+ * List spec files for view generation, with optional baseline filtering.
+ *
+ * When a baseline is provided, only specs that changed since the baseline
+ * are included in the result.
+ */
+declare function listSpecsForView(adapters: WorkspaceAdapters, options?: ListSpecsForViewOptions): Promise<ListSpecsForViewResult>;
 /**
  * Generate an audience-specific view of a spec file.
  */
 declare function generateView(specFile: string, audience: ViewAudience, adapters: WorkspaceAdapters): Promise<string>;
 //#endregion
-export { ViewAudience, generateView };
+export { GenerateViewsOptions, GenerateViewsResult, ListSpecsForViewOptions, ListSpecsForViewResult, VALID_AUDIENCES, ViewAudience, ViewEntry, generateView, generateViews, listSpecsForView, validateAudience };
 //# sourceMappingURL=index.d.mts.map

package/dist/services/view/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":[],"mappings":";;;KAMY,YAAA;;AAAZ;AAKA;AAEY,iBAFU,YAAA,CAEV,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA,YAAA,EAAA,QAAA,EACA,iBADA,CAAA,EAET,OAFS,CAAA,MAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":[],"mappings":";;;KAOY,YAAA;;AAAZ;AAKA;AAKiB,cALJ,eAKwB,EALP,YASlB,EAAA;AAeZ;AAQA;AAsBA;AAYsB,UA7DL,oBAAA,CA6DkB;EACvB;;;EAET,QAAA,EA5DS,YA4DT;EAAO;AA4EV;AAUA;EAyBsB,SAAA,CAAA,EAAA,MAAA,EAAgB;EAC1B;;;;EAEF,QAAA,CAAA,EAAA,MAAA;AAgDV;;;;AAIU,UAnNO,SAAA,CAmNP;;;;;;;UA3MO,mBAAA;;;;SAIR;;;;;;;;;;;;;;;;;iBAkBO,gBAAA,gCAAgD;;;;;;;;;iBAY1C,aAAA,WACV,4BACD,uBACR,QAAQ;;;;UA4EM,uBAAA;;;;;;;;;UAUA,sBAAA;;;;;;;;;;;;;;;;;;;;;;;;iBAyBK,gBAAA,WACV,6BACD,0BACR,QAAQ;;;;iBAgDW,YAAA,6BAEV,wBACA,oBACT"}

package/dist/services/view/index.mjs

@@ -1,7 +1,105 @@
+import { listSpecs } from "../list.mjs";
 import { loadSpecFromSource } from "@contractspec/module.workspace";
 
 //#region src/services/view/index.ts
 /**
+* Valid audience types for view generation.
+*/
+const VALID_AUDIENCES = [
+	"product",
+	"eng",
+	"qa"
+];
+/**
+* Validate that the audience is a valid ViewAudience.
+*/
+function validateAudience(audience) {
+	return VALID_AUDIENCES.includes(audience);
+}
+/**
+* Generate audience-specific views for specs.
+*
+* This is the main entry point for view generation. It handles:
+* - Audience validation
+* - Spec file resolution (explicit files or workspace scan with optional baseline filtering)
+* - View generation for all matching specs
+*/
+async function generateViews(adapters, options) {
+	if (!validateAudience(options.audience)) throw new Error(`Invalid audience: ${options.audience}. Must be one of: ${VALID_AUDIENCES.join(", ")}`);
+	let filesToProcess;
+	let totalSpecs;
+	let changedFilesCount;
+	if (options.specFiles && options.specFiles.length > 0) filesToProcess = options.specFiles;
+	else {
+		const listResult = await listSpecsForView(adapters, { baseline: options.baseline });
+		totalSpecs = listResult.totalSpecs;
+		changedFilesCount = listResult.changedFilesCount;
+		if (options.baseline) {
+			if (listResult.changedFilesCount === 0) return {
+				views: [],
+				totalSpecs,
+				changedFilesCount: 0,
+				status: "no_changes"
+			};
+			if (listResult.specFiles.length === 0) return {
+				views: [],
+				totalSpecs,
+				changedFilesCount,
+				status: "no_changed_specs"
+			};
+		}
+		filesToProcess = listResult.specFiles;
+	}
+	if (filesToProcess.length === 0) return {
+		views: [],
+		totalSpecs,
+		changedFilesCount,
+		status: "no_specs"
+	};
+	const views = [];
+	for (const specFile of filesToProcess) {
+		const content = await generateView(specFile, options.audience, adapters);
+		views.push({
+			filePath: specFile,
+			content
+		});
+	}
+	return {
+		views,
+		totalSpecs,
+		changedFilesCount,
+		status: "success"
+	};
+}
+/**
+* List spec files for view generation, with optional baseline filtering.
+*
+* When a baseline is provided, only specs that changed since the baseline
+* are included in the result.
+*/
+async function listSpecsForView(adapters, options = {}) {
+	const allSpecFiles = (await listSpecs({ fs: adapters.fs })).map((s) => s.filePath);
+	const totalSpecs = allSpecFiles.length;
+	if (!options.baseline) return {
+		specFiles: allSpecFiles,
+		totalSpecs
+	};
+	const changedFiles = await adapters.git.diffFiles(options.baseline);
+	if (changedFiles.length === 0) return {
+		specFiles: [],
+		totalSpecs,
+		changedFilesCount: 0,
+		hasChanges: false
+	};
+	const filteredSpecs = allSpecFiles.filter((specPath) => changedFiles.some((changed) => specPath.endsWith(changed) || changed.endsWith(specPath) || specPath.includes(changed) || changed.includes(specPath)));
+	return {
+		specFiles: filteredSpecs,
+		totalSpecs,
+		changedFilesCount: changedFiles.length,
+		hasChanges: filteredSpecs.length > 0
+	};
+}
+/**
 * Generate an audience-specific view of a spec file.
 */
 async function generateView(specFile, audience, adapters) {
@@ -115,5 +213,5 @@ function formatQaView(spec, lines) {
 }
 
 //#endregion
-export { generateView };
+export { VALID_AUDIENCES, generateView, generateViews, listSpecsForView, validateAudience };
 //# sourceMappingURL=index.mjs.map

package/dist/services/view/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":["import {\n  loadSpecFromSource,\n  type ParsedSpec,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\n\nexport type ViewAudience = 'product' | 'eng' | 'qa';\n\n/**\n * Generate an audience-specific view of a spec file.\n */\nexport async function generateView(\n  specFile: string,\n  audience: ViewAudience,\n  adapters: WorkspaceAdapters\n): Promise<string> {\n  // Using the module's static analysis, which uses node:fs internally\n  // We check existence first using adapters for better error handling\n  if (!(await adapters.fs.exists(specFile))) {\n    throw new Error(`File not found: ${specFile}`);\n  }\n\n  const specs = await loadSpecFromSource(specFile);\n\n  if (specs.length === 0) {\n    return `No specs found in ${specFile} (Parse result empty)`;\n  }\n\n  return specs\n    .map((spec) => formatSpecForAudience(spec, audience))\n    .join('\\n\\n---\\n\\n');\n}\n\nfunction formatSpecForAudience(\n  spec: ParsedSpec,\n  audience: ViewAudience\n): string {\n  const lines: string[] = [];\n\n  switch (audience) {\n    case 'product':\n      formatProductView(spec, lines);\n      break;\n    case 'eng':\n      formatEngView(spec, lines);\n      break;\n    case 'qa':\n      formatQaView(spec, lines);\n      break;\n  }\n\n  return lines.join('\\n');\n}\n\nfunction formatProductView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Product (User Flow & Capabilities)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`### Goal\\n${spec.meta.goal}\\n`);\n  }\n  if (spec.meta.context) {\n    lines.push(`### Context\\n${spec.meta.context}\\n`);\n  }\n\n  if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Capabilities (Operations)');\n      spec.operations.forEach((op) => lines.push(`- **${op.name}**`));\n      lines.push('');\n    }\n    if (spec.presentations?.length) {\n      lines.push('### User Interfaces (Presentations)');\n      spec.presentations.forEach((p) => lines.push(`- **${p.name}**`));\n      lines.push('');\n    }\n  } else if (spec.specType === 'operation') {\n    lines.push('### Behavior');\n    if (spec.hasPolicy) lines.push('- ✅ Enforces Business Policies');\n    if (spec.hasIo) lines.push('- ✅ Validates Inputs/Outputs');\n    if (spec.emittedEvents?.length) {\n      lines.push('### Triggers');\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- **${ev.name}** (Event)`)\n      );\n    }\n  } else {\n    lines.push(`Type: ${spec.specType}`);\n  }\n}\n\nfunction formatEngView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Engineering (API, Schemas, Constraints)');\n  lines.push('');\n\n  lines.push(`- **Type**: \\`${spec.specType}\\``);\n  lines.push(`- **Version**: \\`${spec.meta.version}\\``);\n  if (spec.meta.stability)\n    lines.push(`- **Stability**: \\`${spec.meta.stability}\\``);\n  lines.push('');\n\n  if (spec.specType === 'operation') {\n    lines.push('### Contract Details');\n    lines.push(`- **I/O Schema**: ${spec.hasIo ? '✅ Defined' : '❌ Missing'}`);\n    lines.push(\n      `- **Policy Config**: ${spec.hasPolicy ? '✅ Defined' : '❌ None'}`\n    );\n    lines.push('');\n\n    if (spec.emittedEvents?.length) {\n      lines.push('### Emitted Events');\n      spec.emittedEvents.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Operations');\n      spec.operations.forEach((op) => lines.push(`- \\`${op.name}\\``));\n      lines.push('');\n    }\n    if (spec.events?.length) {\n      lines.push('### Events');\n      spec.events.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  }\n\n  if (spec.sourceBlock) {\n    lines.push('### Source Signature');\n    lines.push('```typescript');\n    lines.push(spec.sourceBlock);\n    lines.push('```');\n  }\n}\n\nfunction formatQaView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: QA (Scenarios, Test Coverage)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`**Goal**: ${spec.meta.goal}\\n`);\n  }\n\n  if (spec.testRefs?.length) {\n    lines.push('### Linked Scenarios');\n    spec.testRefs.forEach((test) => lines.push(`- 🧪 \\`${test.name}\\``));\n    lines.push('');\n  } else {\n    lines.push('### Linked Scenarios');\n    lines.push('_(No explicit test refs found)_');\n    lines.push('');\n  }\n\n  lines.push('### Verification Checklist');\n  if (spec.specType === 'operation') {\n    lines.push(\n      `- [ ] Verify input validation for \\`${spec.meta.key}\\` (Success/Fail cases)`\n    );\n    if (spec.hasPolicy) lines.push(`- [ ] Verify policy enforcement rules`);\n    if (spec.emittedEvents?.length) {\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- [ ] Verify event \\`${ev.name}\\` is emitted`)\n      );\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      spec.operations.forEach((op) =>\n        lines.push(`- [ ] Test Operation flow: \\`${op.name}\\``)\n      );\n    }\n    if (spec.presentations?.length) {\n      spec.presentations.forEach((p) =>\n        lines.push(`- [ ] Test UI Component: \\`${p.name}\\``)\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;AAWA,eAAsB,aACpB,UACA,UACA,UACiB;AAGjB,KAAI,CAAE,MAAM,SAAS,GAAG,OAAO,SAAS,CACtC,OAAM,IAAI,MAAM,mBAAmB,WAAW;CAGhD,MAAM,QAAQ,MAAM,mBAAmB,SAAS;AAEhD,KAAI,MAAM,WAAW,EACnB,QAAO,qBAAqB,SAAS;AAGvC,QAAO,MACJ,KAAK,SAAS,sBAAsB,MAAM,SAAS,CAAC,CACpD,KAAK,cAAc;;AAGxB,SAAS,sBACP,MACA,UACQ;CACR,MAAM,QAAkB,EAAE;AAE1B,SAAQ,UAAR;EACE,KAAK;AACH,qBAAkB,MAAM,MAAM;AAC9B;EACF,KAAK;AACH,iBAAc,MAAM,MAAM;AAC1B;EACF,KAAK;AACH,gBAAa,MAAM,MAAM;AACzB;;AAGJ,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,kBAAkB,MAAkB,OAAiB;AAC5D,OAAM,KAAK,KAAK,KAAK,KAAK,MAAM;AAChC,OAAM,KAAK,+CAA+C;AAC1D,OAAM,KAAK,GAAG;AAEd,KAAI,KAAK,KAAK,KACZ,OAAM,KAAK,aAAa,KAAK,KAAK,KAAK,IAAI;AAE7C,KAAI,KAAK,KAAK,QACZ,OAAM,KAAK,gBAAgB,KAAK,KAAK,QAAQ,IAAI;AAGnD,KAAI,KAAK,aAAa,WAAW;AAC/B,MAAI,KAAK,YAAY,QAAQ;AAC3B,SAAM,KAAK,gCAAgC;AAC3C,QAAK,WAAW,SAAS,OAAO,MAAM,KAAK,OAAO,GAAG,KAAK,IAAI,CAAC;AAC/D,SAAM,KAAK,GAAG;;AAEhB,MAAI,KAAK,eAAe,QAAQ;AAC9B,SAAM,KAAK,sCAAsC;AACjD,QAAK,cAAc,SAAS,MAAM,MAAM,KAAK,OAAO,EAAE,KAAK,IAAI,CAAC;AAChE,SAAM,KAAK,GAAG;;YAEP,KAAK,aAAa,aAAa;AACxC,QAAM,KAAK,eAAe;AAC1B,MAAI,KAAK,UAAW,OAAM,KAAK,iCAAiC;AAChE,MAAI,KAAK,MAAO,OAAM,KAAK,+BAA+B;AAC1D,MAAI,KAAK,eAAe,QAAQ;AAC9B,SAAM,KAAK,eAAe;AAC1B,QAAK,cAAc,SAAS,OAC1B,MAAM,KAAK,OAAO,GAAG,KAAK,YAAY,CACvC;;OAGH,OAAM,KAAK,SAAS,KAAK,WAAW;;AAIxC,SAAS,cAAc,MAAkB,OAAiB;AACxD,OAAM,KAAK,KAAK,KAAK,KAAK,MAAM;AAChC,OAAM,KAAK,oDAAoD;AAC/D,OAAM,KAAK,GAAG;AAEd,OAAM,KAAK,iBAAiB,KAAK,SAAS,IAAI;AAC9C,OAAM,KAAK,oBAAoB,KAAK,KAAK,QAAQ,IAAI;AACrD,KAAI,KAAK,KAAK,UACZ,OAAM,KAAK,sBAAsB,KAAK,KAAK,UAAU,IAAI;AAC3D,OAAM,KAAK,GAAG;AAEd,KAAI,KAAK,aAAa,aAAa;AACjC,QAAM,KAAK,uBAAuB;AAClC,QAAM,KAAK,qBAAqB,KAAK,QAAQ,cAAc,cAAc;AACzE,QAAM,KACJ,wBAAwB,KAAK,YAAY,cAAc,WACxD;AACD,QAAM,KAAK,GAAG;AAEd,MAAI,KAAK,eAAe,QAAQ;AAC9B,SAAM,KAAK,qBAAqB;AAChC,QAAK,cAAc,SAAS,OAAO,MAAM,KAAK,OAAO,GAAG,KAAK,IAAI,CAAC;AAClE,SAAM,KAAK,GAAG;;YAEP,KAAK,aAAa,WAAW;AACtC,MAAI,KAAK,YAAY,QAAQ;AAC3B,SAAM,KAAK,iBAAiB;AAC5B,QAAK,WAAW,SAAS,OAAO,MAAM,KAAK,OAAO,GAAG,KAAK,IAAI,CAAC;AAC/D,SAAM,KAAK,GAAG;;AAEhB,MAAI,KAAK,QAAQ,QAAQ;AACvB,SAAM,KAAK,aAAa;AACxB,QAAK,OAAO,SAAS,OAAO,MAAM,KAAK,OAAO,GAAG,KAAK,IAAI,CAAC;AAC3D,SAAM,KAAK,GAAG;;;AAIlB,KAAI,KAAK,aAAa;AACpB,QAAM,KAAK,uBAAuB;AAClC,QAAM,KAAK,gBAAgB;AAC3B,QAAM,KAAK,KAAK,YAAY;AAC5B,QAAM,KAAK,MAAM;;;AAIrB,SAAS,aAAa,MAAkB,OAAiB;AACvD,OAAM,KAAK,KAAK,KAAK,KAAK,MAAM;AAChC,OAAM,KAAK,0CAA0C;AACrD,OAAM,KAAK,GAAG;AAEd,KAAI,KAAK,KAAK,KACZ,OAAM,KAAK,aAAa,KAAK,KAAK,KAAK,IAAI;AAG7C,KAAI,KAAK,UAAU,QAAQ;AACzB,QAAM,KAAK,uBAAuB;AAClC,OAAK,SAAS,SAAS,SAAS,MAAM,KAAK,UAAU,KAAK,KAAK,IAAI,CAAC;AACpE,QAAM,KAAK,GAAG;QACT;AACL,QAAM,KAAK,uBAAuB;AAClC,QAAM,KAAK,kCAAkC;AAC7C,QAAM,KAAK,GAAG;;AAGhB,OAAM,KAAK,6BAA6B;AACxC,KAAI,KAAK,aAAa,aAAa;AACjC,QAAM,KACJ,uCAAuC,KAAK,KAAK,IAAI,yBACtD;AACD,MAAI,KAAK,UAAW,OAAM,KAAK,wCAAwC;AACvE,MAAI,KAAK,eAAe,OACtB,MAAK,cAAc,SAAS,OAC1B,MAAM,KAAK,wBAAwB,GAAG,KAAK,eAAe,CAC3D;YAEM,KAAK,aAAa,WAAW;AACtC,MAAI,KAAK,YAAY,OACnB,MAAK,WAAW,SAAS,OACvB,MAAM,KAAK,gCAAgC,GAAG,KAAK,IAAI,CACxD;AAEH,MAAI,KAAK,eAAe,OACtB,MAAK,cAAc,SAAS,MAC1B,MAAM,KAAK,8BAA8B,EAAE,KAAK,IAAI,CACrD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":["import {\n  loadSpecFromSource,\n  type ParsedSpec,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\nimport { listSpecs } from '../list';\n\nexport type ViewAudience = 'product' | 'eng' | 'qa';\n\n/**\n * Valid audience types for view generation.\n */\nexport const VALID_AUDIENCES: ViewAudience[] = ['product', 'eng', 'qa'];\n\n/**\n * Options for generating views.\n */\nexport interface GenerateViewsOptions {\n  /**\n   * Target audience for the views.\n   */\n  audience: ViewAudience;\n  /**\n   * Explicit spec files to process (if not provided, scans workspace).\n   */\n  specFiles?: string[];\n  /**\n   * Git ref to compare against (only include specs changed since baseline).\n   * Only used when specFiles is not provided.\n   */\n  baseline?: string;\n}\n\n/**\n * A single view entry with file path and content.\n */\nexport interface ViewEntry {\n  filePath: string;\n  content: string;\n}\n\n/**\n * Result of generating views.\n */\nexport interface GenerateViewsResult {\n  /**\n   * Generated views.\n   */\n  views: ViewEntry[];\n  /**\n   * Total number of specs found in workspace (when scanning).\n   */\n  totalSpecs?: number;\n  /**\n   * Number of changed files since baseline (when baseline is provided).\n   */\n  changedFilesCount?: number;\n  /**\n   * Status of the operation.\n   */\n  status: 'success' | 'no_specs' | 'no_changes' | 'no_changed_specs';\n}\n\n/**\n * Validate that the audience is a valid ViewAudience.\n */\nexport function validateAudience(audience: string): audience is ViewAudience {\n  return VALID_AUDIENCES.includes(audience as ViewAudience);\n}\n\n/**\n * Generate audience-specific views for specs.\n *\n * This is the main entry point for view generation. It handles:\n * - Audience validation\n * - Spec file resolution (explicit files or workspace scan with optional baseline filtering)\n * - View generation for all matching specs\n */\nexport async function generateViews(\n  adapters: WorkspaceAdapters,\n  options: GenerateViewsOptions\n): Promise<GenerateViewsResult> {\n  // Validate audience\n  if (!validateAudience(options.audience)) {\n    throw new Error(\n      `Invalid audience: ${options.audience}. Must be one of: ${VALID_AUDIENCES.join(', ')}`\n    );\n  }\n\n  let filesToProcess: string[];\n  let totalSpecs: number | undefined;\n  let changedFilesCount: number | undefined;\n\n  // Resolve files to process\n  if (options.specFiles && options.specFiles.length > 0) {\n    filesToProcess = options.specFiles;\n  } else {\n    // Scan workspace with optional baseline filtering\n    const listResult = await listSpecsForView(adapters, {\n      baseline: options.baseline,\n    });\n\n    totalSpecs = listResult.totalSpecs;\n    changedFilesCount = listResult.changedFilesCount;\n\n    // Handle baseline filtering edge cases\n    if (options.baseline) {\n      if (listResult.changedFilesCount === 0) {\n        return {\n          views: [],\n          totalSpecs,\n          changedFilesCount: 0,\n          status: 'no_changes',\n        };\n      }\n\n      if (listResult.specFiles.length === 0) {\n        return {\n          views: [],\n          totalSpecs,\n          changedFilesCount,\n          status: 'no_changed_specs',\n        };\n      }\n    }\n\n    filesToProcess = listResult.specFiles;\n  }\n\n  // No specs to process\n  if (filesToProcess.length === 0) {\n    return {\n      views: [],\n      totalSpecs,\n      changedFilesCount,\n      status: 'no_specs',\n    };\n  }\n\n  // Generate views for all specs\n  const views: ViewEntry[] = [];\n  for (const specFile of filesToProcess) {\n    const content = await generateView(specFile, options.audience, adapters);\n    views.push({ filePath: specFile, content });\n  }\n\n  return {\n    views,\n    totalSpecs,\n    changedFilesCount,\n    status: 'success',\n  };\n}\n\n/**\n * Options for listing specs for view generation.\n */\nexport interface ListSpecsForViewOptions {\n  /**\n   * Git ref to compare against (only include specs changed since baseline).\n   */\n  baseline?: string;\n}\n\n/**\n * Result of listing specs for view generation.\n */\nexport interface ListSpecsForViewResult {\n  /**\n   * List of spec file paths to process.\n   */\n  specFiles: string[];\n  /**\n   * Total number of specs found in workspace.\n   */\n  totalSpecs: number;\n  /**\n   * Number of changed files (when baseline is provided).\n   */\n  changedFilesCount?: number;\n  /**\n   * Whether any changes were detected (when baseline is provided).\n   */\n  hasChanges?: boolean;\n}\n\n/**\n * List spec files for view generation, with optional baseline filtering.\n *\n * When a baseline is provided, only specs that changed since the baseline\n * are included in the result.\n */\nexport async function listSpecsForView(\n  adapters: WorkspaceAdapters,\n  options: ListSpecsForViewOptions = {}\n): Promise<ListSpecsForViewResult> {\n  // Get all specs in workspace\n  const specs = await listSpecs({ fs: adapters.fs });\n  const allSpecFiles = specs.map((s) => s.filePath);\n  const totalSpecs = allSpecFiles.length;\n\n  // If no baseline, return all specs\n  if (!options.baseline) {\n    return {\n      specFiles: allSpecFiles,\n      totalSpecs,\n    };\n  }\n\n  // Get changed files since baseline\n  const changedFiles = await adapters.git.diffFiles(options.baseline);\n\n  if (changedFiles.length === 0) {\n    return {\n      specFiles: [],\n      totalSpecs,\n      changedFilesCount: 0,\n      hasChanges: false,\n    };\n  }\n\n  // Filter to specs that match changed files\n  const filteredSpecs = allSpecFiles.filter((specPath) =>\n    changedFiles.some(\n      (changed) =>\n        specPath.endsWith(changed) ||\n        changed.endsWith(specPath) ||\n        specPath.includes(changed) ||\n        changed.includes(specPath)\n    )\n  );\n\n  return {\n    specFiles: filteredSpecs,\n    totalSpecs,\n    changedFilesCount: changedFiles.length,\n    hasChanges: filteredSpecs.length > 0,\n  };\n}\n\n/**\n * Generate an audience-specific view of a spec file.\n */\nexport async function generateView(\n  specFile: string,\n  audience: ViewAudience,\n  adapters: WorkspaceAdapters\n): Promise<string> {\n  // Using the module's static analysis, which uses node:fs internally\n  // We check existence first using adapters for better error handling\n  if (!(await adapters.fs.exists(specFile))) {\n    throw new Error(`File not found: ${specFile}`);\n  }\n\n  const specs = await loadSpecFromSource(specFile);\n\n  if (specs.length === 0) {\n    return `No specs found in ${specFile} (Parse result empty)`;\n  }\n\n  return specs\n    .map((spec) => formatSpecForAudience(spec, audience))\n    .join('\\n\\n---\\n\\n');\n}\n\nfunction formatSpecForAudience(\n  spec: ParsedSpec,\n  audience: ViewAudience\n): string {\n  const lines: string[] = [];\n\n  switch (audience) {\n    case 'product':\n      formatProductView(spec, lines);\n      break;\n    case 'eng':\n      formatEngView(spec, lines);\n      break;\n    case 'qa':\n      formatQaView(spec, lines);\n      break;\n  }\n\n  return lines.join('\\n');\n}\n\nfunction formatProductView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Product (User Flow & Capabilities)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`### Goal\\n${spec.meta.goal}\\n`);\n  }\n  if (spec.meta.context) {\n    lines.push(`### Context\\n${spec.meta.context}\\n`);\n  }\n\n  if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Capabilities (Operations)');\n      spec.operations.forEach((op) => lines.push(`- **${op.name}**`));\n      lines.push('');\n    }\n    if (spec.presentations?.length) {\n      lines.push('### User Interfaces (Presentations)');\n      spec.presentations.forEach((p) => lines.push(`- **${p.name}**`));\n      lines.push('');\n    }\n  } else if (spec.specType === 'operation') {\n    lines.push('### Behavior');\n    if (spec.hasPolicy) lines.push('- ✅ Enforces Business Policies');\n    if (spec.hasIo) lines.push('- ✅ Validates Inputs/Outputs');\n    if (spec.emittedEvents?.length) {\n      lines.push('### Triggers');\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- **${ev.name}** (Event)`)\n      );\n    }\n  } else {\n    lines.push(`Type: ${spec.specType}`);\n  }\n}\n\nfunction formatEngView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Engineering (API, Schemas, Constraints)');\n  lines.push('');\n\n  lines.push(`- **Type**: \\`${spec.specType}\\``);\n  lines.push(`- **Version**: \\`${spec.meta.version}\\``);\n  if (spec.meta.stability)\n    lines.push(`- **Stability**: \\`${spec.meta.stability}\\``);\n  lines.push('');\n\n  if (spec.specType === 'operation') {\n    lines.push('### Contract Details');\n    lines.push(`- **I/O Schema**: ${spec.hasIo ? '✅ Defined' : '❌ Missing'}`);\n    lines.push(\n      `- **Policy Config**: ${spec.hasPolicy ? '✅ Defined' : '❌ None'}`\n    );\n    lines.push('');\n\n    if (spec.emittedEvents?.length) {\n      lines.push('### Emitted Events');\n      spec.emittedEvents.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Operations');\n      spec.operations.forEach((op) => lines.push(`- \\`${op.name}\\``));\n      lines.push('');\n    }\n    if (spec.events?.length) {\n      lines.push('### Events');\n      spec.events.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  }\n\n  if (spec.sourceBlock) {\n    lines.push('### Source Signature');\n    lines.push('```typescript');\n    lines.push(spec.sourceBlock);\n    lines.push('```');\n  }\n}\n\nfunction formatQaView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: QA (Scenarios, Test Coverage)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`**Goal**: ${spec.meta.goal}\\n`);\n  }\n\n  if (spec.testRefs?.length) {\n    lines.push('### Linked Scenarios');\n    spec.testRefs.forEach((test) => lines.push(`- 🧪 \\`${test.name}\\``));\n    lines.push('');\n  } else {\n    lines.push('### Linked Scenarios');\n    lines.push('_(No explicit test refs found)_');\n    lines.push('');\n  }\n\n  lines.push('### Verification Checklist');\n  if (spec.specType === 'operation') {\n    lines.push(\n      `- [ ] Verify input validation for \\`${spec.meta.key}\\` (Success/Fail cases)`\n    );\n    if (spec.hasPolicy) lines.push(`- [ ] Verify policy enforcement rules`);\n    if (spec.emittedEvents?.length) {\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- [ ] Verify event \\`${ev.name}\\` is emitted`)\n      );\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      spec.operations.forEach((op) =>\n        lines.push(`- [ ] Test Operation flow: \\`${op.name}\\``)\n      );\n    }\n    if (spec.presentations?.length) {\n      spec.presentations.forEach((p) =>\n        lines.push(`- [ ] Test UI Component: \\`${p.name}\\``)\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "1.48.1",
+  "version": "1.50.0",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -31,12 +31,12 @@
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.11",
     "@ai-sdk/openai": "3.0.8",
-    "@contractspec/lib.ai-agent": "1.48.1",
-    "@contractspec/lib.ai-providers": "1.48.0",
-    "@contractspec/lib.contracts": "1.48.1",
-    "@contractspec/lib.contracts-transformers": "1.48.1",
-    "@contractspec/lib.source-extractors": "0.2.1",
-    "@contractspec/module.workspace": "1.48.1",
+    "@contractspec/lib.ai-agent": "1.50.0",
+    "@contractspec/lib.ai-providers": "1.50.0",
+    "@contractspec/lib.contracts": "1.50.0",
+    "@contractspec/lib.contracts-transformers": "1.50.0",
+    "@contractspec/lib.source-extractors": "0.4.0",
+    "@contractspec/module.workspace": "1.50.0",
     "ai": "6.0.29",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -48,8 +48,8 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.48.0",
-    "@contractspec/tool.typescript": "1.48.0",
+    "@contractspec/tool.tsdown": "1.50.0",
+    "@contractspec/tool.typescript": "1.50.0",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^25.0.6",
     "tsdown": "^0.19.0",