@contractspec/bundle.workspace 1.44.0

package/dist/formatters/json.d.ts

@@ -0,0 +1,89 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#region src/formatters/json.d.ts
+
+/**
+ * Options for JSON formatting.
+ */
+interface JsonFormatOptions {
+  /** Pretty print with indentation. */
+  pretty?: boolean;
+  /** Include full issue details. */
+  includeDetails?: boolean;
+  /** Include category summaries. */
+  includeSummaries?: boolean;
+}
+/**
+ * Compact JSON output structure.
+ */
+interface JsonCompactOutput {
+  success: boolean;
+  errors: number;
+  warnings: number;
+  duration: number;
+  timestamp: string;
+  commit?: string;
+  branch?: string;
+  issues: JsonIssueCompact[];
+}
+/**
+ * Compact issue representation.
+ */
+interface JsonIssueCompact {
+  rule: string;
+  severity: string;
+  message: string;
+  file?: string;
+  line?: number;
+}
+/**
+ * Full JSON output structure.
+ */
+interface JsonFullOutput {
+  success: boolean;
+  summary: {
+    totalErrors: number;
+    totalWarnings: number;
+    totalNotes: number;
+    durationMs: number;
+    timestamp: string;
+    commitSha?: string;
+    branch?: string;
+  };
+  categories: {
+    category: string;
+    label: string;
+    passed: boolean;
+    errors: number;
+    warnings: number;
+    notes: number;
+    durationMs: number;
+  }[];
+  issues: {
+    ruleId: string;
+    severity: string;
+    message: string;
+    category: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+    context?: Record<string, unknown>;
+  }[];
+}
+/**
+ * Format CI check results as compact JSON.
+ */
+declare function formatAsJsonCompact(result: CICheckResult): JsonCompactOutput;
+/**
+ * Format CI check results as full JSON with all details.
+ */
+declare function formatAsJsonFull(result: CICheckResult): JsonFullOutput;
+/**
+ * Format CI check results as JSON.
+ */
+declare function formatAsJson(result: CICheckResult, options?: JsonFormatOptions): string;
+//#endregion
+export { JsonCompactOutput, JsonFormatOptions, JsonFullOutput, JsonIssueCompact, formatAsJson, formatAsJsonCompact, formatAsJsonFull };
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","names":[],"sources":["../../src/formatters/json.ts"],"sourcesContent":[],"mappings":";;;;AAsFA;AAsBA;AAuCA;UAvIiB,iBAAA;;;;;;;;;;;UAYA,iBAAA;;;;;;;;UAQP;;;;;UAMO,gBAAA;;;;;;;;;;UAWA,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BH;;;;;;iBAOE,mBAAA,SAA4B,gBAAgB;;;;iBAsB5C,gBAAA,SAAyB,gBAAgB;;;;iBAuCzC,YAAA,SACN,yBACC"}

package/dist/formatters/json.js

@@ -0,0 +1,72 @@
+//#region src/formatters/json.ts
+/**
+* Format CI check results as compact JSON.
+*/
+function formatAsJsonCompact(result) {
+	return {
+		success: result.success,
+		errors: result.totalErrors,
+		warnings: result.totalWarnings,
+		duration: result.durationMs,
+		timestamp: result.timestamp,
+		commit: result.commitSha,
+		branch: result.branch,
+		issues: result.issues.map((issue) => ({
+			rule: issue.ruleId,
+			severity: issue.severity,
+			message: issue.message,
+			file: issue.file,
+			line: issue.line
+		}))
+	};
+}
+/**
+* Format CI check results as full JSON with all details.
+*/
+function formatAsJsonFull(result) {
+	return {
+		success: result.success,
+		summary: {
+			totalErrors: result.totalErrors,
+			totalWarnings: result.totalWarnings,
+			totalNotes: result.totalNotes,
+			durationMs: result.durationMs,
+			timestamp: result.timestamp,
+			commitSha: result.commitSha,
+			branch: result.branch
+		},
+		categories: result.categories.map((cat) => ({
+			category: cat.category,
+			label: cat.label,
+			passed: cat.passed,
+			errors: cat.errors,
+			warnings: cat.warnings,
+			notes: cat.notes,
+			durationMs: cat.durationMs
+		})),
+		issues: result.issues.map((issue) => ({
+			ruleId: issue.ruleId,
+			severity: issue.severity,
+			message: issue.message,
+			category: issue.category,
+			file: issue.file,
+			line: issue.line,
+			column: issue.column,
+			endLine: issue.endLine,
+			endColumn: issue.endColumn,
+			context: issue.context
+		}))
+	};
+}
+/**
+* Format CI check results as JSON.
+*/
+function formatAsJson(result, options = {}) {
+	const { pretty = true, includeDetails = true } = options;
+	const output = includeDetails ? formatAsJsonFull(result) : formatAsJsonCompact(result);
+	return pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);
+}
+
+//#endregion
+export { formatAsJson, formatAsJsonCompact, formatAsJsonFull };
+//# sourceMappingURL=json.js.map

package/dist/formatters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","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 * Options for JSON formatting.\n */\nexport interface JsonFormatOptions {\n  /** Pretty print with indentation. */\n  pretty?: boolean;\n  /** Include full issue details. */\n  includeDetails?: boolean;\n  /** Include category summaries. */\n  includeSummaries?: boolean;\n}\n\n/**\n * Compact JSON output structure.\n */\nexport interface JsonCompactOutput {\n  success: boolean;\n  errors: number;\n  warnings: number;\n  duration: number;\n  timestamp: string;\n  commit?: string;\n  branch?: string;\n  issues: JsonIssueCompact[];\n}\n\n/**\n * Compact issue representation.\n */\nexport interface JsonIssueCompact {\n  rule: string;\n  severity: string;\n  message: string;\n  file?: string;\n  line?: number;\n}\n\n/**\n * Full JSON output structure.\n */\nexport interface JsonFullOutput {\n  success: boolean;\n  summary: {\n    totalErrors: number;\n    totalWarnings: number;\n    totalNotes: number;\n    durationMs: number;\n    timestamp: string;\n    commitSha?: string;\n    branch?: string;\n  };\n  categories: {\n    category: string;\n    label: string;\n    passed: boolean;\n    errors: number;\n    warnings: number;\n    notes: number;\n    durationMs: number;\n  }[];\n  issues: {\n    ruleId: string;\n    severity: string;\n    message: string;\n    category: string;\n    file?: string;\n    line?: number;\n    column?: number;\n    endLine?: number;\n    endColumn?: number;\n    context?: Record<string, unknown>;\n  }[];\n}\n\n/**\n * Format CI check results as compact JSON.\n */\nexport function formatAsJsonCompact(result: CICheckResult): JsonCompactOutput {\n  return {\n    success: result.success,\n    errors: result.totalErrors,\n    warnings: result.totalWarnings,\n    duration: result.durationMs,\n    timestamp: result.timestamp,\n    commit: result.commitSha,\n    branch: result.branch,\n    issues: result.issues.map((issue) => ({\n      rule: issue.ruleId,\n      severity: issue.severity,\n      message: issue.message,\n      file: issue.file,\n      line: issue.line,\n    })),\n  };\n}\n\n/**\n * Format CI check results as full JSON with all details.\n */\nexport function formatAsJsonFull(result: CICheckResult): JsonFullOutput {\n  return {\n    success: result.success,\n    summary: {\n      totalErrors: result.totalErrors,\n      totalWarnings: result.totalWarnings,\n      totalNotes: result.totalNotes,\n      durationMs: result.durationMs,\n      timestamp: result.timestamp,\n      commitSha: result.commitSha,\n      branch: result.branch,\n    },\n    categories: result.categories.map((cat) => ({\n      category: cat.category,\n      label: cat.label,\n      passed: cat.passed,\n      errors: cat.errors,\n      warnings: cat.warnings,\n      notes: cat.notes,\n      durationMs: cat.durationMs,\n    })),\n    issues: result.issues.map((issue) => ({\n      ruleId: issue.ruleId,\n      severity: issue.severity,\n      message: issue.message,\n      category: issue.category,\n      file: issue.file,\n      line: issue.line,\n      column: issue.column,\n      endLine: issue.endLine,\n      endColumn: issue.endColumn,\n      context: issue.context,\n    })),\n  };\n}\n\n/**\n * Format CI check results as JSON.\n */\nexport function formatAsJson(\n  result: CICheckResult,\n  options: JsonFormatOptions = {}\n): string {\n  const { pretty = true, includeDetails = true } = options;\n\n  const output = includeDetails\n    ? formatAsJsonFull(result)\n    : formatAsJsonCompact(result);\n\n  return pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);\n}\n"],"mappings":";;;;AAsFA,SAAgB,oBAAoB,QAA0C;AAC5E,QAAO;EACL,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf,UAAU,OAAO;EACjB,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,QAAQ,OAAO,OAAO,KAAK,WAAW;GACpC,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,MAAM,MAAM;GACZ,MAAM,MAAM;GACb,EAAE;EACJ;;;;;AAMH,SAAgB,iBAAiB,QAAuC;AACtE,QAAO;EACL,SAAS,OAAO;EAChB,SAAS;GACP,aAAa,OAAO;GACpB,eAAe,OAAO;GACtB,YAAY,OAAO;GACnB,YAAY,OAAO;GACnB,WAAW,OAAO;GAClB,WAAW,OAAO;GAClB,QAAQ,OAAO;GAChB;EACD,YAAY,OAAO,WAAW,KAAK,SAAS;GAC1C,UAAU,IAAI;GACd,OAAO,IAAI;GACX,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ,UAAU,IAAI;GACd,OAAO,IAAI;GACX,YAAY,IAAI;GACjB,EAAE;EACH,QAAQ,OAAO,OAAO,KAAK,WAAW;GACpC,QAAQ,MAAM;GACd,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,WAAW,MAAM;GACjB,SAAS,MAAM;GAChB,EAAE;EACJ;;;;;AAMH,SAAgB,aACd,QACA,UAA6B,EAAE,EACvB;CACR,MAAM,EAAE,SAAS,MAAM,iBAAiB,SAAS;CAEjD,MAAM,SAAS,iBACX,iBAAiB,OAAO,GACxB,oBAAoB,OAAO;AAE/B,QAAO,SAAS,KAAK,UAAU,QAAQ,MAAM,EAAE,GAAG,KAAK,UAAU,OAAO"}

package/dist/formatters/sarif.d.ts

@@ -0,0 +1,101 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","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.js

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

package/dist/formatters/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","names":["RULE_METADATA: Record<\n  string,\n  { name: string; description: string; helpUri?: string }\n>","rule: SarifRule","results: SarifResult[]","sarifResult: SarifResult","location: SarifLocation","versionControlProvenance: SarifVersionControl[]","run: SarifRun"],"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.ts

@@ -0,0 +1,35 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#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.ts.map

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

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