@contractspec/bundle.workspace 1.46.2 → 1.48.0

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

@@ -0,0 +1,147 @@
+import { ContractsrcConfig } from "@contractspec/lib.contracts/workspace-config";
+
+//#region src/services/ci-check/types.d.ts
+
+/**
+ * Categories of CI checks.
+ */
+type CICheckCategory = 'structure' | 'integrity' | 'deps' | 'doctor' | 'handlers' | 'tests' | 'test-refs' | 'coverage' | 'implementation' | 'layers' | 'drift';
+/**
+ * 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;
+  /** Include drift detection checks. */
+  checkDrift?: 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;
+  };
+  /**
+   * Workspace configuration
+   */
+  config?: ContractsrcConfig;
+}
+/**
+ * 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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/ci-check/types.ts"],"sourcesContent":[],"mappings":";;;;AA6DA;AAKA;;AAQY,KA/DA,eAAA,GA+DA,WAAA,GAAA,WAAA,GAAA,MAAA,GAAA,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,WAAA,GAAA,UAAA,GAAA,gBAAA,GAAA,QAAA,GAAA,OAAA;;;AAkBZ;AAoBiB,cArFJ,uBAiGC,EAjGwB,eAiGxB,EAAA;AAcd;;;AA+BW,cA7HE,wBA6HF,EA7H4B,MA6H5B,CA7HmC,eA6HnC,EAAA,MAAA,CAAA;;AAMX;AAKA;KAvHY,eAAA;;;;UAKK,OAAA;;;;YAIL;;;;YAIA;;;;;;;;;;;;YAYA;;;;;UAMK,sBAAA;;YAEL;;;;;;;;;;;;;;;;;UAkBK,aAAA;;;;;;;;;;UAUP;;cAEI;;;;;;;;;;;;;UAcG,cAAA;;;;WAIN;;SAEF;;;;;;;;;;;;;;;;;;;;;;;;;WAyBE;;;;;KAMC,cAAA;;;;UAKK,eAAA;;UAEP"}

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

@@ -0,0 +1,37 @@
+//#region src/services/ci-check/types.ts
+/**
+* All available CI check categories.
+*/
+const ALL_CI_CHECK_CATEGORIES = [
+	"structure",
+	"integrity",
+	"deps",
+	"doctor",
+	"handlers",
+	"tests",
+	"test-refs",
+	"coverage",
+	"implementation",
+	"layers",
+	"drift"
+];
+/**
+* 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",
+	"test-refs": "Test Reference Validation",
+	coverage: "Coverage Goal Enforcement",
+	implementation: "Implementation Verification",
+	layers: "Contract Layers Validation",
+	drift: "Drift Detection"
+};
+
+//#endregion
+export { ALL_CI_CHECK_CATEGORIES, CI_CHECK_CATEGORY_LABELS };
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"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\nimport type { ContractsrcConfig } from '@contractspec/lib.contracts/workspace-config';\n\n/**\n * Categories of CI checks.\n */\nexport type CICheckCategory =\n  | 'structure'\n  | 'integrity'\n  | 'deps'\n  | 'doctor'\n  | 'handlers'\n  | 'tests'\n  | 'test-refs'\n  | 'coverage'\n  | 'implementation'\n  | 'layers'\n  | 'drift';\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  'test-refs',\n  'coverage',\n  'implementation',\n  'layers',\n  'drift',\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  'test-refs': 'Test Reference Validation',\n  coverage: 'Coverage Goal Enforcement',\n  implementation: 'Implementation Verification',\n  layers: 'Contract Layers Validation',\n  drift: 'Drift Detection',\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  /** Include drift detection checks. */\n  checkDrift?: 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   * Workspace configuration\n   */\n  config?: ContractsrcConfig;\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":";;;;AA2BA,MAAa,0BAA6C;CACxD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAa,2BAA4D;CACvE,WAAW;CACX,WAAW;CACX,MAAM;CACN,QAAQ;CACR,UAAU;CACV,OAAO;CACP,aAAa;CACb,UAAU;CACV,gBAAgB;CAChB,QAAQ;CACR,OAAO;CACR"}

package/dist/services/ci-check/utils.mjs

@@ -0,0 +1,76 @@
+//#region src/services/ci-check/utils.ts
+/**
+* Create a category summary from issues.
+*/
+function createCategorySummary(category, issues, durationMs) {
+	const categoryLabels = {
+		structure: "Spec Structure Validation",
+		integrity: "Contract Integrity Analysis",
+		deps: "Dependency Analysis",
+		doctor: "Installation Health",
+		handlers: "Handler Implementation",
+		tests: "Test Coverage",
+		"test-refs": "Test Reference Validation",
+		coverage: "Coverage Verification",
+		implementation: "Implementation Verification",
+		layers: "Contract Layers Validation",
+		drift: "Drift Detection"
+	};
+	const errors = issues.filter((i) => i.severity === "error").length;
+	const warnings = issues.filter((i) => i.severity === "warning").length;
+	const notes = issues.filter((i) => i.severity === "note").length;
+	return {
+		category,
+		label: categoryLabels[category],
+		errors,
+		warnings,
+		notes,
+		passed: errors === 0,
+		durationMs
+	};
+}
+/**
+* Get git information if available.
+*/
+async function getGitInfo(fs) {
+	try {
+		const gitHeadPath = ".git/HEAD";
+		if (!await fs.exists(gitHeadPath)) return {};
+		const headContent = await fs.readFile(gitHeadPath);
+		const refMatch = headContent.match(/^ref: (.+)$/m);
+		if (refMatch) {
+			const branch = refMatch[1]?.replace("refs/heads/", "");
+			const refPath = `.git/${refMatch[1]}`;
+			if (await fs.exists(refPath)) return {
+				commitSha: (await fs.readFile(refPath)).trim(),
+				branch
+			};
+			return { branch };
+		}
+		return { commitSha: headContent.trim() };
+	} catch {
+		return {};
+	}
+}
+/**
+* Determine which checks to run based on options.
+*/
+function getChecksToRun(options) {
+	const allCategories = [
+		"structure",
+		"integrity",
+		"deps",
+		"doctor"
+	];
+	if (options.checkHandlers) allCategories.push("handlers");
+	if (options.checkTests) allCategories.push("tests");
+	if (options.implementation) allCategories.push("implementation");
+	if (options.checkDrift) allCategories.push("drift");
+	if (options.checks && options.checks.length > 0) return options.checks;
+	if (options.skip && options.skip.length > 0) return allCategories.filter((c) => !options.skip?.includes(c));
+	return allCategories;
+}
+
+//#endregion
+export { createCategorySummary, getChecksToRun, getGitInfo };
+//# sourceMappingURL=utils.mjs.map

package/dist/services/ci-check/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../src/services/ci-check/utils.ts"],"sourcesContent":["/**\n * CI check utilities.\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { CICheckCategory, CICheckCategorySummary, CIIssue } from './types';\n\n/**\n * Create a category summary from issues.\n */\nexport function 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    'test-refs': 'Test Reference Validation',\n    coverage: 'Coverage Verification',\n    implementation: 'Implementation Verification',\n    layers: 'Contract Layers Validation',\n    drift: 'Drift Detection',\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 */\nexport async 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\n/**\n * Determine which checks to run based on options.\n */\nexport function getChecksToRun(options: {\n  checkHandlers?: boolean;\n  checkTests?: boolean;\n  implementation?: unknown;\n  checkDrift?: boolean;\n  checks?: CICheckCategory[];\n  skip?: CICheckCategory[];\n}): 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  if (options.checkDrift) {\n    allCategories.push('drift');\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"],"mappings":";;;;AAUA,SAAgB,sBACd,UACA,QACA,YACwB;CACxB,MAAM,iBAAkD;EACtD,WAAW;EACX,WAAW;EACX,MAAM;EACN,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aAAa;EACb,UAAU;EACV,gBAAgB;EAChB,QAAQ;EACR,OAAO;EACR;CAED,MAAM,SAAS,OAAO,QAAQ,MAAM,EAAE,aAAa,QAAQ,CAAC;CAC5D,MAAM,WAAW,OAAO,QAAQ,MAAM,EAAE,aAAa,UAAU,CAAC;CAChE,MAAM,QAAQ,OAAO,QAAQ,MAAM,EAAE,aAAa,OAAO,CAAC;AAE1D,QAAO;EACL;EACA,OAAO,eAAe;EACtB;EACA;EACA;EACA,QAAQ,WAAW;EACnB;EACD;;;;;AAMH,eAAsB,WACpB,IACkD;AAClD,KAAI;EAEF,MAAM,cAAc;AACpB,MAAI,CAAE,MAAM,GAAG,OAAO,YAAY,CAChC,QAAO,EAAE;EAGX,MAAM,cAAc,MAAM,GAAG,SAAS,YAAY;EAClD,MAAM,WAAW,YAAY,MAAM,eAAe;AAElD,MAAI,UAAU;GACZ,MAAM,SAAS,SAAS,IAAI,QAAQ,eAAe,GAAG;GACtD,MAAM,UAAU,QAAQ,SAAS;AAEjC,OAAI,MAAM,GAAG,OAAO,QAAQ,CAE1B,QAAO;IAAE,YADU,MAAM,GAAG,SAAS,QAAQ,EAAE,MAAM;IACjC;IAAQ;AAG9B,UAAO,EAAE,QAAQ;;AAKnB,SAAO,EAAE,WADS,YAAY,MAAM,EAChB;SACd;AACN,SAAO,EAAE;;;;;;AAOb,SAAgB,eAAe,SAOT;CACpB,MAAM,gBAAmC;EACvC;EACA;EACA;EACA;EACD;AAGD,KAAI,QAAQ,cACV,eAAc,KAAK,WAAW;AAEhC,KAAI,QAAQ,WACV,eAAc,KAAK,QAAQ;AAE7B,KAAI,QAAQ,eACV,eAAc,KAAK,iBAAiB;AAEtC,KAAI,QAAQ,WACV,eAAc,KAAK,QAAQ;AAI7B,KAAI,QAAQ,UAAU,QAAQ,OAAO,SAAS,EAC5C,QAAO,QAAQ;AAIjB,KAAI,QAAQ,QAAQ,QAAQ,KAAK,SAAS,EACxC,QAAO,cAAc,QAAQ,MAAM,CAAC,QAAQ,MAAM,SAAS,EAAE,CAAC;AAGhE,QAAO"}

package/dist/services/clean.d.mts

@@ -0,0 +1,41 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { LoggerAdapter } from "../ports/logger.mjs";
+
+//#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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.mts","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.mjs

@@ -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.mjs.map

package/dist/services/clean.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.mjs","names":[],"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,MAAM,UAA4C,EAAE;CACpD,MAAM,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.mts

@@ -0,0 +1,16 @@
+import { FsAdapter } from "../ports/fs.mjs";
+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>;
+/**
+ * Get API key for the configured provider.
+ */
+declare function getApiKey(provider: WorkspaceConfig['aiProvider']): string | undefined;
+//#endregion
+export { getApiKey, loadWorkspaceConfig };
+//# sourceMappingURL=config.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","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;;;iBAAgB,SAAA,WACJ"}

package/dist/services/config.mjs

@@ -0,0 +1,63 @@
+import { DEFAULT_WORKSPACE_CONFIG } from "@contractspec/module.workspace";
+import * as z$1 from "zod";
+
+//#region src/services/config.ts
+/**
+* Workspace configuration service.
+*/
+const ConfigSchema = z$1.object({
+	aiProvider: z$1.enum([
+		"claude",
+		"openai",
+		"ollama",
+		"custom"
+	]).default("claude"),
+	aiModel: z$1.string().optional(),
+	agentMode: z$1.enum([
+		"simple",
+		"cursor",
+		"claude-code",
+		"openai-codex"
+	]).default("simple"),
+	customEndpoint: z$1.url().nullable().optional(),
+	customApiKey: z$1.string().nullable().optional(),
+	outputDir: z$1.string().default("./src"),
+	conventions: z$1.object({
+		operations: z$1.string().default("interactions/commands|queries"),
+		events: z$1.string().default("events"),
+		presentations: z$1.string().default("presentations"),
+		forms: z$1.string().default("forms")
+	}),
+	defaultOwners: z$1.array(z$1.string()).default([]),
+	defaultTags: z$1.array(z$1.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;
+	}
+}
+/**
+* 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 };
+//# sourceMappingURL=config.mjs.map

package/dist/services/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["z"],"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.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 * 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,eAAeA,IAAE,OAAO;CAC5B,YAAYA,IACT,KAAK;EAAC;EAAU;EAAU;EAAU;EAAS,CAAC,CAC9C,QAAQ,SAAS;CACpB,SAASA,IAAE,QAAQ,CAAC,UAAU;CAC9B,WAAWA,IACR,KAAK;EAAC;EAAU;EAAU;EAAe;EAAe,CAAC,CACzD,QAAQ,SAAS;CACpB,gBAAgBA,IAAE,KAAK,CAAC,UAAU,CAAC,UAAU;CAC7C,cAAcA,IAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;CAC9C,WAAWA,IAAE,QAAQ,CAAC,QAAQ,QAAQ;CACtC,aAAaA,IAAE,OAAO;EACpB,YAAYA,IAAE,QAAQ,CAAC,QAAQ,gCAAgC;EAC/D,QAAQA,IAAE,QAAQ,CAAC,QAAQ,SAAS;EACpC,eAAeA,IAAE,QAAQ,CAAC,QAAQ,gBAAgB;EAClD,OAAOA,IAAE,QAAQ,CAAC,QAAQ,QAAQ;EACnC,CAAC;CACF,eAAeA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC9C,aAAaA,IAAE,MAAMA,IAAE,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,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/coverage/parsers/index.mjs

@@ -0,0 +1,34 @@
+import { parseIstanbulCoverage } from "./istanbul-parser.mjs";
+
+//#region src/services/coverage/parsers/index.ts
+/**
+* Create a parser for the specified format.
+*
+* @param format - The coverage report format
+* @returns A parser for the format
+*/
+function createParser(format) {
+	switch (format) {
+		case "istanbul": return { parse: parseIstanbulCoverage };
+		case "lcov": throw new Error("LCOV format not yet supported");
+		case "cobertura": throw new Error("Cobertura format not yet supported");
+		default: throw new Error(`Unknown coverage format: ${format}`);
+	}
+}
+/**
+* Detect the coverage format from a file path or content.
+*
+* @param path - The file path
+* @param content - Optional file content
+* @returns The detected format
+*/
+function detectFormat(path, content) {
+	if (path.endsWith(".json") || path.includes("coverage-final.json")) return "istanbul";
+	if (path.endsWith(".lcov") || path.includes("lcov.info")) return "lcov";
+	if (path.endsWith(".xml") && content?.includes("cobertura")) return "cobertura";
+	return "istanbul";
+}
+
+//#endregion
+export { createParser, detectFormat };
+//# sourceMappingURL=index.mjs.map

package/dist/services/coverage/parsers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/coverage/parsers/index.ts"],"sourcesContent":["/**\n * Coverage report parsers.\n *\n * Parses coverage reports from various test runners into a unified format.\n */\n\nimport type { CoverageReport } from '../types';\nimport { parseIstanbulCoverage } from './istanbul-parser';\n\n/**\n * Supported coverage report formats.\n */\nexport type CoverageFormat = 'istanbul' | 'lcov' | 'cobertura';\n\n/**\n * Parser interface for coverage reports.\n */\nexport interface CoverageParser {\n  /**\n   * Parse a coverage report file or directory.\n   *\n   * @param content - The file content or directory path\n   * @returns Parsed coverage report\n   */\n  parse(content: string): CoverageReport;\n}\n\n/**\n * Create a parser for the specified format.\n *\n * @param format - The coverage report format\n * @returns A parser for the format\n */\nexport function createParser(format: CoverageFormat): CoverageParser {\n  switch (format) {\n    case 'istanbul':\n      return { parse: parseIstanbulCoverage };\n    case 'lcov':\n      // LCOV support can be added later\n      throw new Error('LCOV format not yet supported');\n    case 'cobertura':\n      // Cobertura support can be added later\n      throw new Error('Cobertura format not yet supported');\n    default:\n      throw new Error(`Unknown coverage format: ${format}`);\n  }\n}\n\n/**\n * Detect the coverage format from a file path or content.\n *\n * @param path - The file path\n * @param content - Optional file content\n * @returns The detected format\n */\nexport function detectFormat(path: string, content?: string): CoverageFormat {\n  // Check file extension first\n  if (path.endsWith('.json') || path.includes('coverage-final.json')) {\n    return 'istanbul';\n  }\n  if (path.endsWith('.lcov') || path.includes('lcov.info')) {\n    return 'lcov';\n  }\n  if (path.endsWith('.xml') && content?.includes('cobertura')) {\n    return 'cobertura';\n  }\n\n  // Default to Istanbul JSON\n  return 'istanbul';\n}\n\nexport { parseIstanbulCoverage } from './istanbul-parser';\n"],"mappings":";;;;;;;;;AAiCA,SAAgB,aAAa,QAAwC;AACnE,SAAQ,QAAR;EACE,KAAK,WACH,QAAO,EAAE,OAAO,uBAAuB;EACzC,KAAK,OAEH,OAAM,IAAI,MAAM,gCAAgC;EAClD,KAAK,YAEH,OAAM,IAAI,MAAM,qCAAqC;EACvD,QACE,OAAM,IAAI,MAAM,4BAA4B,SAAS;;;;;;;;;;AAW3D,SAAgB,aAAa,MAAc,SAAkC;AAE3E,KAAI,KAAK,SAAS,QAAQ,IAAI,KAAK,SAAS,sBAAsB,CAChE,QAAO;AAET,KAAI,KAAK,SAAS,QAAQ,IAAI,KAAK,SAAS,YAAY,CACtD,QAAO;AAET,KAAI,KAAK,SAAS,OAAO,IAAI,SAAS,SAAS,YAAY,CACzD,QAAO;AAIT,QAAO"}

package/dist/services/coverage/parsers/istanbul-parser.mjs

@@ -0,0 +1,108 @@
+//#region src/services/coverage/parsers/istanbul-parser.ts
+function calculatePct(covered, total) {
+	if (total === 0) return 100;
+	return Math.round(covered / total * 100 * 100) / 100;
+}
+/**
+* Parse Istanbul JSON coverage report.
+*
+* @param content - The JSON content as a string
+* @returns Parsed coverage report
+*/
+function parseIstanbulCoverage(content) {
+	const data = JSON.parse(content);
+	const files = /* @__PURE__ */ new Map();
+	let totalStatements = 0;
+	let coveredStatements = 0;
+	let totalBranches = 0;
+	let coveredBranches = 0;
+	let totalFunctions = 0;
+	let coveredFunctions = 0;
+	let totalLines = 0;
+	let coveredLines = 0;
+	for (const [filePath, fileCoverage] of Object.entries(data)) {
+		const parsed = parseFileCoverage(filePath, fileCoverage);
+		files.set(filePath, parsed);
+		totalStatements += parsed.statements.total;
+		coveredStatements += parsed.statements.covered;
+		totalBranches += parsed.branches.total;
+		coveredBranches += parsed.branches.covered;
+		totalFunctions += parsed.functions.total;
+		coveredFunctions += parsed.functions.covered;
+		totalLines += parsed.lines.total;
+		coveredLines += parsed.lines.covered;
+	}
+	return {
+		files,
+		total: {
+			statements: {
+				covered: coveredStatements,
+				total: totalStatements,
+				pct: calculatePct(coveredStatements, totalStatements)
+			},
+			branches: {
+				covered: coveredBranches,
+				total: totalBranches,
+				pct: calculatePct(coveredBranches, totalBranches)
+			},
+			functions: {
+				covered: coveredFunctions,
+				total: totalFunctions,
+				pct: calculatePct(coveredFunctions, totalFunctions)
+			},
+			lines: {
+				covered: coveredLines,
+				total: totalLines,
+				pct: calculatePct(coveredLines, totalLines)
+			}
+		}
+	};
+}
+/**
+* Parse coverage data for a single file.
+*/
+function parseFileCoverage(path, coverage) {
+	const statementTotal = Object.keys(coverage.statementMap).length;
+	const statementCovered = Object.values(coverage.s).filter((c) => c > 0).length;
+	const functionTotal = Object.keys(coverage.fnMap).length;
+	const functionCovered = Object.values(coverage.f).filter((c) => c > 0).length;
+	let branchTotal = 0;
+	let branchCovered = 0;
+	for (const branch of Object.values(coverage.b)) {
+		branchTotal += branch.length;
+		branchCovered += branch.filter((c) => c > 0).length;
+	}
+	const lineSet = /* @__PURE__ */ new Set();
+	const coveredLineSet = /* @__PURE__ */ new Set();
+	for (const [id, location] of Object.entries(coverage.statementMap)) for (let line = location.start.line; line <= location.end.line; line++) {
+		lineSet.add(line);
+		if ((coverage.s[id] ?? 0) > 0) coveredLineSet.add(line);
+	}
+	return {
+		path,
+		statements: {
+			covered: statementCovered,
+			total: statementTotal,
+			pct: calculatePct(statementCovered, statementTotal)
+		},
+		branches: {
+			covered: branchCovered,
+			total: branchTotal,
+			pct: calculatePct(branchCovered, branchTotal)
+		},
+		functions: {
+			covered: functionCovered,
+			total: functionTotal,
+			pct: calculatePct(functionCovered, functionTotal)
+		},
+		lines: {
+			covered: coveredLineSet.size,
+			total: lineSet.size,
+			pct: calculatePct(coveredLineSet.size, lineSet.size)
+		}
+	};
+}
+
+//#endregion
+export { parseIstanbulCoverage };
+//# sourceMappingURL=istanbul-parser.mjs.map