@lssm/bundle.contractspec-workspace 1.41.1 → 1.42.2

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

@@ -1 +1,392 @@
-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 { 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 { isFeatureFile, validateSpecStructure } from "@lssm/module.contractspec-workspace";
+
+//#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), 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: {
+			specKey: issue.specKey,
+			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(".operation.")) 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(".operation.")) 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(".operation.")), { 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.specKey} has no implementation`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specKey: result.specKey,
+				specVersion: result.specVersion,
+				status: result.status
+			}
+		});
+		else if (result.status === "missing") issues.push({
+			ruleId: "impl-missing",
+			severity: "warning",
+			message: `Spec ${result.specKey} has no implementation`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specKey: result.specKey,
+				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.specKey} has partial implementation: missing ${missingImpls.join(", ")}`,
+				category: "implementation",
+				file: result.specPath,
+				context: {
+					specKey: result.specKey,
+					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.specKey} missing test files: ${missingTests.map((t) => t.path).join(", ")}`,
+			category: "implementation",
+			file: result.specPath,
+			context: {
+				specKey: result.specKey,
+				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 };
+//# sourceMappingURL=ci-check-service.js.map

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

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

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

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

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

@@ -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.d.ts

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

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

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

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

@@ -1 +1,29 @@
-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 };
+//# sourceMappingURL=types.js.map

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

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