@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/ai/providers.mjs

@@ -0,0 +1,39 @@
+import { getAIProvider, getRecommendedModels, validateLegacyProvider } from "@contractspec/lib.ai-providers";
+
+//#region src/ai/providers.ts
+/**
+* Initialize AI provider based on configuration
+*
+* @deprecated Use createProvider() from @contractspec/lib.ai-providers instead
+*/
+function getAIProvider$1(config) {
+	return getAIProvider({
+		aiProvider: config.aiProvider,
+		aiModel: config.aiModel || void 0,
+		customEndpoint: config.customEndpoint || void 0
+	});
+}
+/**
+* Validate that the provider is accessible and working
+*
+* @deprecated Use validateProvider() from @contractspec/lib.ai-providers instead
+*/
+async function validateProvider(config) {
+	return await validateLegacyProvider({
+		aiProvider: config.aiProvider,
+		aiModel: config.aiModel || void 0,
+		customEndpoint: config.customEndpoint || void 0
+	});
+}
+/**
+* Get recommended models for each provider
+*
+* @deprecated Use getModelsForProvider() from @contractspec/lib.ai-providers instead
+*/
+function getRecommendedModels$1(provider) {
+	return getRecommendedModels(provider);
+}
+
+//#endregion
+export { getAIProvider$1 as getAIProvider, getRecommendedModels$1 as getRecommendedModels, validateProvider };
+//# sourceMappingURL=providers.mjs.map

package/dist/ai/providers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.mjs","names":["getAIProvider","getProviderFromLib","validateProviderFromLib","getRecommendedModels","getModelsFromLib"],"sources":["../../src/ai/providers.ts"],"sourcesContent":["/**\n * AI Provider utilities for ContractSpec workspace.\n *\n * Re-exports from @contractspec/lib.ai-providers with workspace-specific additions.\n */\nimport type { LanguageModel } from 'ai';\nimport {\n  getAIProvider as getProviderFromLib,\n  validateLegacyProvider as validateProviderFromLib,\n  getRecommendedModels as getModelsFromLib,\n  type LegacyConfig,\n} from '@contractspec/lib.ai-providers';\nimport type { Config } from '../types/config';\n\n/**\n * Initialize AI provider based on configuration\n *\n * @deprecated Use createProvider() from @contractspec/lib.ai-providers instead\n */\nexport function getAIProvider(config: Config): LanguageModel {\n  const legacyConfig: LegacyConfig = {\n    aiProvider: config.aiProvider,\n    aiModel: config.aiModel || undefined,\n    customEndpoint: config.customEndpoint || undefined,\n  };\n  return getProviderFromLib(legacyConfig);\n}\n\n/**\n * Validate that the provider is accessible and working\n *\n * @deprecated Use validateProvider() from @contractspec/lib.ai-providers instead\n */\nexport async function validateProvider(\n  config: Config\n): Promise<{ success: boolean; error?: string }> {\n  const legacyConfig: LegacyConfig = {\n    aiProvider: config.aiProvider,\n    aiModel: config.aiModel || undefined,\n    customEndpoint: config.customEndpoint || undefined,\n  };\n  const result = await validateProviderFromLib(legacyConfig);\n  return result;\n}\n\n/**\n * Get recommended models for each provider\n *\n * @deprecated Use getModelsForProvider() from @contractspec/lib.ai-providers instead\n */\nexport function getRecommendedModels(provider: Config['aiProvider']): string[] {\n  return getModelsFromLib(provider);\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgBA,gBAAc,QAA+B;AAM3D,QAAOC,cAL4B;EACjC,YAAY,OAAO;EACnB,SAAS,OAAO,WAAW;EAC3B,gBAAgB,OAAO,kBAAkB;EAC1C,CACsC;;;;;;;AAQzC,eAAsB,iBACpB,QAC+C;AAO/C,QADe,MAAMC,uBALc;EACjC,YAAY,OAAO;EACnB,SAAS,OAAO,WAAW;EAC3B,gBAAgB,OAAO,kBAAkB;EAC1C,CACyD;;;;;;;AAS5D,SAAgBC,uBAAqB,UAA0C;AAC7E,QAAOC,qBAAiB,SAAS"}

package/dist/formatters/index.d.mts

@@ -0,0 +1,11 @@
+import { SarifFormatOptions, SarifOutput, formatAsSarif, sarifToJson } from "./sarif.mjs";
+import { BaseJsonOutput, CiCheckJson, CiJsonOutput, JsonFormatOptions, formatAsJson } from "./json.mjs";
+import { TextFormatOptions, TextLine, formatAsText, formatAsTextLines } from "./text.mjs";
+
+//#region src/formatters/index.d.ts
+declare namespace index_d_exports {
+  export { BaseJsonOutput, CiCheckJson, CiJsonOutput, JsonFormatOptions, SarifFormatOptions, SarifOutput, TextFormatOptions, TextLine, formatAsJson, formatAsSarif, formatAsText, formatAsTextLines, sarifToJson };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.mts.map

package/dist/formatters/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/formatters/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/formatters/index.mjs

@@ -0,0 +1,17 @@
+import { __exportAll } from "../_virtual/rolldown_runtime.mjs";
+import { formatAsSarif, sarifToJson } from "./sarif.mjs";
+import { formatAsJson } from "./json.mjs";
+import { formatAsText, formatAsTextLines } from "./text.mjs";
+
+//#region src/formatters/index.ts
+var formatters_exports = /* @__PURE__ */ __exportAll({
+	formatAsJson: () => formatAsJson,
+	formatAsSarif: () => formatAsSarif,
+	formatAsText: () => formatAsText,
+	formatAsTextLines: () => formatAsTextLines,
+	sarifToJson: () => sarifToJson
+});
+
+//#endregion
+export { formatters_exports };
+//# sourceMappingURL=index.mjs.map

package/dist/formatters/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/formatters/index.ts"],"sourcesContent":["/**\n * Output formatters for CI check results.\n */\n\nexport * from './sarif';\nexport * from './json';\nexport * from './text';\n"],"mappings":""}

package/dist/formatters/json.d.mts

@@ -0,0 +1,56 @@
+import { CICheckResult } from "../services/ci-check/types.mjs";
+
+//#region src/formatters/json.d.ts
+
+/**
+ * Base interface for all standardized JSON outputs.
+ */
+interface BaseJsonOutput {
+  /** Schema version for output stability (e.g., "1.0"). */
+  schemaVersion: string;
+}
+/**
+ * Options for JSON formatting.
+ */
+interface JsonFormatOptions {
+  /** Pretty print with indentation. */
+  pretty?: boolean;
+}
+/**
+ * CI JSON output structure (v1.0).
+ */
+interface CiJsonOutput extends BaseJsonOutput {
+  checks: CiCheckJson[];
+  drift: {
+    status: 'none' | 'detected';
+    files: string[];
+  };
+  summary: {
+    pass: number;
+    fail: number;
+    warn: number;
+    total: number;
+    durationMs: number;
+    timestamp: string;
+  };
+  details?: {
+    commit?: string;
+    branch?: string;
+  };
+}
+interface CiCheckJson {
+  name: string;
+  status: 'pass' | 'fail' | 'warn';
+  category: string;
+  message: string;
+  file?: string;
+  line?: number;
+  details?: Record<string, unknown>;
+}
+/**
+ * Format CI check results as standard JSON (v1.0).
+ */
+declare function formatAsJson(result: CICheckResult, options?: JsonFormatOptions): string;
+//#endregion
+export { BaseJsonOutput, CiCheckJson, CiJsonOutput, JsonFormatOptions, formatAsJson };
+//# sourceMappingURL=json.d.mts.map

package/dist/formatters/json.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.mts","names":[],"sources":["../../src/formatters/json.ts"],"sourcesContent":[],"mappings":";;;;AA6DA;;;UAjDiB,cAAA;;;;;;;UAQA,iBAAA;;;;;;;UAQA,YAAA,SAAqB;UAC5B;;;;;;;;;;;;;;;;;;UAmBO,WAAA;;;;;;;YAOL;;;;;iBAMI,YAAA,SACN,yBACC"}

package/dist/formatters/json.mjs

@@ -0,0 +1,43 @@
+//#region src/formatters/json.ts
+/**
+* Format CI check results as standard JSON (v1.0).
+*/
+function formatAsJson(result, options = {}) {
+	const { pretty = true } = options;
+	const checks = result.issues.map((issue) => ({
+		name: issue.ruleId,
+		status: issue.severity === "error" ? "fail" : issue.severity === "warning" ? "warn" : "pass",
+		category: issue.category,
+		message: issue.message,
+		file: issue.file,
+		line: issue.line,
+		details: issue.context
+	}));
+	const fail = result.totalErrors;
+	const warn = result.totalWarnings;
+	const output = {
+		schemaVersion: "1.0",
+		checks,
+		drift: {
+			status: "none",
+			files: []
+		},
+		summary: {
+			pass: 0,
+			fail,
+			warn,
+			total: fail + warn,
+			durationMs: result.durationMs,
+			timestamp: result.timestamp
+		},
+		details: {
+			commit: result.commitSha,
+			branch: result.branch
+		}
+	};
+	return pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);
+}
+
+//#endregion
+export { formatAsJson };
+//# sourceMappingURL=json.mjs.map

package/dist/formatters/json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.mjs","names":[],"sources":["../../src/formatters/json.ts"],"sourcesContent":["/**\n * JSON output formatter.\n *\n * Formats CI check results as machine-readable JSON\n * for parsing in CI/CD scripts and integrations.\n */\n\nimport type { CICheckResult } from '../services/ci-check/types';\n\n/**\n * Base interface for all standardized JSON outputs.\n */\nexport interface BaseJsonOutput {\n  /** Schema version for output stability (e.g., \"1.0\"). */\n  schemaVersion: string;\n}\n\n/**\n * Options for JSON formatting.\n */\nexport interface JsonFormatOptions {\n  /** Pretty print with indentation. */\n  pretty?: boolean;\n}\n\n/**\n * CI JSON output structure (v1.0).\n */\nexport interface CiJsonOutput extends BaseJsonOutput {\n  checks: CiCheckJson[];\n  drift: {\n    status: 'none' | 'detected';\n    files: string[];\n  };\n  summary: {\n    pass: number;\n    fail: number;\n    warn: number;\n    total: number;\n    durationMs: number;\n    timestamp: string;\n  };\n  details?: {\n    commit?: string;\n    branch?: string;\n  };\n}\n\nexport interface CiCheckJson {\n  name: string;\n  status: 'pass' | 'fail' | 'warn';\n  category: string;\n  message: string;\n  file?: string;\n  line?: number;\n  details?: Record<string, unknown>;\n}\n\n/**\n * Format CI check results as standard JSON (v1.0).\n */\nexport function formatAsJson(\n  result: CICheckResult,\n  options: JsonFormatOptions = {}\n): string {\n  const { pretty = true } = options;\n\n  // Map issues to checks\n  const checks: CiCheckJson[] = result.issues.map((issue) => ({\n    name: issue.ruleId,\n    status:\n      issue.severity === 'error'\n        ? 'fail'\n        : issue.severity === 'warning'\n          ? 'warn'\n          : 'pass',\n    category: issue.category,\n    message: issue.message,\n    file: issue.file,\n    line: issue.line,\n    details: issue.context as Record<string, unknown>,\n  }));\n\n  // Add passing categories as passing checks (summary level) if needed\n  // Or purely rely on issues. The previous implementation had categories.\n  // For v1.0 schema, we focus on list of checks.\n\n  // Count stats\n  const fail = result.totalErrors;\n  const warn = result.totalWarnings;\n  // Note: \"pass\" count is harder to derive solely from issues (which are usually negative).\n  // But we can use category results to infer passing checks if we had granular per-check results.\n  // For now, we'll use the issues list. If issues is empty, it's all pass?\n  // Actually, let's map the categories too if they represent high-level checks.\n\n  const output: CiJsonOutput = {\n    schemaVersion: '1.0',\n    checks,\n    drift: {\n      status: 'none', // TODO: Implement drift detection\n      files: [],\n    },\n    summary: {\n      pass: 0, // Placeholder, calculated properly if we have tracking of passed assertions\n      fail,\n      warn,\n      total: fail + warn,\n      durationMs: result.durationMs,\n      timestamp: result.timestamp,\n    },\n    details: {\n      commit: result.commitSha,\n      branch: result.branch,\n    },\n  };\n\n  return pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);\n}\n"],"mappings":";;;;AA6DA,SAAgB,aACd,QACA,UAA6B,EAAE,EACvB;CACR,MAAM,EAAE,SAAS,SAAS;CAG1B,MAAM,SAAwB,OAAO,OAAO,KAAK,WAAW;EAC1D,MAAM,MAAM;EACZ,QACE,MAAM,aAAa,UACf,SACA,MAAM,aAAa,YACjB,SACA;EACR,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,MAAM,MAAM;EACZ,MAAM,MAAM;EACZ,SAAS,MAAM;EAChB,EAAE;CAOH,MAAM,OAAO,OAAO;CACpB,MAAM,OAAO,OAAO;CAMpB,MAAM,SAAuB;EAC3B,eAAe;EACf;EACA,OAAO;GACL,QAAQ;GACR,OAAO,EAAE;GACV;EACD,SAAS;GACP,MAAM;GACN;GACA;GACA,OAAO,OAAO;GACd,YAAY,OAAO;GACnB,WAAW,OAAO;GACnB;EACD,SAAS;GACP,QAAQ,OAAO;GACf,QAAQ,OAAO;GAChB;EACF;AAED,QAAO,SAAS,KAAK,UAAU,QAAQ,MAAM,EAAE,GAAG,KAAK,UAAU,OAAO"}

package/dist/formatters/sarif.d.mts

@@ -0,0 +1,101 @@
+import { CICheckResult } from "../services/ci-check/types.mjs";
+
+//#region src/formatters/sarif.d.ts
+
+/**
+ * SARIF v2.1.0 output structure.
+ */
+interface SarifOutput {
+  $schema: string;
+  version: string;
+  runs: SarifRun[];
+}
+interface SarifRun {
+  tool: {
+    driver: {
+      name: string;
+      version: string;
+      informationUri: string;
+      rules: SarifRule[];
+    };
+  };
+  results: SarifResult[];
+  invocations: SarifInvocation[];
+  versionControlProvenance?: SarifVersionControl[];
+}
+interface SarifRule {
+  id: string;
+  name: string;
+  shortDescription: {
+    text: string;
+  };
+  fullDescription?: {
+    text: string;
+  };
+  defaultConfiguration: {
+    level: 'error' | 'warning' | 'note' | 'none';
+  };
+  helpUri?: string;
+}
+interface SarifResult {
+  ruleId: string;
+  ruleIndex: number;
+  level: 'error' | 'warning' | 'note' | 'none';
+  message: {
+    text: string;
+  };
+  locations?: SarifLocation[];
+  partialFingerprints?: Record<string, string>;
+}
+interface SarifLocation {
+  physicalLocation: {
+    artifactLocation: {
+      uri: string;
+      uriBaseId?: string;
+    };
+    region?: {
+      startLine?: number;
+      startColumn?: number;
+      endLine?: number;
+      endColumn?: number;
+    };
+  };
+}
+interface SarifInvocation {
+  executionSuccessful: boolean;
+  endTimeUtc: string;
+  workingDirectory?: {
+    uri: string;
+  };
+}
+interface SarifVersionControl {
+  repositoryUri?: string;
+  revisionId?: string;
+  branch?: string;
+}
+/**
+ * Options for SARIF formatting.
+ */
+interface SarifFormatOptions {
+  /** Tool name. */
+  toolName?: string;
+  /** Tool version. */
+  toolVersion?: string;
+  /** Tool information URI. */
+  toolUri?: string;
+  /** Repository URI for version control provenance. */
+  repositoryUri?: string;
+  /** Working directory. */
+  workingDirectory?: string;
+}
+/**
+ * Format CI check results as SARIF.
+ */
+declare function formatAsSarif(result: CICheckResult, options?: SarifFormatOptions): SarifOutput;
+/**
+ * Serialize SARIF output to JSON string.
+ */
+declare function sarifToJson(sarif: SarifOutput): string;
+//#endregion
+export { SarifFormatOptions, SarifOutput, formatAsSarif, sarifToJson };
+//# sourceMappingURL=sarif.d.mts.map

package/dist/formatters/sarif.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.mts","names":[],"sources":["../../src/formatters/sarif.ts"],"sourcesContent":[],"mappings":";;;;;AAmCgD;AAG7B;AAoBT,UAxCO,WAAA,CAwCM;EAeb,OAAA,EAAA,MAAA;EAMA,OAAA,EAAA,MAAA;EASO,IAAA,EAnET,QAmES,EAAA;AA0EjB;UA1IU,QAAA,CA2IA;EACC,IAAA,EAAA;IACR,MAAA,EAAA;MAAW,IAAA,EAAA,MAAA;MAgKE,OAAW,EAAA,MAAA;;aAvSd;;;WAGF;eACI;6BACc;;UAGnB,SAAA;;;;;;;;;;;;;;UAWA,WAAA;;;;;;;cAKI;wBACU;;UAGd,aAAA;;;;;;;;;;;;;;UAeA,eAAA;;;;;;;UAMA,mBAAA;;;;;;;;UASO,kBAAA;;;;;;;;;;;;;;;iBA0ED,aAAA,SACN,yBACC,qBACR;;;;iBAgKa,WAAA,QAAmB"}

package/dist/formatters/sarif.mjs

@@ -0,0 +1,163 @@
+//#region src/formatters/sarif.ts
+/**
+* Map of rule IDs to their metadata.
+*/
+const RULE_METADATA = {
+	"spec-structure-error": {
+		name: "Spec Structure Error",
+		description: "Contract specification is missing required structure elements"
+	},
+	"spec-structure-warning": {
+		name: "Spec Structure Warning",
+		description: "Contract specification has recommended but missing elements"
+	},
+	"integrity-orphaned": {
+		name: "Orphaned Spec",
+		description: "Contract specification is not linked to any feature"
+	},
+	"integrity-unresolved-ref": {
+		name: "Unresolved Reference",
+		description: "Contract specification references a non-existent spec"
+	},
+	"integrity-missing-feature": {
+		name: "Missing Feature",
+		description: "Feature referenced by spec does not exist"
+	},
+	"integrity-broken-link": {
+		name: "Broken Link",
+		description: "Link between specs is broken"
+	},
+	"deps-circular": {
+		name: "Circular Dependency",
+		description: "Circular dependency detected between contracts"
+	},
+	"deps-missing": {
+		name: "Missing Dependency",
+		description: "Contract depends on a non-existent contract"
+	},
+	"handler-missing": {
+		name: "Missing Handler",
+		description: "Handler implementation file does not exist for this contract"
+	},
+	"handler-warning": {
+		name: "Handler Warning",
+		description: "Handler implementation has potential issues"
+	},
+	"test-missing": {
+		name: "Missing Test",
+		description: "Test file does not exist for this contract"
+	},
+	"test-warning": {
+		name: "Test Warning",
+		description: "Test implementation has potential issues"
+	}
+};
+/**
+* Format CI check results as SARIF.
+*/
+function formatAsSarif(result, options = {}) {
+	const { toolName = "ContractSpec", toolVersion = "1.0.0", toolUri = "https://contractspec.io", repositoryUri, workingDirectory } = options;
+	const ruleMap = /* @__PURE__ */ new Map();
+	const ruleIndexMap = /* @__PURE__ */ new Map();
+	const issuesWithFiles = result.issues.filter((issue) => issue.file);
+	for (const issue of issuesWithFiles) if (!ruleMap.has(issue.ruleId)) {
+		const metadata = RULE_METADATA[issue.ruleId] ?? {
+			name: issue.ruleId,
+			description: `Rule: ${issue.ruleId}`
+		};
+		const rule = {
+			id: issue.ruleId,
+			name: metadata.name,
+			shortDescription: { text: metadata.description },
+			defaultConfiguration: { level: mapSeverityToLevel(issue.severity) }
+		};
+		if (metadata.helpUri) rule.helpUri = metadata.helpUri;
+		ruleIndexMap.set(issue.ruleId, ruleMap.size);
+		ruleMap.set(issue.ruleId, rule);
+	}
+	const results = issuesWithFiles.map((issue) => {
+		const sarifResult = {
+			ruleId: issue.ruleId,
+			ruleIndex: ruleIndexMap.get(issue.ruleId) ?? 0,
+			level: mapSeverityToLevel(issue.severity),
+			message: { text: issue.message }
+		};
+		const location = { physicalLocation: { artifactLocation: {
+			uri: normalizeUri(issue.file),
+			uriBaseId: "%SRCROOT%"
+		} } };
+		if (issue.line !== void 0) location.physicalLocation.region = {
+			startLine: issue.line,
+			startColumn: issue.column ?? 1,
+			endLine: issue.endLine ?? issue.line,
+			endColumn: issue.endColumn
+		};
+		sarifResult.locations = [location];
+		sarifResult.partialFingerprints = { primaryLocationLineHash: createFingerprint(issue) };
+		return sarifResult;
+	});
+	const versionControlProvenance = [];
+	if (repositoryUri) versionControlProvenance.push({
+		repositoryUri,
+		revisionId: result.commitSha,
+		branch: result.branch
+	});
+	const run = {
+		tool: { driver: {
+			name: toolName,
+			version: toolVersion,
+			informationUri: toolUri,
+			rules: Array.from(ruleMap.values())
+		} },
+		results,
+		invocations: [{
+			executionSuccessful: result.success,
+			endTimeUtc: result.timestamp,
+			...workingDirectory && { workingDirectory: { uri: workingDirectory } }
+		}]
+	};
+	if (versionControlProvenance.length > 0) run.versionControlProvenance = versionControlProvenance;
+	return {
+		$schema: "https://json.schemastore.org/sarif-2.1.0.json",
+		version: "2.1.0",
+		runs: [run]
+	};
+}
+/**
+* Map CI severity to SARIF level.
+*/
+function mapSeverityToLevel(severity) {
+	switch (severity) {
+		case "error": return "error";
+		case "warning": return "warning";
+		case "note": return "note";
+		default: return "warning";
+	}
+}
+/**
+* Normalize file path to SARIF URI format.
+*/
+function normalizeUri(filePath) {
+	return filePath.replace(/^\.\//, "").replace(/\\/g, "/");
+}
+/**
+* Create a fingerprint for issue deduplication.
+*/
+function createFingerprint(issue) {
+	const parts = [
+		issue.ruleId,
+		issue.file ?? "",
+		issue.message
+	];
+	return Buffer.from(parts.join("|")).toString("base64").slice(0, 16);
+}
+/**
+* Serialize SARIF output to JSON string.
+*/
+function sarifToJson(sarif) {
+	return JSON.stringify(sarif, null, 2);
+}
+
+//#endregion
+export { formatAsSarif, sarifToJson };
+//# sourceMappingURL=sarif.mjs.map

package/dist/formatters/sarif.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.mjs","names":[],"sources":["../../src/formatters/sarif.ts"],"sourcesContent":["/**\n * SARIF output formatter.\n *\n * Formats CI check results as SARIF (Static Analysis Results Interchange Format)\n * for integration with GitHub Code Scanning and other security tools.\n *\n * SARIF Specification: https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html\n */\n\nimport type {\n  CICheckResult,\n  CIIssue,\n  CIIssueSeverity,\n} from '../services/ci-check/types';\n\n/**\n * SARIF v2.1.0 output structure.\n */\nexport interface SarifOutput {\n  $schema: string;\n  version: string;\n  runs: SarifRun[];\n}\n\ninterface SarifRun {\n  tool: {\n    driver: {\n      name: string;\n      version: string;\n      informationUri: string;\n      rules: SarifRule[];\n    };\n  };\n  results: SarifResult[];\n  invocations: SarifInvocation[];\n  versionControlProvenance?: SarifVersionControl[];\n}\n\ninterface SarifRule {\n  id: string;\n  name: string;\n  shortDescription: { text: string };\n  fullDescription?: { text: string };\n  defaultConfiguration: {\n    level: 'error' | 'warning' | 'note' | 'none';\n  };\n  helpUri?: string;\n}\n\ninterface SarifResult {\n  ruleId: string;\n  ruleIndex: number;\n  level: 'error' | 'warning' | 'note' | 'none';\n  message: { text: string };\n  locations?: SarifLocation[];\n  partialFingerprints?: Record<string, string>;\n}\n\ninterface SarifLocation {\n  physicalLocation: {\n    artifactLocation: {\n      uri: string;\n      uriBaseId?: string;\n    };\n    region?: {\n      startLine?: number;\n      startColumn?: number;\n      endLine?: number;\n      endColumn?: number;\n    };\n  };\n}\n\ninterface SarifInvocation {\n  executionSuccessful: boolean;\n  endTimeUtc: string;\n  workingDirectory?: { uri: string };\n}\n\ninterface SarifVersionControl {\n  repositoryUri?: string;\n  revisionId?: string;\n  branch?: string;\n}\n\n/**\n * Options for SARIF formatting.\n */\nexport interface SarifFormatOptions {\n  /** Tool name. */\n  toolName?: string;\n  /** Tool version. */\n  toolVersion?: string;\n  /** Tool information URI. */\n  toolUri?: string;\n  /** Repository URI for version control provenance. */\n  repositoryUri?: string;\n  /** Working directory. */\n  workingDirectory?: string;\n}\n\n/**\n * Map of rule IDs to their metadata.\n */\nconst RULE_METADATA: Record<\n  string,\n  { name: string; description: string; helpUri?: string }\n> = {\n  'spec-structure-error': {\n    name: 'Spec Structure Error',\n    description:\n      'Contract specification is missing required structure elements',\n  },\n  'spec-structure-warning': {\n    name: 'Spec Structure Warning',\n    description: 'Contract specification has recommended but missing elements',\n  },\n  'integrity-orphaned': {\n    name: 'Orphaned Spec',\n    description: 'Contract specification is not linked to any feature',\n  },\n  'integrity-unresolved-ref': {\n    name: 'Unresolved Reference',\n    description: 'Contract specification references a non-existent spec',\n  },\n  'integrity-missing-feature': {\n    name: 'Missing Feature',\n    description: 'Feature referenced by spec does not exist',\n  },\n  'integrity-broken-link': {\n    name: 'Broken Link',\n    description: 'Link between specs is broken',\n  },\n  'deps-circular': {\n    name: 'Circular Dependency',\n    description: 'Circular dependency detected between contracts',\n  },\n  'deps-missing': {\n    name: 'Missing Dependency',\n    description: 'Contract depends on a non-existent contract',\n  },\n  'handler-missing': {\n    name: 'Missing Handler',\n    description: 'Handler implementation file does not exist for this contract',\n  },\n  'handler-warning': {\n    name: 'Handler Warning',\n    description: 'Handler implementation has potential issues',\n  },\n  'test-missing': {\n    name: 'Missing Test',\n    description: 'Test file does not exist for this contract',\n  },\n  'test-warning': {\n    name: 'Test Warning',\n    description: 'Test implementation has potential issues',\n  },\n};\n\n/**\n * Format CI check results as SARIF.\n */\nexport function formatAsSarif(\n  result: CICheckResult,\n  options: SarifFormatOptions = {}\n): SarifOutput {\n  const {\n    toolName = 'ContractSpec',\n    toolVersion = '1.0.0',\n    toolUri = 'https://contractspec.io',\n    repositoryUri,\n    workingDirectory,\n  } = options;\n\n  // Collect unique rules from issues (only from issues with files)\n  const ruleMap = new Map<string, SarifRule>();\n  const ruleIndexMap = new Map<string, number>();\n\n  // Only collect rules from issues that have files (these are the ones that will be in results)\n  const issuesWithFiles = result.issues.filter((issue) => issue.file);\n\n  for (const issue of issuesWithFiles) {\n    if (!ruleMap.has(issue.ruleId)) {\n      const metadata = RULE_METADATA[issue.ruleId] ?? {\n        name: issue.ruleId,\n        description: `Rule: ${issue.ruleId}`,\n      };\n\n      const rule: SarifRule = {\n        id: issue.ruleId,\n        name: metadata.name,\n        shortDescription: { text: metadata.description },\n        defaultConfiguration: {\n          level: mapSeverityToLevel(issue.severity),\n        },\n      };\n\n      if (metadata.helpUri) {\n        rule.helpUri = metadata.helpUri;\n      }\n\n      ruleIndexMap.set(issue.ruleId, ruleMap.size);\n      ruleMap.set(issue.ruleId, rule);\n    }\n  }\n\n  // Convert issues to SARIF results (only issues with file locations)\n  // GitHub Code Scanning requires every result to have at least one location\n  const results: SarifResult[] = issuesWithFiles.map((issue) => {\n    const sarifResult: SarifResult = {\n      ruleId: issue.ruleId,\n      ruleIndex: ruleIndexMap.get(issue.ruleId) ?? 0,\n      level: mapSeverityToLevel(issue.severity),\n      message: { text: issue.message },\n    };\n\n    // issue.file is guaranteed to be defined due to the filter above\n    const location: SarifLocation = {\n      physicalLocation: {\n        artifactLocation: {\n          // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n          uri: normalizeUri(issue.file!),\n          uriBaseId: '%SRCROOT%',\n        },\n      },\n    };\n\n    if (issue.line !== undefined) {\n      location.physicalLocation.region = {\n        startLine: issue.line,\n        startColumn: issue.column ?? 1,\n        endLine: issue.endLine ?? issue.line,\n        endColumn: issue.endColumn,\n      };\n    }\n\n    sarifResult.locations = [location];\n\n    // Add fingerprint for deduplication\n    sarifResult.partialFingerprints = {\n      primaryLocationLineHash: createFingerprint(issue),\n    };\n\n    return sarifResult;\n  });\n\n  // Build version control provenance (only if repositoryUri is provided, as it's required by SARIF schema)\n  const versionControlProvenance: SarifVersionControl[] = [];\n  if (repositoryUri) {\n    versionControlProvenance.push({\n      repositoryUri,\n      revisionId: result.commitSha,\n      branch: result.branch,\n    });\n  }\n\n  const run: SarifRun = {\n    tool: {\n      driver: {\n        name: toolName,\n        version: toolVersion,\n        informationUri: toolUri,\n        rules: Array.from(ruleMap.values()),\n      },\n    },\n    results,\n    invocations: [\n      {\n        executionSuccessful: result.success,\n        endTimeUtc: result.timestamp,\n        ...(workingDirectory && {\n          workingDirectory: { uri: workingDirectory },\n        }),\n      },\n    ],\n  };\n\n  if (versionControlProvenance.length > 0) {\n    run.versionControlProvenance = versionControlProvenance;\n  }\n\n  return {\n    $schema: 'https://json.schemastore.org/sarif-2.1.0.json',\n    version: '2.1.0',\n    runs: [run],\n  };\n}\n\n/**\n * Map CI severity to SARIF level.\n */\nfunction mapSeverityToLevel(\n  severity: CIIssueSeverity\n): 'error' | 'warning' | 'note' {\n  switch (severity) {\n    case 'error':\n      return 'error';\n    case 'warning':\n      return 'warning';\n    case 'note':\n      return 'note';\n    default:\n      return 'warning';\n  }\n}\n\n/**\n * Normalize file path to SARIF URI format.\n */\nfunction normalizeUri(filePath: string): string {\n  // Remove leading ./ and normalize path separators\n  return filePath.replace(/^\\.\\//, '').replace(/\\\\/g, '/');\n}\n\n/**\n * Create a fingerprint for issue deduplication.\n */\nfunction createFingerprint(issue: CIIssue): string {\n  const parts = [issue.ruleId, issue.file ?? '', issue.message];\n  return Buffer.from(parts.join('|')).toString('base64').slice(0, 16);\n}\n\n/**\n * Serialize SARIF output to JSON string.\n */\nexport function sarifToJson(sarif: SarifOutput): string {\n  return JSON.stringify(sarif, null, 2);\n}\n"],"mappings":"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"}

package/dist/formatters/text.d.mts

@@ -0,0 +1,35 @@
+import { CICheckResult } from "../services/ci-check/types.mjs";
+
+//#region src/formatters/text.d.ts
+
+/**
+ * Options for text formatting.
+ */
+interface TextFormatOptions {
+  /** Show verbose output with all details. */
+  verbose?: boolean;
+  /** Include timing information. */
+  showTiming?: boolean;
+  /** Group issues by file. */
+  groupByFile?: boolean;
+}
+/**
+ * Text output lines with optional styling hints.
+ */
+interface TextLine {
+  text: string;
+  style?: 'normal' | 'bold' | 'error' | 'warning' | 'success' | 'muted';
+  indent?: number;
+}
+/**
+ * Format CI check results as text lines.
+ * Returns structured lines that can be styled by the CLI.
+ */
+declare function formatAsTextLines(result: CICheckResult, options?: TextFormatOptions): TextLine[];
+/**
+ * Format CI check results as plain text string.
+ */
+declare function formatAsText(result: CICheckResult, options?: TextFormatOptions): string;
+//#endregion
+export { TextFormatOptions, TextLine, formatAsText, formatAsTextLines };
+//# sourceMappingURL=text.d.mts.map

package/dist/formatters/text.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.mts","names":[],"sources":["../../src/formatters/text.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqKgB,UArJC,iBAAA,CAsJP;;;;;;;;;;;UA1IO,QAAA;;;;;;;;;iBAUD,iBAAA,SACN,yBACC,oBACR;;;;iBA4Ha,YAAA,SACN,yBACC"}