@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

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

@@ -1,393 +0,0 @@
-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,2 +0,0 @@
-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,28 +0,0 @@
-//#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,71 +0,0 @@
-//#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,76 +0,0 @@
-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,62 +0,0 @@
-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 };

package/dist/services/diff.js

@@ -1,33 +0,0 @@
-import { computeSemanticDiff } from "../modules/contractspec-workspace/dist/analysis/diff/semantic.js";
-
-//#region src/services/diff.ts
-/**
-* Diff service.
-*/
-/**
-* Compare two spec files semantically.
-*/
-async function compareSpecs(spec1Path, spec2Path, adapters, options = {}) {
-	const { fs, git } = adapters;
-	if (!await fs.exists(spec1Path)) throw new Error(`Spec file not found: ${spec1Path}`);
-	const spec1Code = await fs.readFile(spec1Path);
-	let spec2Code;
-	let spec2Label;
-	if (options.baseline) {
-		spec2Code = await git.showFile(options.baseline, spec1Path);
-		spec2Label = `${options.baseline}:${spec1Path}`;
-	} else {
-		if (!await fs.exists(spec2Path)) throw new Error(`Spec file not found: ${spec2Path}`);
-		spec2Code = await fs.readFile(spec2Path);
-		spec2Label = spec2Path;
-	}
-	const differences = computeSemanticDiff(spec1Code, spec1Path, spec2Code, spec2Label, { breakingOnly: options.breakingOnly });
-	return {
-		spec1: spec1Path,
-		spec2: spec2Label,
-		differences
-	};
-}
-
-//#endregion
-export { compareSpecs };