@contractspec/bundle.workspace 1.44.0

package/dist/services/ci-check/ci-check-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-check-service.js","names":["issues: CIIssue[]","categorySummaries: CICheckCategorySummary[]","result: CICheckResult","allCategories: CICheckCategory[]","categoryLabels: Record<CICheckCategory, string>"],"sources":["../../../src/services/ci-check/ci-check-service.ts"],"sourcesContent":["/**\n * CI Check service.\n *\n * Orchestrates all validation checks for CI/CD pipelines.\n * Returns structured results suitable for multiple output formats.\n */\n\nimport {\n  isFeatureFile,\n  validateSpecStructure,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport { analyzeIntegrity } from '../integrity';\nimport { analyzeDeps } from '../deps';\nimport { runDoctor } from '../doctor/doctor-service';\nimport { validateImplementationFiles } from '../validate-implementation';\nimport { loadWorkspaceConfig } from '../config';\nimport { resolveAllImplementations } from '../implementation/resolver';\n\nimport type {\n  CICheckCategory,\n  CICheckCategorySummary,\n  CICheckOptions,\n  CICheckResult,\n  CIIssue,\n} from './types';\n\n/**\n * Run all CI checks and return structured results.\n */\nexport async function runCIChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CICheckOptions = {}\n): Promise<CICheckResult> {\n  const startTime = Date.now();\n  const { fs, logger } = adapters;\n\n  const issues: CIIssue[] = [];\n  const categorySummaries: CICheckCategorySummary[] = [];\n\n  // Determine which checks to run\n  const checksToRun = getChecksToRun(options);\n\n  logger.info('Starting CI checks...', { checks: checksToRun });\n\n  // Discover spec files\n  const files = await fs.glob({ pattern: options.pattern });\n  const specFiles = files.filter(\n    (f) => !isFeatureFile(f) && !f.includes('.test.') && !f.includes('.spec.')\n  );\n\n  // Run spec structure validation\n  if (checksToRun.includes('structure')) {\n    const categoryStart = Date.now();\n    const structureIssues = await runStructureChecks(adapters, specFiles);\n    issues.push(...structureIssues);\n    categorySummaries.push(\n      createCategorySummary(\n        'structure',\n        structureIssues,\n        Date.now() - categoryStart\n      )\n    );\n  }\n\n  // Run integrity analysis\n  if (checksToRun.includes('integrity')) {\n    const categoryStart = Date.now();\n    const integrityIssues = await runIntegrityChecks(adapters, options);\n    issues.push(...integrityIssues);\n    categorySummaries.push(\n      createCategorySummary(\n        'integrity',\n        integrityIssues,\n        Date.now() - categoryStart\n      )\n    );\n  }\n\n  // Run dependency analysis\n  if (checksToRun.includes('deps')) {\n    const categoryStart = Date.now();\n    const depsIssues = await runDepsChecks(adapters, options);\n    issues.push(...depsIssues);\n    categorySummaries.push(\n      createCategorySummary('deps', depsIssues, Date.now() - categoryStart)\n    );\n  }\n\n  // Run doctor checks (skip AI in CI)\n  if (checksToRun.includes('doctor')) {\n    const categoryStart = Date.now();\n    const doctorIssues = await runDoctorChecks(adapters, options);\n    issues.push(...doctorIssues);\n    categorySummaries.push(\n      createCategorySummary('doctor', doctorIssues, Date.now() - categoryStart)\n    );\n  }\n\n  // Run handler checks\n  if (checksToRun.includes('handlers') || options.checkHandlers) {\n    const categoryStart = Date.now();\n    const handlerIssues = await runHandlerChecks(adapters, specFiles);\n    issues.push(...handlerIssues);\n    categorySummaries.push(\n      createCategorySummary(\n        'handlers',\n        handlerIssues,\n        Date.now() - categoryStart\n      )\n    );\n  }\n\n  // Run test checks\n  if (checksToRun.includes('tests') || options.checkTests) {\n    const categoryStart = Date.now();\n    const testIssues = await runTestChecks(adapters, specFiles);\n    issues.push(...testIssues);\n    categorySummaries.push(\n      createCategorySummary('tests', testIssues, Date.now() - categoryStart)\n    );\n  }\n\n  // Run implementation checks\n  if (checksToRun.includes('implementation')) {\n    const categoryStart = Date.now();\n    const implIssues = await runImplementationChecks(\n      adapters,\n      specFiles,\n      options\n    );\n    issues.push(...implIssues);\n    categorySummaries.push(\n      createCategorySummary(\n        'implementation',\n        implIssues,\n        Date.now() - categoryStart\n      )\n    );\n  }\n\n  // Calculate totals\n  const totalErrors = issues.filter((i) => i.severity === 'error').length;\n  const totalWarnings = issues.filter((i) => i.severity === 'warning').length;\n  const totalNotes = issues.filter((i) => i.severity === 'note').length;\n\n  // Determine success (no errors, or no warnings if failOnWarnings)\n  const success = options.failOnWarnings\n    ? totalErrors === 0 && totalWarnings === 0\n    : totalErrors === 0;\n\n  // Try to get git info\n  const gitInfo = await getGitInfo(fs);\n\n  const result: CICheckResult = {\n    success,\n    totalErrors,\n    totalWarnings,\n    totalNotes,\n    issues,\n    categories: categorySummaries,\n    durationMs: Date.now() - startTime,\n    timestamp: new Date().toISOString(),\n    ...gitInfo,\n  };\n\n  logger.info('CI checks complete', {\n    success,\n    errors: totalErrors,\n    warnings: totalWarnings,\n    durationMs: result.durationMs,\n  });\n\n  return result;\n}\n\n/**\n * Determine which checks to run based on options.\n */\nfunction getChecksToRun(options: CICheckOptions): CICheckCategory[] {\n  const allCategories: CICheckCategory[] = [\n    'structure',\n    'integrity',\n    'deps',\n    'doctor',\n  ];\n\n  // Add optional checks if explicitly requested\n  if (options.checkHandlers) {\n    allCategories.push('handlers');\n  }\n  if (options.checkTests) {\n    allCategories.push('tests');\n  }\n  if (options.implementation) {\n    allCategories.push('implementation');\n  }\n\n  // If specific checks are requested, use those\n  if (options.checks && options.checks.length > 0) {\n    return options.checks;\n  }\n\n  // Otherwise, use all minus skipped\n  if (options.skip && options.skip.length > 0) {\n    return allCategories.filter((c) => !options.skip?.includes(c));\n  }\n\n  return allCategories;\n}\n\n/**\n * Run spec structure validation checks.\n */\nasync function runStructureChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  specFiles: string[]\n): Promise<CIIssue[]> {\n  const { fs } = adapters;\n  const issues: CIIssue[] = [];\n\n  for (const file of specFiles) {\n    const content = await fs.readFile(file);\n    const result = validateSpecStructure(content, file);\n\n    for (const error of result.errors) {\n      issues.push({\n        ruleId: 'spec-structure-error',\n        severity: 'error',\n        message: error,\n        category: 'structure',\n        file,\n      });\n    }\n\n    for (const warning of result.warnings) {\n      issues.push({\n        ruleId: 'spec-structure-warning',\n        severity: 'warning',\n        message: warning,\n        category: 'structure',\n        file,\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Run integrity analysis checks.\n */\nasync function runIntegrityChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CICheckOptions\n): Promise<CIIssue[]> {\n  const issues: CIIssue[] = [];\n\n  const result = await analyzeIntegrity(adapters, {\n    pattern: options.pattern,\n    all: true,\n  });\n\n  for (const issue of result.issues) {\n    issues.push({\n      ruleId: `integrity-${issue.type}`,\n      severity: issue.severity === 'error' ? 'error' : 'warning',\n      message: issue.message,\n      category: 'integrity',\n      file: issue.file,\n      context: {\n        specKey: issue.specKey,\n        specType: issue.specType,\n        featureKey: issue.featureKey,\n        ref: issue.ref,\n      },\n    });\n  }\n\n  return issues;\n}\n\n/**\n * Run dependency analysis checks.\n */\nasync function runDepsChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CICheckOptions\n): Promise<CIIssue[]> {\n  const issues: CIIssue[] = [];\n\n  const result = await analyzeDeps(adapters, {\n    pattern: options.pattern,\n  });\n\n  // Report circular dependencies as errors\n  for (const cycle of result.cycles) {\n    issues.push({\n      ruleId: 'deps-circular',\n      severity: 'error',\n      message: `Circular dependency detected: ${cycle.join(' → ')}`,\n      category: 'deps',\n      context: { cycle },\n    });\n  }\n\n  // Report missing dependencies as errors\n  for (const item of result.missing) {\n    for (const missing of item.missing) {\n      issues.push({\n        ruleId: 'deps-missing',\n        severity: 'error',\n        message: `Missing dependency: ${item.contract} requires ${missing}`,\n        category: 'deps',\n        context: { contract: item.contract, missing },\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Run doctor checks (skipping AI in CI).\n */\nasync function runDoctorChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CICheckOptions\n): Promise<CIIssue[]> {\n  const issues: CIIssue[] = [];\n\n  const workspaceRoot = options.workspaceRoot ?? process.cwd();\n\n  const result = await runDoctor(adapters, {\n    workspaceRoot,\n    skipAi: true, // Always skip AI in CI\n    categories: ['cli', 'config', 'deps', 'workspace'], // Skip AI and MCP\n  });\n\n  for (const check of result.checks) {\n    if (check.status === 'fail') {\n      issues.push({\n        ruleId: `doctor-${check.category}-${check.name.toLowerCase().replace(/\\s+/g, '-')}`,\n        severity: 'error',\n        message: `${check.name}: ${check.message}`,\n        category: 'doctor',\n        context: { details: check.details },\n      });\n    } else if (check.status === 'warn') {\n      issues.push({\n        ruleId: `doctor-${check.category}-${check.name.toLowerCase().replace(/\\s+/g, '-')}`,\n        severity: 'warning',\n        message: `${check.name}: ${check.message}`,\n        category: 'doctor',\n        context: { details: check.details },\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Run handler implementation checks.\n */\nasync function runHandlerChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  specFiles: string[]\n): Promise<CIIssue[]> {\n  const { fs } = adapters;\n  const issues: CIIssue[] = [];\n\n  const config = await loadWorkspaceConfig(fs);\n\n  for (const specFile of specFiles) {\n    // Only check operation specs\n    if (!specFile.includes('.operation.')) continue;\n\n    const result = await validateImplementationFiles(specFile, { fs }, config, {\n      checkHandlers: true,\n      outputDir: config.outputDir,\n    });\n\n    for (const error of result.errors) {\n      issues.push({\n        ruleId: 'handler-missing',\n        severity: 'warning', // Handler missing is a warning, not error\n        message: error,\n        category: 'handlers',\n        file: specFile,\n      });\n    }\n\n    for (const warning of result.warnings) {\n      issues.push({\n        ruleId: 'handler-warning',\n        severity: 'warning',\n        message: warning,\n        category: 'handlers',\n        file: specFile,\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Run test coverage checks.\n */\nasync function runTestChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  specFiles: string[]\n): Promise<CIIssue[]> {\n  const { fs } = adapters;\n  const issues: CIIssue[] = [];\n\n  const config = await loadWorkspaceConfig(fs);\n\n  for (const specFile of specFiles) {\n    // Only check operation specs\n    if (!specFile.includes('.operation.')) continue;\n\n    const result = await validateImplementationFiles(specFile, { fs }, config, {\n      checkTests: true,\n      outputDir: config.outputDir,\n    });\n\n    for (const error of result.errors) {\n      issues.push({\n        ruleId: 'test-missing',\n        severity: 'warning', // Test missing is a warning, not error\n        message: error,\n        category: 'tests',\n        file: specFile,\n      });\n    }\n\n    for (const warning of result.warnings) {\n      issues.push({\n        ruleId: 'test-warning',\n        severity: 'warning',\n        message: warning,\n        category: 'tests',\n        file: specFile,\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Run implementation verification checks.\n */\nasync function runImplementationChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  specFiles: string[],\n  options: CICheckOptions\n): Promise<CIIssue[]> {\n  const { fs } = adapters;\n  const issues: CIIssue[] = [];\n\n  const config = await loadWorkspaceConfig(fs);\n  const implOptions = options.implementation ?? {};\n\n  // Only check operation specs by default\n  const operationSpecs = specFiles.filter((f) => f.includes('.operation.'));\n\n  // Resolve implementations for all specs\n  const results = await resolveAllImplementations(\n    operationSpecs,\n    { fs },\n    config,\n    {\n      computeHashes: implOptions.useCache ?? true,\n    }\n  );\n\n  for (const result of results) {\n    // Check if implementation is required\n    if (implOptions.requireImplemented && result.status === 'missing') {\n      issues.push({\n        ruleId: 'impl-missing',\n        severity: 'error',\n        message: `Spec ${result.specKey} has no implementation`,\n        category: 'implementation',\n        file: result.specPath,\n        context: {\n          specKey: result.specKey,\n          specVersion: result.specVersion,\n          status: result.status,\n        },\n      });\n    } else if (result.status === 'missing') {\n      issues.push({\n        ruleId: 'impl-missing',\n        severity: 'warning',\n        message: `Spec ${result.specKey} has no implementation`,\n        category: 'implementation',\n        file: result.specPath,\n        context: {\n          specKey: result.specKey,\n          specVersion: result.specVersion,\n          status: result.status,\n        },\n      });\n    }\n\n    // Check for partial implementations\n    if (!implOptions.allowPartial && result.status === 'partial') {\n      const missingImpls = result.implementations\n        .filter((i) => !i.exists && i.type !== 'test')\n        .map((i) => i.path);\n\n      issues.push({\n        ruleId: 'impl-partial',\n        severity: 'warning',\n        message: `Spec ${result.specKey} has partial implementation: missing ${missingImpls.join(', ')}`,\n        category: 'implementation',\n        file: result.specPath,\n        context: {\n          specKey: result.specKey,\n          specVersion: result.specVersion,\n          status: result.status,\n          missingFiles: missingImpls,\n        },\n      });\n    }\n\n    // Report missing tests\n    const missingTests = result.implementations.filter(\n      (i) => !i.exists && i.type === 'test'\n    );\n    if (missingTests.length > 0) {\n      issues.push({\n        ruleId: 'impl-missing-tests',\n        severity: 'note',\n        message: `Spec ${result.specKey} missing test files: ${missingTests.map((t) => t.path).join(', ')}`,\n        category: 'implementation',\n        file: result.specPath,\n        context: {\n          specKey: result.specKey,\n          missingTests: missingTests.map((t) => t.path),\n        },\n      });\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Create a category summary from issues.\n */\nfunction createCategorySummary(\n  category: CICheckCategory,\n  issues: CIIssue[],\n  durationMs: number\n): CICheckCategorySummary {\n  const categoryLabels: Record<CICheckCategory, string> = {\n    structure: 'Spec Structure Validation',\n    integrity: 'Contract Integrity Analysis',\n    deps: 'Dependency Analysis',\n    doctor: 'Installation Health',\n    handlers: 'Handler Implementation',\n    tests: 'Test Coverage',\n    implementation: 'Implementation Verification',\n  };\n\n  const errors = issues.filter((i) => i.severity === 'error').length;\n  const warnings = issues.filter((i) => i.severity === 'warning').length;\n  const notes = issues.filter((i) => i.severity === 'note').length;\n\n  return {\n    category,\n    label: categoryLabels[category],\n    errors,\n    warnings,\n    notes,\n    passed: errors === 0,\n    durationMs,\n  };\n}\n\n/**\n * Get git information if available.\n */\nasync function getGitInfo(\n  fs: FsAdapter\n): Promise<{ commitSha?: string; branch?: string }> {\n  try {\n    // Try to read from .git/HEAD and refs\n    const gitHeadPath = '.git/HEAD';\n    if (!(await fs.exists(gitHeadPath))) {\n      return {};\n    }\n\n    const headContent = await fs.readFile(gitHeadPath);\n    const refMatch = headContent.match(/^ref: (.+)$/m);\n\n    if (refMatch) {\n      const branch = refMatch[1]?.replace('refs/heads/', '');\n      const refPath = `.git/${refMatch[1]}`;\n\n      if (await fs.exists(refPath)) {\n        const commitSha = (await fs.readFile(refPath)).trim();\n        return { commitSha, branch };\n      }\n\n      return { branch };\n    }\n\n    // Detached HEAD - content is the SHA\n    const commitSha = headContent.trim();\n    return { commitSha };\n  } catch {\n    return {};\n  }\n}\n"],"mappings":"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"}

package/dist/services/ci-check/index.d.ts

@@ -0,0 +1,2 @@
+import { ALL_CI_CHECK_CATEGORIES, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS } from "./types.js";
+import { runCIChecks } from "./ci-check-service.js";

package/dist/services/ci-check/index.js

@@ -0,0 +1,2 @@
+import { ALL_CI_CHECK_CATEGORIES, CI_CHECK_CATEGORY_LABELS } from "./types.js";
+import { runCIChecks } from "./ci-check-service.js";

package/dist/services/ci-check/types.d.ts

@@ -0,0 +1,143 @@
+//#region src/services/ci-check/types.d.ts
+/**
+ * CI Check service types.
+ *
+ * Types for CI/CD validation checks with support for multiple output formats.
+ */
+/**
+ * Categories of CI checks.
+ */
+type CICheckCategory = 'structure' | 'integrity' | 'deps' | 'doctor' | 'handlers' | 'tests' | 'implementation';
+/**
+ * All available CI check categories.
+ */
+declare const ALL_CI_CHECK_CATEGORIES: CICheckCategory[];
+/**
+ * Human-readable labels for CI check categories.
+ */
+declare const CI_CHECK_CATEGORY_LABELS: Record<CICheckCategory, string>;
+/**
+ * Severity of a CI check issue.
+ */
+type CIIssueSeverity = 'error' | 'warning' | 'note';
+/**
+ * A single issue found during CI checks.
+ */
+interface CIIssue {
+  /** Unique ID for the issue type. */
+  ruleId: string;
+  /** Severity level. */
+  severity: CIIssueSeverity;
+  /** Human-readable message. */
+  message: string;
+  /** Category of the check. */
+  category: CICheckCategory;
+  /** File path where the issue was found. */
+  file?: string;
+  /** Line number (1-based). */
+  line?: number;
+  /** Column number (1-based). */
+  column?: number;
+  /** End line number (1-based). */
+  endLine?: number;
+  /** End column number (1-based). */
+  endColumn?: number;
+  /** Additional context. */
+  context?: Record<string, unknown>;
+}
+/**
+ * Summary statistics for a CI check category.
+ */
+interface CICheckCategorySummary {
+  /** Category name. */
+  category: CICheckCategory;
+  /** Human-readable label. */
+  label: string;
+  /** Number of errors. */
+  errors: number;
+  /** Number of warnings. */
+  warnings: number;
+  /** Number of notes. */
+  notes: number;
+  /** Whether this category passed. */
+  passed: boolean;
+  /** Duration in milliseconds. */
+  durationMs: number;
+}
+/**
+ * Overall CI check result.
+ */
+interface CICheckResult {
+  /** Whether all checks passed (no errors). */
+  success: boolean;
+  /** Total number of errors. */
+  totalErrors: number;
+  /** Total number of warnings. */
+  totalWarnings: number;
+  /** Total number of notes. */
+  totalNotes: number;
+  /** All issues found. */
+  issues: CIIssue[];
+  /** Summary by category. */
+  categories: CICheckCategorySummary[];
+  /** Total duration in milliseconds. */
+  durationMs: number;
+  /** Timestamp when the check was run. */
+  timestamp: string;
+  /** Git commit SHA if available. */
+  commitSha?: string;
+  /** Git branch if available. */
+  branch?: string;
+}
+/**
+ * Options for running CI checks.
+ */
+interface CICheckOptions {
+  /** Glob pattern for spec discovery. */
+  pattern?: string;
+  /** Check categories to run (defaults to all). */
+  checks?: CICheckCategory[];
+  /** Skip specific categories. */
+  skip?: CICheckCategory[];
+  /** Include handler existence checks. */
+  checkHandlers?: boolean;
+  /** Include test coverage checks. */
+  checkTests?: boolean;
+  /** Fail on warnings (treat warnings as errors). */
+  failOnWarnings?: boolean;
+  /** Workspace root directory. */
+  workspaceRoot?: string;
+  /** Implementation check options. */
+  implementation?: {
+    /** Require all specs to be implemented. */
+    requireImplemented?: boolean;
+    /** Verification tier to run. */
+    verificationTier?: 'structure' | 'behavior' | 'ai';
+    /** Use cache for verification results. */
+    useCache?: boolean;
+    /** Allow partial implementations. */
+    allowPartial?: boolean;
+  };
+}
+/**
+ * Output format for CI check results.
+ */
+type CIOutputFormat = 'text' | 'json' | 'sarif';
+/**
+ * Options for formatting CI check output.
+ */
+interface CIFormatOptions {
+  /** Output format. */
+  format: CIOutputFormat;
+  /** Whether to use colors (for text format). */
+  colors?: boolean;
+  /** Tool name for SARIF output. */
+  toolName?: string;
+  /** Tool version for SARIF output. */
+  toolVersion?: string;
+  /** Repository URI for SARIF output. */
+  repositoryUri?: string;
+}
+//#endregion
+export { ALL_CI_CHECK_CATEGORIES, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS };
+//# sourceMappingURL=types.d.ts.map

package/dist/services/ci-check/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/ci-check/types.ts"],"sourcesContent":[],"mappings":";;AASA;AAYA;AAaA;AAaA;AAKA;;;AAoBY,KA/DA,eAAA,GA+DA,WAAA,GAAA,WAAA,GAAA,MAAA,GAAA,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,gBAAA;;AAMZ;AAoBA;AA0BiB,cAvGJ,uBA2GF,EA3G2B,eA6G7B,EAAA;AAyBT;AAKA;;cA9Ha,0BAA0B,OAAO;;;;KAalC,eAAA;;;;UAKK,OAAA;;;;YAIL;;;;YAIA;;;;;;;;;;;;YAYA;;;;;UAMK,sBAAA;;YAEL;;;;;;;;;;;;;;;;;UAkBK,aAAA;;;;;;;;;;UAUP;;cAEI;;;;;;;;;;;;;UAcG,cAAA;;;;WAIN;;SAEF;;;;;;;;;;;;;;;;;;;;;;;;KAyBG,cAAA;;;;UAKK,eAAA;;UAEP"}

package/dist/services/ci-check/types.js

@@ -0,0 +1,29 @@
+//#region src/services/ci-check/types.ts
+/**
+* All available CI check categories.
+*/
+const ALL_CI_CHECK_CATEGORIES = [
+	"structure",
+	"integrity",
+	"deps",
+	"doctor",
+	"handlers",
+	"tests",
+	"implementation"
+];
+/**
+* Human-readable labels for CI check categories.
+*/
+const CI_CHECK_CATEGORY_LABELS = {
+	structure: "Spec Structure Validation",
+	integrity: "Contract Integrity Analysis",
+	deps: "Dependency Analysis",
+	doctor: "Installation Health",
+	handlers: "Handler Implementation",
+	tests: "Test Coverage",
+	implementation: "Implementation Verification"
+};
+
+//#endregion
+export { ALL_CI_CHECK_CATEGORIES, CI_CHECK_CATEGORY_LABELS };
+//# sourceMappingURL=types.js.map

package/dist/services/ci-check/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["ALL_CI_CHECK_CATEGORIES: CICheckCategory[]","CI_CHECK_CATEGORY_LABELS: Record<CICheckCategory, string>"],"sources":["../../../src/services/ci-check/types.ts"],"sourcesContent":["/**\n * CI Check service types.\n *\n * Types for CI/CD validation checks with support for multiple output formats.\n */\n\n/**\n * Categories of CI checks.\n */\nexport type CICheckCategory =\n  | 'structure'\n  | 'integrity'\n  | 'deps'\n  | 'doctor'\n  | 'handlers'\n  | 'tests'\n  | 'implementation';\n\n/**\n * All available CI check categories.\n */\nexport const ALL_CI_CHECK_CATEGORIES: CICheckCategory[] = [\n  'structure',\n  'integrity',\n  'deps',\n  'doctor',\n  'handlers',\n  'tests',\n  'implementation',\n];\n\n/**\n * Human-readable labels for CI check categories.\n */\nexport const CI_CHECK_CATEGORY_LABELS: Record<CICheckCategory, string> = {\n  structure: 'Spec Structure Validation',\n  integrity: 'Contract Integrity Analysis',\n  deps: 'Dependency Analysis',\n  doctor: 'Installation Health',\n  handlers: 'Handler Implementation',\n  tests: 'Test Coverage',\n  implementation: 'Implementation Verification',\n};\n\n/**\n * Severity of a CI check issue.\n */\nexport type CIIssueSeverity = 'error' | 'warning' | 'note';\n\n/**\n * A single issue found during CI checks.\n */\nexport interface CIIssue {\n  /** Unique ID for the issue type. */\n  ruleId: string;\n  /** Severity level. */\n  severity: CIIssueSeverity;\n  /** Human-readable message. */\n  message: string;\n  /** Category of the check. */\n  category: CICheckCategory;\n  /** File path where the issue was found. */\n  file?: string;\n  /** Line number (1-based). */\n  line?: number;\n  /** Column number (1-based). */\n  column?: number;\n  /** End line number (1-based). */\n  endLine?: number;\n  /** End column number (1-based). */\n  endColumn?: number;\n  /** Additional context. */\n  context?: Record<string, unknown>;\n}\n\n/**\n * Summary statistics for a CI check category.\n */\nexport interface CICheckCategorySummary {\n  /** Category name. */\n  category: CICheckCategory;\n  /** Human-readable label. */\n  label: string;\n  /** Number of errors. */\n  errors: number;\n  /** Number of warnings. */\n  warnings: number;\n  /** Number of notes. */\n  notes: number;\n  /** Whether this category passed. */\n  passed: boolean;\n  /** Duration in milliseconds. */\n  durationMs: number;\n}\n\n/**\n * Overall CI check result.\n */\nexport interface CICheckResult {\n  /** Whether all checks passed (no errors). */\n  success: boolean;\n  /** Total number of errors. */\n  totalErrors: number;\n  /** Total number of warnings. */\n  totalWarnings: number;\n  /** Total number of notes. */\n  totalNotes: number;\n  /** All issues found. */\n  issues: CIIssue[];\n  /** Summary by category. */\n  categories: CICheckCategorySummary[];\n  /** Total duration in milliseconds. */\n  durationMs: number;\n  /** Timestamp when the check was run. */\n  timestamp: string;\n  /** Git commit SHA if available. */\n  commitSha?: string;\n  /** Git branch if available. */\n  branch?: string;\n}\n\n/**\n * Options for running CI checks.\n */\nexport interface CICheckOptions {\n  /** Glob pattern for spec discovery. */\n  pattern?: string;\n  /** Check categories to run (defaults to all). */\n  checks?: CICheckCategory[];\n  /** Skip specific categories. */\n  skip?: CICheckCategory[];\n  /** Include handler existence checks. */\n  checkHandlers?: boolean;\n  /** Include test coverage checks. */\n  checkTests?: boolean;\n  /** Fail on warnings (treat warnings as errors). */\n  failOnWarnings?: boolean;\n  /** Workspace root directory. */\n  workspaceRoot?: string;\n  /** Implementation check options. */\n  implementation?: {\n    /** Require all specs to be implemented. */\n    requireImplemented?: boolean;\n    /** Verification tier to run. */\n    verificationTier?: 'structure' | 'behavior' | 'ai';\n    /** Use cache for verification results. */\n    useCache?: boolean;\n    /** Allow partial implementations. */\n    allowPartial?: boolean;\n  };\n}\n\n/**\n * Output format for CI check results.\n */\nexport type CIOutputFormat = 'text' | 'json' | 'sarif';\n\n/**\n * Options for formatting CI check output.\n */\nexport interface CIFormatOptions {\n  /** Output format. */\n  format: CIOutputFormat;\n  /** Whether to use colors (for text format). */\n  colors?: boolean;\n  /** Tool name for SARIF output. */\n  toolName?: string;\n  /** Tool version for SARIF output. */\n  toolVersion?: string;\n  /** Repository URI for SARIF output. */\n  repositoryUri?: string;\n}\n"],"mappings":";;;;AAqBA,MAAaA,0BAA6C;CACxD;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAaC,2BAA4D;CACvE,WAAW;CACX,WAAW;CACX,MAAM;CACN,QAAQ;CACR,UAAU;CACV,OAAO;CACP,gBAAgB;CACjB"}

package/dist/services/clean.d.ts

@@ -0,0 +1,41 @@
+import { FsAdapter } from "../ports/fs.js";
+import { LoggerAdapter } from "../ports/logger.js";
+
+//#region src/services/clean.d.ts
+
+interface CleanOptions {
+  /**
+   * When true, only remove known build artifact directories and known generated
+   * suffixes (safe-by-default).
+   */
+  generatedOnly?: boolean;
+  /**
+   * Skip deletions; just report.
+   */
+  dryRun?: boolean;
+  /**
+   * Only delete files older than this many days.
+   */
+  olderThanDays?: number;
+  /**
+   * Output directory used for generated artifacts (handlers/components/forms).
+   */
+  outputDir?: string;
+}
+interface CleanResult {
+  removed: {
+    path: string;
+    size: number;
+  }[];
+  skipped: {
+    path: string;
+    reason: string;
+  }[];
+}
+declare function cleanArtifacts(adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options?: CleanOptions): Promise<CleanResult>;
+//#endregion
+export { CleanOptions, CleanResult, cleanArtifacts };
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","names":[],"sources":["../../src/services/clean.ts"],"sourcesContent":[],"mappings":";;;;;AAmCkB,UA1BD,YAAA,CA0BC;EAAmB;;;;EAE3B,aAAA,CAAA,EAAA,OAAA;;;;;;;;;;;;;;UARO,WAAA;;;;;;;;;;iBAKK,cAAA;MACJ;UAAmB;aAC1B,eACR,QAAQ"}

package/dist/services/clean.js

@@ -0,0 +1,72 @@
+//#region src/services/clean.ts
+async function cleanArtifacts(adapters, options = {}) {
+	const { fs, logger } = adapters;
+	const outputDir = (options.outputDir ?? "./src").replace(/\\/g, "/");
+	const basePatterns = [
+		"generated/**",
+		"dist/**",
+		".turbo/**"
+	];
+	const outputDirPatterns = [
+		`${outputDir}/handlers/**/*.handler.ts`,
+		`${outputDir}/handlers/**/*.handler.test.ts`,
+		`${outputDir}/components/**/*.tsx`,
+		`${outputDir}/components/**/*.test.tsx`,
+		`${outputDir}/forms/**/*.form.tsx`,
+		`${outputDir}/forms/**/*.form.test.tsx`,
+		`${outputDir}/**/*.runner.ts`,
+		`${outputDir}/**/*.renderer.tsx`
+	];
+	const patterns = options.generatedOnly ? [...basePatterns, ...outputDirPatterns] : [
+		...basePatterns,
+		"**/*.generated.ts",
+		"**/*.generated.js",
+		"**/*.generated.d.ts",
+		...outputDirPatterns
+	];
+	const candidates = await fs.glob({
+		patterns,
+		ignore: ["node_modules/**"]
+	});
+	const removed = [];
+	const skipped = [];
+	for (const p of candidates) try {
+		const st = await fs.stat(p);
+		const ageDays = (Date.now() - st.mtime.getTime()) / (1e3 * 60 * 60 * 24);
+		if (typeof options.olderThanDays === "number" && ageDays < options.olderThanDays) {
+			skipped.push({
+				path: p,
+				reason: `younger_than_${options.olderThanDays}_days`
+			});
+			continue;
+		}
+		if (options.dryRun) logger.info("[dry-run] clean would remove", {
+			path: p,
+			size: st.size
+		});
+		else {
+			await fs.remove(p);
+			logger.info("clean.removed", {
+				path: p,
+				size: st.size
+			});
+		}
+		removed.push({
+			path: p,
+			size: st.size
+		});
+	} catch (error) {
+		skipped.push({
+			path: p,
+			reason: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return {
+		removed,
+		skipped
+	};
+}
+
+//#endregion
+export { cleanArtifacts };
+//# sourceMappingURL=clean.js.map

package/dist/services/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","names":["removed: { path: string; size: number }[]","skipped: { path: string; reason: string }[]"],"sources":["../../src/services/clean.ts"],"sourcesContent":["/**\n * Clean service.\n *\n * Safe-by-default cleanup of generated artifacts.\n */\n\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\n\nexport interface CleanOptions {\n  /**\n   * When true, only remove known build artifact directories and known generated\n   * suffixes (safe-by-default).\n   */\n  generatedOnly?: boolean;\n  /**\n   * Skip deletions; just report.\n   */\n  dryRun?: boolean;\n  /**\n   * Only delete files older than this many days.\n   */\n  olderThanDays?: number;\n  /**\n   * Output directory used for generated artifacts (handlers/components/forms).\n   */\n  outputDir?: string;\n}\n\nexport interface CleanResult {\n  removed: { path: string; size: number }[];\n  skipped: { path: string; reason: string }[];\n}\n\nexport async function cleanArtifacts(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CleanOptions = {}\n): Promise<CleanResult> {\n  const { fs, logger } = adapters;\n  const outputDir = (options.outputDir ?? './src').replace(/\\\\/g, '/');\n\n  const basePatterns = ['generated/**', 'dist/**', '.turbo/**'];\n\n  const outputDirPatterns = [\n    `${outputDir}/handlers/**/*.handler.ts`,\n    `${outputDir}/handlers/**/*.handler.test.ts`,\n    `${outputDir}/components/**/*.tsx`,\n    `${outputDir}/components/**/*.test.tsx`,\n    `${outputDir}/forms/**/*.form.tsx`,\n    `${outputDir}/forms/**/*.form.test.tsx`,\n    `${outputDir}/**/*.runner.ts`,\n    `${outputDir}/**/*.renderer.tsx`,\n  ];\n\n  const patterns = options.generatedOnly\n    ? [...basePatterns, ...outputDirPatterns]\n    : [\n        ...basePatterns,\n        '**/*.generated.ts',\n        '**/*.generated.js',\n        '**/*.generated.d.ts',\n        ...outputDirPatterns,\n      ];\n\n  const candidates = await fs.glob({\n    patterns,\n    ignore: ['node_modules/**'],\n  });\n\n  const removed: { path: string; size: number }[] = [];\n  const skipped: { path: string; reason: string }[] = [];\n\n  for (const p of candidates) {\n    try {\n      const st = await fs.stat(p);\n      const ageDays = (Date.now() - st.mtime.getTime()) / (1000 * 60 * 60 * 24);\n      if (\n        typeof options.olderThanDays === 'number' &&\n        ageDays < options.olderThanDays\n      ) {\n        skipped.push({\n          path: p,\n          reason: `younger_than_${options.olderThanDays}_days`,\n        });\n        continue;\n      }\n\n      if (options.dryRun) {\n        logger.info('[dry-run] clean would remove', { path: p, size: st.size });\n      } else {\n        await fs.remove(p);\n        logger.info('clean.removed', { path: p, size: st.size });\n      }\n      removed.push({ path: p, size: st.size });\n    } catch (error) {\n      skipped.push({\n        path: p,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  return { removed, skipped };\n}\n"],"mappings":";AAkCA,eAAsB,eACpB,UACA,UAAwB,EAAE,EACJ;CACtB,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,aAAa,QAAQ,aAAa,SAAS,QAAQ,OAAO,IAAI;CAEpE,MAAM,eAAe;EAAC;EAAgB;EAAW;EAAY;CAE7D,MAAM,oBAAoB;EACxB,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACd;CAED,MAAM,WAAW,QAAQ,gBACrB,CAAC,GAAG,cAAc,GAAG,kBAAkB,GACvC;EACE,GAAG;EACH;EACA;EACA;EACA,GAAG;EACJ;CAEL,MAAM,aAAa,MAAM,GAAG,KAAK;EAC/B;EACA,QAAQ,CAAC,kBAAkB;EAC5B,CAAC;CAEF,MAAMA,UAA4C,EAAE;CACpD,MAAMC,UAA8C,EAAE;AAEtD,MAAK,MAAM,KAAK,WACd,KAAI;EACF,MAAM,KAAK,MAAM,GAAG,KAAK,EAAE;EAC3B,MAAM,WAAW,KAAK,KAAK,GAAG,GAAG,MAAM,SAAS,KAAK,MAAO,KAAK,KAAK;AACtE,MACE,OAAO,QAAQ,kBAAkB,YACjC,UAAU,QAAQ,eAClB;AACA,WAAQ,KAAK;IACX,MAAM;IACN,QAAQ,gBAAgB,QAAQ,cAAc;IAC/C,CAAC;AACF;;AAGF,MAAI,QAAQ,OACV,QAAO,KAAK,gCAAgC;GAAE,MAAM;GAAG,MAAM,GAAG;GAAM,CAAC;OAClE;AACL,SAAM,GAAG,OAAO,EAAE;AAClB,UAAO,KAAK,iBAAiB;IAAE,MAAM;IAAG,MAAM,GAAG;IAAM,CAAC;;AAE1D,UAAQ,KAAK;GAAE,MAAM;GAAG,MAAM,GAAG;GAAM,CAAC;UACjC,OAAO;AACd,UAAQ,KAAK;GACX,MAAM;GACN,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,CAAC;;AAIN,QAAO;EAAE;EAAS;EAAS"}

package/dist/services/config.d.ts

@@ -0,0 +1,26 @@
+import { FsAdapter } from "../ports/fs.js";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/services/config.d.ts
+
+/**
+ * Load workspace configuration from .contractsrc.json.
+ */
+declare function loadWorkspaceConfig(fs: FsAdapter, cwd?: string): Promise<WorkspaceConfig>;
+/**
+ * Merge config with CLI options and environment variables.
+ */
+declare function mergeWorkspaceConfig(config: WorkspaceConfig, options: {
+  provider?: string;
+  model?: string;
+  agentMode?: string;
+  endpoint?: string;
+  outputDir?: string;
+}): WorkspaceConfig;
+/**
+ * Get API key for the configured provider.
+ */
+declare function getApiKey(provider: WorkspaceConfig['aiProvider']): string | undefined;
+//#endregion
+export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCU,iBAHY,mBAAA,CAGZ,EAAA,EAFJ,SAEI,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAAP,OAAO,CAAC,eAAD,CAAA;AAoBV;AA0CA;;iBA1CgB,oBAAA,SACN;;;;;;IAQP;;;;iBAiCa,SAAA,WACJ"}

package/dist/services/config.js

@@ -0,0 +1,77 @@
+import { DEFAULT_WORKSPACE_CONFIG } from "@contractspec/module.workspace";
+import * as z from "zod";
+
+//#region src/services/config.ts
+/**
+* Workspace configuration service.
+*/
+const ConfigSchema = z.object({
+	aiProvider: z.enum([
+		"claude",
+		"openai",
+		"ollama",
+		"custom"
+	]).default("claude"),
+	aiModel: z.string().optional(),
+	agentMode: z.enum([
+		"simple",
+		"cursor",
+		"claude-code",
+		"openai-codex"
+	]).default("simple"),
+	customEndpoint: z.string().url().nullable().optional(),
+	customApiKey: z.string().nullable().optional(),
+	outputDir: z.string().default("./src"),
+	conventions: z.object({
+		operations: z.string().default("interactions/commands|queries"),
+		events: z.string().default("events"),
+		presentations: z.string().default("presentations"),
+		forms: z.string().default("forms")
+	}),
+	defaultOwners: z.array(z.string()).default([]),
+	defaultTags: z.array(z.string()).default([])
+});
+/**
+* Load workspace configuration from .contractsrc.json.
+*/
+async function loadWorkspaceConfig(fs, cwd) {
+	const configPath = fs.join(cwd ?? ".", ".contractsrc.json");
+	if (!await fs.exists(configPath)) return DEFAULT_WORKSPACE_CONFIG;
+	try {
+		const content = await fs.readFile(configPath);
+		const parsed = JSON.parse(content);
+		return ConfigSchema.parse(parsed);
+	} catch {
+		return DEFAULT_WORKSPACE_CONFIG;
+	}
+}
+/**
+* Merge config with CLI options and environment variables.
+*/
+function mergeWorkspaceConfig(config, options) {
+	return {
+		...config,
+		aiProvider: options.provider ?? process.env["CONTRACTSPEC_AI_PROVIDER"] ?? config.aiProvider,
+		aiModel: options.model ?? process.env["CONTRACTSPEC_AI_MODEL"] ?? config.aiModel,
+		agentMode: options.agentMode ?? process.env["CONTRACTSPEC_AGENT_MODE"] ?? config.agentMode,
+		customEndpoint: options.endpoint ?? process.env["CONTRACTSPEC_LLM_ENDPOINT"] ?? config.customEndpoint ?? void 0,
+		customApiKey: process.env["CONTRACTSPEC_LLM_API_KEY"] ?? config.customApiKey ?? void 0,
+		outputDir: options.outputDir ?? config.outputDir
+	};
+}
+/**
+* Get API key for the configured provider.
+*/
+function getApiKey(provider) {
+	switch (provider) {
+		case "claude": return process.env["ANTHROPIC_API_KEY"];
+		case "openai": return process.env["OPENAI_API_KEY"];
+		case "custom": return process.env["CONTRACTSPEC_LLM_API_KEY"];
+		case "ollama": return;
+		default: return;
+	}
+}
+
+//#endregion
+export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };
+//# sourceMappingURL=config.js.map

package/dist/services/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":["/**\n * Workspace configuration service.\n */\n\nimport * as z from 'zod';\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport { DEFAULT_WORKSPACE_CONFIG } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\nconst ConfigSchema = z.object({\n  aiProvider: z\n    .enum(['claude', 'openai', 'ollama', 'custom'])\n    .default('claude'),\n  aiModel: z.string().optional(),\n  agentMode: z\n    .enum(['simple', 'cursor', 'claude-code', 'openai-codex'])\n    .default('simple'),\n  customEndpoint: z.string().url().nullable().optional(),\n  customApiKey: z.string().nullable().optional(),\n  outputDir: z.string().default('./src'),\n  conventions: z.object({\n    operations: z.string().default('interactions/commands|queries'),\n    events: z.string().default('events'),\n    presentations: z.string().default('presentations'),\n    forms: z.string().default('forms'),\n  }),\n  defaultOwners: z.array(z.string()).default([]),\n  defaultTags: z.array(z.string()).default([]),\n});\n\n/**\n * Load workspace configuration from .contractsrc.json.\n */\nexport async function loadWorkspaceConfig(\n  fs: FsAdapter,\n  cwd?: string\n): Promise<WorkspaceConfig> {\n  const configPath = fs.join(cwd ?? '.', '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const parsed = JSON.parse(content);\n    return ConfigSchema.parse(parsed) as WorkspaceConfig;\n  } catch {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n}\n\n/**\n * Merge config with CLI options and environment variables.\n */\nexport function mergeWorkspaceConfig(\n  config: WorkspaceConfig,\n  options: {\n    provider?: string;\n    model?: string;\n    agentMode?: string;\n    endpoint?: string;\n    outputDir?: string;\n  }\n): WorkspaceConfig {\n  return {\n    ...config,\n    aiProvider:\n      (options.provider as WorkspaceConfig['aiProvider']) ??\n      (process.env[\n        'CONTRACTSPEC_AI_PROVIDER'\n      ] as WorkspaceConfig['aiProvider']) ??\n      config.aiProvider,\n    aiModel:\n      options.model ?? process.env['CONTRACTSPEC_AI_MODEL'] ?? config.aiModel,\n    agentMode:\n      (options.agentMode as WorkspaceConfig['agentMode']) ??\n      (process.env[\n        'CONTRACTSPEC_AGENT_MODE'\n      ] as WorkspaceConfig['agentMode']) ??\n      config.agentMode,\n    customEndpoint:\n      options.endpoint ??\n      process.env['CONTRACTSPEC_LLM_ENDPOINT'] ??\n      config.customEndpoint ??\n      undefined,\n    customApiKey:\n      process.env['CONTRACTSPEC_LLM_API_KEY'] ??\n      config.customApiKey ??\n      undefined,\n    outputDir: options.outputDir ?? config.outputDir,\n  };\n}\n\n/**\n * Get API key for the configured provider.\n */\nexport function getApiKey(\n  provider: WorkspaceConfig['aiProvider']\n): string | undefined {\n  switch (provider) {\n    case 'claude':\n      return process.env['ANTHROPIC_API_KEY'];\n    case 'openai':\n      return process.env['OPENAI_API_KEY'];\n    case 'custom':\n      return process.env['CONTRACTSPEC_LLM_API_KEY'];\n    case 'ollama':\n      return undefined; // Ollama doesn't need API key for local\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,eAAe,EAAE,OAAO;CAC5B,YAAY,EACT,KAAK;EAAC;EAAU;EAAU;EAAU;EAAS,CAAC,CAC9C,QAAQ,SAAS;CACpB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,WAAW,EACR,KAAK;EAAC;EAAU;EAAU;EAAe;EAAe,CAAC,CACzD,QAAQ,SAAS;CACpB,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CACtD,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;CAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,QAAQ;CACtC,aAAa,EAAE,OAAO;EACpB,YAAY,EAAE,QAAQ,CAAC,QAAQ,gCAAgC;EAC/D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,SAAS;EACpC,eAAe,EAAE,QAAQ,CAAC,QAAQ,gBAAgB;EAClD,OAAO,EAAE,QAAQ,CAAC,QAAQ,QAAQ;EACnC,CAAC;CACF,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC9C,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC7C,CAAC;;;;AAKF,eAAsB,oBACpB,IACA,KAC0B;CAC1B,MAAM,aAAa,GAAG,KAAK,OAAO,KAAK,oBAAoB;AAG3D,KAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;AAGT,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAC7C,MAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,SAAO,aAAa,MAAM,OAAO;SAC3B;AACN,SAAO;;;;;;AAOX,SAAgB,qBACd,QACA,SAOiB;AACjB,QAAO;EACL,GAAG;EACH,YACG,QAAQ,YACR,QAAQ,IACP,+BAEF,OAAO;EACT,SACE,QAAQ,SAAS,QAAQ,IAAI,4BAA4B,OAAO;EAClE,WACG,QAAQ,aACR,QAAQ,IACP,8BAEF,OAAO;EACT,gBACE,QAAQ,YACR,QAAQ,IAAI,gCACZ,OAAO,kBACP;EACF,cACE,QAAQ,IAAI,+BACZ,OAAO,gBACP;EACF,WAAW,QAAQ,aAAa,OAAO;EACxC;;;;;AAMH,SAAgB,UACd,UACoB;AACpB,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH;EACF,QACE"}

package/dist/services/deps.d.ts

@@ -0,0 +1,53 @@
+import { FsAdapter } from "../ports/fs.js";
+import { ContractGraph, ContractNode } from "@contractspec/module.workspace";
+
+//#region src/services/deps.d.ts
+
+/**
+ * Options for dependency analysis.
+ */
+interface AnalyzeDepsOptions {
+  /**
+   * File pattern to search.
+   */
+  pattern?: string;
+}
+/**
+ * Result of dependency analysis.
+ */
+interface AnalyzeDepsResult {
+  graph: ContractGraph;
+  total: number;
+  cycles: string[][];
+  missing: {
+    contract: string;
+    missing: string[];
+  }[];
+}
+/**
+ * Analyze contract dependencies.
+ */
+declare function analyzeDeps(adapters: {
+  fs: FsAdapter;
+}, options?: AnalyzeDepsOptions): Promise<AnalyzeDepsResult>;
+/**
+ * Get contract node by name.
+ */
+declare function getContractNode(graph: ContractGraph, name: string): ContractNode | undefined;
+/**
+ * Export graph as DOT format.
+ */
+declare function exportGraphAsDot(graph: ContractGraph): string;
+/**
+ * Get graph statistics.
+ */
+declare function getGraphStats(graph: ContractGraph): {
+  total: number;
+  withDeps: number;
+  withoutDeps: number;
+  used: number;
+  unused: number;
+};
+//#endregion
+export { AnalyzeDepsOptions, AnalyzeDepsResult, analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats };
+//# sourceMappingURL=deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","names":[],"sources":["../../src/services/deps.ts"],"sourcesContent":[],"mappings":";;;;;AA8BA;AAUA;;AAEW,UAtBM,kBAAA,CAsBN;EACA;;;EA4CK,OAAA,CAAA,EAAA,MAAA;AAUhB;AAOA;;;UA1EiB,iBAAA;SACR;;;;;;;;;;;iBASa,WAAA;MACJ;aACP,qBACR,QAAQ;;;;iBA4CK,eAAA,QACP,8BAEN;;;;iBAOa,gBAAA,QAAwB;;;;iBAOxB,aAAA,QAAqB"}

package/dist/services/deps.js

@@ -0,0 +1,62 @@
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, parseImportedSpecNames, toDot } from "@contractspec/module.workspace";
+
+//#region src/services/deps.ts
+/**
+* Dependency analysis service.
+*/
+/**
+* Analyze contract dependencies.
+*/
+async function analyzeDeps(adapters, options = {}) {
+	const { fs } = adapters;
+	const files = await fs.glob({ pattern: options.pattern });
+	const graph = createContractGraph();
+	for (const file of files) {
+		const content = await fs.readFile(file);
+		const relativePath = fs.relative(".", file);
+		const nameMatch = content.match(/name:\s*['"]([^'"]+)['"]/);
+		addContractNode(graph, (nameMatch?.[1] ? nameMatch[1] : fs.basename(file).replace(/\.[jt]s$/, "").replace(/\.(contracts|contract|operation|operations|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/, "")) || "unknown", relativePath, parseImportedSpecNames(content, file));
+	}
+	buildReverseEdges(graph);
+	const cycles = detectCycles(graph);
+	const missing = findMissingDependencies(graph);
+	return {
+		graph,
+		total: graph.size,
+		cycles,
+		missing
+	};
+}
+/**
+* Get contract node by name.
+*/
+function getContractNode(graph, name) {
+	return graph.get(name);
+}
+/**
+* Export graph as DOT format.
+*/
+function exportGraphAsDot(graph) {
+	return toDot(graph);
+}
+/**
+* Get graph statistics.
+*/
+function getGraphStats(graph) {
+	const all = Array.from(graph.values());
+	const withDeps = all.filter((c) => c.dependencies.length > 0);
+	const withoutDeps = all.filter((c) => c.dependencies.length === 0);
+	const used = all.filter((c) => c.dependents.length > 0);
+	const unused = all.filter((c) => c.dependents.length === 0);
+	return {
+		total: graph.size,
+		withDeps: withDeps.length,
+		withoutDeps: withoutDeps.length,
+		used: used.length,
+		unused: unused.length
+	};
+}
+
+//#endregion
+export { analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats };
+//# sourceMappingURL=deps.js.map

package/dist/services/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","names":[],"sources":["../../src/services/deps.ts"],"sourcesContent":["/**\n * Dependency analysis service.\n */\n\nimport {\n  addContractNode,\n  buildReverseEdges,\n  type ContractGraph,\n  type ContractNode,\n  createContractGraph,\n  detectCycles,\n  findMissingDependencies,\n  parseImportedSpecNames,\n  toDot,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\n/**\n * Options for dependency analysis.\n */\nexport interface AnalyzeDepsOptions {\n  /**\n   * File pattern to search.\n   */\n  pattern?: string;\n}\n\n/**\n * Result of dependency analysis.\n */\nexport interface AnalyzeDepsResult {\n  graph: ContractGraph;\n  total: number;\n  cycles: string[][];\n  missing: { contract: string; missing: string[] }[];\n}\n\n/**\n * Analyze contract dependencies.\n */\nexport async function analyzeDeps(\n  adapters: { fs: FsAdapter },\n  options: AnalyzeDepsOptions = {}\n): Promise<AnalyzeDepsResult> {\n  const { fs } = adapters;\n\n  const files = await fs.glob({ pattern: options.pattern });\n  const graph = createContractGraph();\n\n  for (const file of files) {\n    const content = await fs.readFile(file);\n    const relativePath = fs.relative('.', file);\n\n    // Prefer explicit meta.name if present; otherwise fall back to filename stem\n    const nameMatch = content.match(/name:\\s*['\"]([^'\"]+)['\"]/);\n    const inferredName = nameMatch?.[1]\n      ? nameMatch[1]\n      : fs\n          .basename(file)\n          .replace(/\\.[jt]s$/, '')\n          .replace(\n            /\\.(contracts|contract|operation|operations|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,\n            ''\n          );\n\n    const finalName = inferredName || 'unknown';\n    const dependencies = parseImportedSpecNames(content, file);\n\n    addContractNode(graph, finalName, relativePath, dependencies);\n  }\n\n  buildReverseEdges(graph);\n\n  const cycles = detectCycles(graph);\n  const missing = findMissingDependencies(graph);\n\n  return {\n    graph,\n    total: graph.size,\n    cycles,\n    missing,\n  };\n}\n\n/**\n * Get contract node by name.\n */\nexport function getContractNode(\n  graph: ContractGraph,\n  name: string\n): ContractNode | undefined {\n  return graph.get(name);\n}\n\n/**\n * Export graph as DOT format.\n */\nexport function exportGraphAsDot(graph: ContractGraph): string {\n  return toDot(graph);\n}\n\n/**\n * Get graph statistics.\n */\nexport function getGraphStats(graph: ContractGraph): {\n  total: number;\n  withDeps: number;\n  withoutDeps: number;\n  used: number;\n  unused: number;\n} {\n  const all = Array.from(graph.values());\n  const withDeps = all.filter((c) => c.dependencies.length > 0);\n  const withoutDeps = all.filter((c) => c.dependencies.length === 0);\n  const used = all.filter((c) => c.dependents.length > 0);\n  const unused = all.filter((c) => c.dependents.length === 0);\n\n  return {\n    total: graph.size,\n    withDeps: withDeps.length,\n    withoutDeps: withoutDeps.length,\n    used: used.length,\n    unused: unused.length,\n  };\n}\n"],"mappings":";;;;;;;;;AAwCA,eAAsB,YACpB,UACA,UAA8B,EAAE,EACJ;CAC5B,MAAM,EAAE,OAAO;CAEf,MAAM,QAAQ,MAAM,GAAG,KAAK,EAAE,SAAS,QAAQ,SAAS,CAAC;CACzD,MAAM,QAAQ,qBAAqB;AAEnC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;EACvC,MAAM,eAAe,GAAG,SAAS,KAAK,KAAK;EAG3C,MAAM,YAAY,QAAQ,MAAM,2BAA2B;AAc3D,kBAAgB,QAbK,YAAY,KAC7B,UAAU,KACV,GACG,SAAS,KAAK,CACd,QAAQ,YAAY,GAAG,CACvB,QACC,sJACA,GACD,KAE2B,WAGA,cAFb,uBAAuB,SAAS,KAAK,CAEG;;AAG/D,mBAAkB,MAAM;CAExB,MAAM,SAAS,aAAa,MAAM;CAClC,MAAM,UAAU,wBAAwB,MAAM;AAE9C,QAAO;EACL;EACA,OAAO,MAAM;EACb;EACA;EACD;;;;;AAMH,SAAgB,gBACd,OACA,MAC0B;AAC1B,QAAO,MAAM,IAAI,KAAK;;;;;AAMxB,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,MAAM,MAAM;;;;;AAMrB,SAAgB,cAAc,OAM5B;CACA,MAAM,MAAM,MAAM,KAAK,MAAM,QAAQ,CAAC;CACtC,MAAM,WAAW,IAAI,QAAQ,MAAM,EAAE,aAAa,SAAS,EAAE;CAC7D,MAAM,cAAc,IAAI,QAAQ,MAAM,EAAE,aAAa,WAAW,EAAE;CAClE,MAAM,OAAO,IAAI,QAAQ,MAAM,EAAE,WAAW,SAAS,EAAE;CACvD,MAAM,SAAS,IAAI,QAAQ,MAAM,EAAE,WAAW,WAAW,EAAE;AAE3D,QAAO;EACL,OAAO,MAAM;EACb,UAAU,SAAS;EACnB,aAAa,YAAY;EACzB,MAAM,KAAK;EACX,QAAQ,OAAO;EAChB"}