@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

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

@@ -1 +1,393 @@
-import{validateImplementationFiles as e}from"../validate-implementation.js";import{analyzeDeps as t}from"../deps.js";import{loadWorkspaceConfig as n}from"../config.js";import{analyzeIntegrity as r}from"../integrity.js";import{runDoctor as i}from"../doctor/doctor-service.js";import{resolveAllImplementations as a}from"../implementation/resolver.js";import"../verification-cache/index.js";import{isFeatureFile as o,validateSpecStructure as s}from"@lssm/module.contractspec-workspace";async function c(e,t={}){let n=Date.now(),{fs:r,logger:i}=e,a=[],s=[],c=l(t);i.info(`Starting CI checks...`,{checks:c});let y=(await r.glob({pattern:t.pattern})).filter(e=>!o(e)&&!e.includes(`.test.`)&&!e.includes(`.spec.`));if(c.includes(`structure`)){let t=Date.now(),n=await u(e,y);a.push(...n),s.push(_(`structure`,n,Date.now()-t))}if(c.includes(`integrity`)){let n=Date.now(),r=await d(e,t);a.push(...r),s.push(_(`integrity`,r,Date.now()-n))}if(c.includes(`deps`)){let n=Date.now(),r=await f(e,t);a.push(...r),s.push(_(`deps`,r,Date.now()-n))}if(c.includes(`doctor`)){let n=Date.now(),r=await p(e,t);a.push(...r),s.push(_(`doctor`,r,Date.now()-n))}if(c.includes(`handlers`)||t.checkHandlers){let t=Date.now(),n=await m(e,y);a.push(...n),s.push(_(`handlers`,n,Date.now()-t))}if(c.includes(`tests`)||t.checkTests){let t=Date.now(),n=await h(e,y);a.push(...n),s.push(_(`tests`,n,Date.now()-t))}if(c.includes(`implementation`)){let n=Date.now(),r=await g(e,y,t);a.push(...r),s.push(_(`implementation`,r,Date.now()-n))}let b=a.filter(e=>e.severity===`error`).length,x=a.filter(e=>e.severity===`warning`).length,S=a.filter(e=>e.severity===`note`).length,C=t.failOnWarnings?b===0&&x===0:b===0,w=await v(r),T={success:C,totalErrors:b,totalWarnings:x,totalNotes:S,issues:a,categories:s,durationMs:Date.now()-n,timestamp:new Date().toISOString(),...w};return i.info(`CI checks complete`,{success:C,errors:b,warnings:x,durationMs:T.durationMs}),T}function l(e){let t=[`structure`,`integrity`,`deps`,`doctor`];return e.checkHandlers&&t.push(`handlers`),e.checkTests&&t.push(`tests`),e.implementation&&t.push(`implementation`),e.checks&&e.checks.length>0?e.checks:e.skip&&e.skip.length>0?t.filter(t=>!e.skip?.includes(t)):t}async function u(e,t){let{fs:n}=e,r=[];for(let e of t){let t=s(await n.readFile(e),n.basename(e));for(let n of t.errors)r.push({ruleId:`spec-structure-error`,severity:`error`,message:n,category:`structure`,file:e});for(let n of t.warnings)r.push({ruleId:`spec-structure-warning`,severity:`warning`,message:n,category:`structure`,file:e})}return r}async function d(e,t){let n=[],i=await r(e,{pattern:t.pattern,all:!0});for(let e of i.issues)n.push({ruleId:`integrity-${e.type}`,severity:e.severity===`error`?`error`:`warning`,message:e.message,category:`integrity`,file:e.file,context:{specName:e.specName,specType:e.specType,featureKey:e.featureKey,ref:e.ref}});return n}async function f(e,n){let r=[],i=await t(e,{pattern:n.pattern});for(let e of i.cycles)r.push({ruleId:`deps-circular`,severity:`error`,message:`Circular dependency detected: ${e.join(` → `)}`,category:`deps`,context:{cycle:e}});for(let e of i.missing)for(let t of e.missing)r.push({ruleId:`deps-missing`,severity:`error`,message:`Missing dependency: ${e.contract} requires ${t}`,category:`deps`,context:{contract:e.contract,missing:t}});return r}async function p(e,t){let n=[],r=await i(e,{workspaceRoot:t.workspaceRoot??process.cwd(),skipAi:!0,categories:[`cli`,`config`,`deps`,`workspace`]});for(let e of r.checks)e.status===`fail`?n.push({ruleId:`doctor-${e.category}-${e.name.toLowerCase().replace(/\s+/g,`-`)}`,severity:`error`,message:`${e.name}: ${e.message}`,category:`doctor`,context:{details:e.details}}):e.status===`warn`&&n.push({ruleId:`doctor-${e.category}-${e.name.toLowerCase().replace(/\s+/g,`-`)}`,severity:`warning`,message:`${e.name}: ${e.message}`,category:`doctor`,context:{details:e.details}});return n}async function m(t,r){let{fs:i}=t,a=[],o=await n(i);for(let t of r){if(!t.includes(`.contracts.`))continue;let n=await e(t,{fs:i},o,{checkHandlers:!0,outputDir:o.outputDir});for(let e of n.errors)a.push({ruleId:`handler-missing`,severity:`warning`,message:e,category:`handlers`,file:t});for(let e of n.warnings)a.push({ruleId:`handler-warning`,severity:`warning`,message:e,category:`handlers`,file:t})}return a}async function h(t,r){let{fs:i}=t,a=[],o=await n(i);for(let t of r){if(!t.includes(`.contracts.`))continue;let n=await e(t,{fs:i},o,{checkTests:!0,outputDir:o.outputDir});for(let e of n.errors)a.push({ruleId:`test-missing`,severity:`warning`,message:e,category:`tests`,file:t});for(let e of n.warnings)a.push({ruleId:`test-warning`,severity:`warning`,message:e,category:`tests`,file:t})}return a}async function g(e,t,r){let{fs:i}=e,o=[],s=await n(i),c=r.implementation??{},l=await a(t.filter(e=>e.includes(`.contracts.`)),{fs:i},s,{computeHashes:c.useCache??!0});for(let e of l){if(c.requireImplemented&&e.status===`missing`?o.push({ruleId:`impl-missing`,severity:`error`,message:`Spec ${e.specName} has no implementation`,category:`implementation`,file:e.specPath,context:{specName:e.specName,specVersion:e.specVersion,status:e.status}}):e.status===`missing`&&o.push({ruleId:`impl-missing`,severity:`warning`,message:`Spec ${e.specName} has no implementation`,category:`implementation`,file:e.specPath,context:{specName:e.specName,specVersion:e.specVersion,status:e.status}}),!c.allowPartial&&e.status===`partial`){let t=e.implementations.filter(e=>!e.exists&&e.type!==`test`).map(e=>e.path);o.push({ruleId:`impl-partial`,severity:`warning`,message:`Spec ${e.specName} has partial implementation: missing ${t.join(`, `)}`,category:`implementation`,file:e.specPath,context:{specName:e.specName,specVersion:e.specVersion,status:e.status,missingFiles:t}})}let t=e.implementations.filter(e=>!e.exists&&e.type===`test`);t.length>0&&o.push({ruleId:`impl-missing-tests`,severity:`note`,message:`Spec ${e.specName} missing test files: ${t.map(e=>e.path).join(`, `)}`,category:`implementation`,file:e.specPath,context:{specName:e.specName,missingTests:t.map(e=>e.path)}})}return o}function _(e,t,n){let r={structure:`Spec Structure Validation`,integrity:`Contract Integrity Analysis`,deps:`Dependency Analysis`,doctor:`Installation Health`,handlers:`Handler Implementation`,tests:`Test Coverage`,implementation:`Implementation Verification`},i=t.filter(e=>e.severity===`error`).length,a=t.filter(e=>e.severity===`warning`).length,o=t.filter(e=>e.severity===`note`).length;return{category:e,label:r[e],errors:i,warnings:a,notes:o,passed:i===0,durationMs:n}}async function v(e){try{let t=`.git/HEAD`;if(!await e.exists(t))return{};let n=await e.readFile(t),r=n.match(/^ref: (.+)$/m);if(r){let t=r[1]?.replace(`refs/heads/`,``),n=`.git/${r[1]}`;return await e.exists(n)?{commitSha:(await e.readFile(n)).trim(),branch:t}:{branch:t}}return{commitSha:n.trim()}}catch{return{}}}export{c as runCIChecks};
+import { isFeatureFile } from "../../modules/contractspec-workspace/dist/analysis/feature-scan.js";
+import { validateSpecStructure } from "../../modules/contractspec-workspace/dist/analysis/validate/spec-structure.js";
+import { validateImplementationFiles } from "../validate-implementation.js";
+import { analyzeDeps } from "../deps.js";
+import { loadWorkspaceConfig } from "../config.js";
+import { analyzeIntegrity } from "../integrity.js";
+import { runDoctor } from "../doctor/doctor-service.js";
+import { resolveAllImplementations } from "../implementation/resolver.js";
+import "../verification-cache/index.js";
+
+//#region src/services/ci-check/ci-check-service.ts
+/**
+* CI Check service.
+*
+* Orchestrates all validation checks for CI/CD pipelines.
+* Returns structured results suitable for multiple output formats.
+*/
+/**
+* Run all CI checks and return structured results.
+*/
+async function runCIChecks(adapters, options = {}) {
+	const startTime = Date.now();
+	const { fs, logger } = adapters;
+	const issues = [];
+	const categorySummaries = [];
+	const checksToRun = getChecksToRun(options);
+	logger.info("Starting CI checks...", { checks: checksToRun });
+	const specFiles = (await fs.glob({ pattern: options.pattern })).filter((f) => !isFeatureFile(f) && !f.includes(".test.") && !f.includes(".spec."));
+	if (checksToRun.includes("structure")) {
+		const categoryStart = Date.now();
+		const structureIssues = await runStructureChecks(adapters, specFiles);
+		issues.push(...structureIssues);
+		categorySummaries.push(createCategorySummary("structure", structureIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("integrity")) {
+		const categoryStart = Date.now();
+		const integrityIssues = await runIntegrityChecks(adapters, options);
+		issues.push(...integrityIssues);
+		categorySummaries.push(createCategorySummary("integrity", integrityIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("deps")) {
+		const categoryStart = Date.now();
+		const depsIssues = await runDepsChecks(adapters, options);
+		issues.push(...depsIssues);
+		categorySummaries.push(createCategorySummary("deps", depsIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("doctor")) {
+		const categoryStart = Date.now();
+		const doctorIssues = await runDoctorChecks(adapters, options);
+		issues.push(...doctorIssues);
+		categorySummaries.push(createCategorySummary("doctor", doctorIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("handlers") || options.checkHandlers) {
+		const categoryStart = Date.now();
+		const handlerIssues = await runHandlerChecks(adapters, specFiles);
+		issues.push(...handlerIssues);
+		categorySummaries.push(createCategorySummary("handlers", handlerIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("tests") || options.checkTests) {
+		const categoryStart = Date.now();
+		const testIssues = await runTestChecks(adapters, specFiles);
+		issues.push(...testIssues);
+		categorySummaries.push(createCategorySummary("tests", testIssues, Date.now() - categoryStart));
+	}
+	if (checksToRun.includes("implementation")) {
+		const categoryStart = Date.now();
+		const implIssues = await runImplementationChecks(adapters, specFiles, options);
+		issues.push(...implIssues);
+		categorySummaries.push(createCategorySummary("implementation", implIssues, Date.now() - categoryStart));
+	}
+	const totalErrors = issues.filter((i) => i.severity === "error").length;
+	const totalWarnings = issues.filter((i) => i.severity === "warning").length;
+	const totalNotes = issues.filter((i) => i.severity === "note").length;
+	const success = options.failOnWarnings ? totalErrors === 0 && totalWarnings === 0 : totalErrors === 0;
+	const gitInfo = await getGitInfo(fs);
+	const result = {
+		success,
+		totalErrors,
+		totalWarnings,
+		totalNotes,
+		issues,
+		categories: categorySummaries,
+		durationMs: Date.now() - startTime,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		...gitInfo
+	};
+	logger.info("CI checks complete", {
+		success,
+		errors: totalErrors,
+		warnings: totalWarnings,
+		durationMs: result.durationMs
+	});
+	return result;
+}
+/**
+* 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.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;
+}
+/**
+* Run spec structure validation checks.
+*/
+async function runStructureChecks(adapters, specFiles) {
+	const { fs } = adapters;
+	const issues = [];
+	for (const file of specFiles) {
+		const result = validateSpecStructure(await fs.readFile(file), fs.basename(file));
+		for (const error of result.errors) issues.push({
+			ruleId: "spec-structure-error",
+			severity: "error",
+			message: error,
+			category: "structure",
+			file
+		});
+		for (const warning of result.warnings) issues.push({
+			ruleId: "spec-structure-warning",
+			severity: "warning",
+			message: warning,
+			category: "structure",
+			file
+		});
+	}
+	return issues;
+}
+/**
+* Run integrity analysis checks.
+*/
+async function runIntegrityChecks(adapters, options) {
+	const issues = [];
+	const result = await analyzeIntegrity(adapters, {
+		pattern: options.pattern,
+		all: true
+	});
+	for (const issue of result.issues) issues.push({
+		ruleId: `integrity-${issue.type}`,
+		severity: issue.severity === "error" ? "error" : "warning",
+		message: issue.message,
+		category: "integrity",
+		file: issue.file,
+		context: {
+			specName: issue.specName,
+			specType: issue.specType,
+			featureKey: issue.featureKey,
+			ref: issue.ref
+		}
+	});
+	return issues;
+}
+/**
+* Run dependency analysis checks.
+*/
+async function runDepsChecks(adapters, options) {
+	const issues = [];
+	const result = await analyzeDeps(adapters, { pattern: options.pattern });
+	for (const cycle of result.cycles) issues.push({
+		ruleId: "deps-circular",
+		severity: "error",
+		message: `Circular dependency detected: ${cycle.join(" → ")}`,
+		category: "deps",
+		context: { cycle }
+	});
+	for (const item of result.missing) for (const missing of item.missing) issues.push({
+		ruleId: "deps-missing",
+		severity: "error",
+		message: `Missing dependency: ${item.contract} requires ${missing}`,
+		category: "deps",
+		context: {
+			contract: item.contract,
+			missing
+		}
+	});
+	return issues;
+}
+/**
+* Run doctor checks (skipping AI in CI).
+*/
+async function runDoctorChecks(adapters, options) {
+	const issues = [];
+	const result = await runDoctor(adapters, {
+		workspaceRoot: options.workspaceRoot ?? process.cwd(),
+		skipAi: true,
+		categories: [
+			"cli",
+			"config",
+			"deps",
+			"workspace"
+		]
+	});
+	for (const check of result.checks) if (check.status === "fail") issues.push({
+		ruleId: `doctor-${check.category}-${check.name.toLowerCase().replace(/\s+/g, "-")}`,
+		severity: "error",
+		message: `${check.name}: ${check.message}`,
+		category: "doctor",
+		context: { details: check.details }
+	});
+	else if (check.status === "warn") issues.push({
+		ruleId: `doctor-${check.category}-${check.name.toLowerCase().replace(/\s+/g, "-")}`,
+		severity: "warning",
+		message: `${check.name}: ${check.message}`,
+		category: "doctor",
+		context: { details: check.details }
+	});
+	return issues;
+}
+/**
+* Run handler implementation checks.
+*/
+async function runHandlerChecks(adapters, specFiles) {
+	const { fs } = adapters;
+	const issues = [];
+	const config = await loadWorkspaceConfig(fs);
+	for (const specFile of specFiles) {
+		if (!specFile.includes(".contracts.")) continue;
+		const result = await validateImplementationFiles(specFile, { fs }, config, {
+			checkHandlers: true,
+			outputDir: config.outputDir
+		});
+		for (const error of result.errors) issues.push({
+			ruleId: "handler-missing",
+			severity: "warning",
+			message: error,
+			category: "handlers",
+			file: specFile
+		});
+		for (const warning of result.warnings) issues.push({
+			ruleId: "handler-warning",
+			severity: "warning",
+			message: warning,
+			category: "handlers",
+			file: specFile
+		});
+	}
+	return issues;
+}
+/**
+* Run test coverage checks.
+*/
+async function runTestChecks(adapters, specFiles) {
+	const { fs } = adapters;
+	const issues = [];
+	const config = await loadWorkspaceConfig(fs);
+	for (const specFile of specFiles) {
+		if (!specFile.includes(".contracts.")) continue;
+		const result = await validateImplementationFiles(specFile, { fs }, config, {
+			checkTests: true,
+			outputDir: config.outputDir
+		});
+		for (const error of result.errors) issues.push({
+			ruleId: "test-missing",
+			severity: "warning",
+			message: error,
+			category: "tests",
+			file: specFile
+		});
+		for (const warning of result.warnings) issues.push({
+			ruleId: "test-warning",
+			severity: "warning",
+			message: warning,
+			category: "tests",
+			file: specFile
+		});
+	}
+	return issues;
+}
+/**
+* Run implementation verification checks.
+*/
+async function runImplementationChecks(adapters, specFiles, options) {
+	const { fs } = adapters;
+	const issues = [];
+	const config = await loadWorkspaceConfig(fs);
+	const implOptions = options.implementation ?? {};
+	const results = await resolveAllImplementations(specFiles.filter((f) => f.includes(".contracts.")), { fs }, config, { computeHashes: implOptions.useCache ?? true });
+	for (const result of results) {
+		if (implOptions.requireImplemented && result.status === "missing") issues.push({
+			ruleId: "impl-missing",
+			severity: "error",
+			message: `Spec ${result.specName} has no implementation`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specName: result.specName,
+				specVersion: result.specVersion,
+				status: result.status
+			}
+		});
+		else if (result.status === "missing") issues.push({
+			ruleId: "impl-missing",
+			severity: "warning",
+			message: `Spec ${result.specName} has no implementation`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specName: result.specName,
+				specVersion: result.specVersion,
+				status: result.status
+			}
+		});
+		if (!implOptions.allowPartial && result.status === "partial") {
+			const missingImpls = result.implementations.filter((i) => !i.exists && i.type !== "test").map((i) => i.path);
+			issues.push({
+				ruleId: "impl-partial",
+				severity: "warning",
+				message: `Spec ${result.specName} has partial implementation: missing ${missingImpls.join(", ")}`,
+				category: "implementation",
+				file: result.specPath,
+				context: {
+					specName: result.specName,
+					specVersion: result.specVersion,
+					status: result.status,
+					missingFiles: missingImpls
+				}
+			});
+		}
+		const missingTests = result.implementations.filter((i) => !i.exists && i.type === "test");
+		if (missingTests.length > 0) issues.push({
+			ruleId: "impl-missing-tests",
+			severity: "note",
+			message: `Spec ${result.specName} missing test files: ${missingTests.map((t) => t.path).join(", ")}`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specName: result.specName,
+				missingTests: missingTests.map((t) => t.path)
+			}
+		});
+	}
+	return issues;
+}
+/**
+* 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",
+		implementation: "Implementation Verification"
+	};
+	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 {};
+	}
+}
+
+//#endregion
+export { runCIChecks };

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

@@ -1 +1,2 @@
-import{ALL_CI_CHECK_CATEGORIES as e,CI_CHECK_CATEGORY_LABELS as t}from"./types.js";import{runCIChecks as n}from"./ci-check-service.js";
+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.js

@@ -1 +1,28 @@
-const e=[`structure`,`integrity`,`deps`,`doctor`,`handlers`,`tests`,`implementation`],t={structure:`Spec Structure Validation`,integrity:`Contract Integrity Analysis`,deps:`Dependency Analysis`,doctor:`Installation Health`,handlers:`Handler Implementation`,tests:`Test Coverage`,implementation:`Implementation Verification`};export{e as ALL_CI_CHECK_CATEGORIES,t as CI_CHECK_CATEGORY_LABELS};
+//#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 };

package/dist/services/clean.js

@@ -1 +1,71 @@
-async function e(e,t={}){let{fs:n,logger:r}=e,i=(t.outputDir??`./src`).replace(/\\/g,`/`),a=[`generated/**`,`dist/**`,`.turbo/**`],o=[`${i}/handlers/**/*.handler.ts`,`${i}/handlers/**/*.handler.test.ts`,`${i}/components/**/*.tsx`,`${i}/components/**/*.test.tsx`,`${i}/forms/**/*.form.tsx`,`${i}/forms/**/*.form.test.tsx`,`${i}/**/*.runner.ts`,`${i}/**/*.renderer.tsx`],s=t.generatedOnly?[...a,...o]:[...a,`**/*.generated.ts`,`**/*.generated.js`,`**/*.generated.d.ts`,...o],c=await n.glob({patterns:s,ignore:[`node_modules/**`]}),l=[],u=[];for(let e of c)try{let i=await n.stat(e),a=(Date.now()-i.mtime.getTime())/(1e3*60*60*24);if(typeof t.olderThanDays==`number`&&a<t.olderThanDays){u.push({path:e,reason:`younger_than_${t.olderThanDays}_days`});continue}t.dryRun?r.info(`[dry-run] clean would remove`,{path:e,size:i.size}):(await n.remove(e),r.info(`clean.removed`,{path:e,size:i.size})),l.push({path:e,size:i.size})}catch(t){u.push({path:e,reason:t instanceof Error?t.message:String(t)})}return{removed:l,skipped:u}}export{e as cleanArtifacts};
+//#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 };

package/dist/services/config.js

@@ -1 +1,76 @@
-import{DEFAULT_WORKSPACE_CONFIG as e}from"@lssm/module.contractspec-workspace";import*as t from"zod";const n=t.object({aiProvider:t.enum([`claude`,`openai`,`ollama`,`custom`]).default(`claude`),aiModel:t.string().optional(),agentMode:t.enum([`simple`,`cursor`,`claude-code`,`openai-codex`]).default(`simple`),customEndpoint:t.string().url().nullable().optional(),customApiKey:t.string().nullable().optional(),outputDir:t.string().default(`./src`),conventions:t.object({operations:t.string().default(`interactions/commands|queries`),events:t.string().default(`events`),presentations:t.string().default(`presentations`),forms:t.string().default(`forms`)}),defaultOwners:t.array(t.string()).default([]),defaultTags:t.array(t.string()).default([])});async function r(t,r){let i=t.join(r??`.`,`.contractsrc.json`);if(!await t.exists(i))return e;try{let e=await t.readFile(i),r=JSON.parse(e);return n.parse(r)}catch{return e}}function i(e,t){return{...e,aiProvider:t.provider??process.env.CONTRACTSPEC_AI_PROVIDER??e.aiProvider,aiModel:t.model??process.env.CONTRACTSPEC_AI_MODEL??e.aiModel,agentMode:t.agentMode??process.env.CONTRACTSPEC_AGENT_MODE??e.agentMode,customEndpoint:t.endpoint??process.env.CONTRACTSPEC_LLM_ENDPOINT??e.customEndpoint??void 0,customApiKey:process.env.CONTRACTSPEC_LLM_API_KEY??e.customApiKey??void 0,outputDir:t.outputDir??e.outputDir}}function a(e){switch(e){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}}export{a as getApiKey,r as loadWorkspaceConfig,i as mergeWorkspaceConfig};
+import { DEFAULT_WORKSPACE_CONFIG } from "../modules/contractspec-workspace/dist/types/generation-types.js";
+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.string().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;
+	}
+}
+/**
+* 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 };

package/dist/services/deps.js

@@ -1 +1,62 @@
-import{addContractNode as e,buildReverseEdges as t,createContractGraph as n,detectCycles as r,findMissingDependencies as i,parseImportedSpecNames as a,toDot as o}from"@lssm/module.contractspec-workspace";async function s(o,s={}){let{fs:c}=o,l=await c.glob({pattern:s.pattern}),u=n();for(let t of l){let n=await c.readFile(t),r=c.relative(`.`,t),i=n.match(/name:\s*['"]([^'"]+)['"]/);e(u,(i?.[1]?i[1]:c.basename(t).replace(/\.[jt]s$/,``).replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,``))||`unknown`,r,a(n,t))}t(u);let d=r(u),f=i(u);return{graph:u,total:u.size,cycles:d,missing:f}}function c(e,t){return e.get(t)}function l(e){return o(e)}function u(e){let t=Array.from(e.values()),n=t.filter(e=>e.dependencies.length>0),r=t.filter(e=>e.dependencies.length===0),i=t.filter(e=>e.dependents.length>0),a=t.filter(e=>e.dependents.length===0);return{total:e.size,withDeps:n.length,withoutDeps:r.length,used:i.length,unused:a.length}}export{s as analyzeDeps,l as exportGraphAsDot,c as getContractNode,u as getGraphStats};
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot } from "../modules/contractspec-workspace/dist/analysis/deps/graph.js";
+import { parseImportedSpecNames } from "../modules/contractspec-workspace/dist/analysis/deps/parse-imports.js";
+
+//#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|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 };