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

package/dist/ai/prompts/code-generation.js

@@ -1,9 +1,23 @@
-import{__export as e}from"../../_virtual/rolldown_runtime.js";var t=e({buildComponentPrompt:()=>r,buildFormPrompt:()=>i,buildHandlerPrompt:()=>n,buildTestPrompt:()=>a,getCodeGenSystemPrompt:()=>o});function n(e){return`You are a senior TypeScript developer implementing a handler for a contract specification.
+import { __export } from "../../_virtual/rolldown_runtime.js";
+
+//#region src/ai/prompts/code-generation.ts
+var code_generation_exports = /* @__PURE__ */ __export({
+	buildComponentPrompt: () => buildComponentPrompt,
+	buildFormPrompt: () => buildFormPrompt,
+	buildHandlerPrompt: () => buildHandlerPrompt,
+	buildTestPrompt: () => buildTestPrompt,
+	getCodeGenSystemPrompt: () => getCodeGenSystemPrompt
+});
+/**
+* Build prompt for generating handler implementation
+*/
+function buildHandlerPrompt(specCode) {
+	return `You are a senior TypeScript developer implementing a handler for a contract specification.
 
 Here is the contract spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete handler implementation that:
@@ -17,12 +31,18 @@ Generate a complete handler implementation that:
 
 The handler should be production-ready with proper error handling, logging points, and clear structure.
 
-Return only the TypeScript code for the handler function.`}function r(e){return`You are a senior React developer creating a component for a presentation specification.
+Return only the TypeScript code for the handler function.`;
+}
+/**
+* Build prompt for generating React component from presentation spec
+*/
+function buildComponentPrompt(specCode) {
+	return `You are a senior React developer creating a component for a presentation specification.
 
 Here is the presentation spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete React component that:
@@ -36,12 +56,18 @@ Generate a complete React component that:
 
 The component should follow Atomic Design principles and be reusable.
 
-Return only the TypeScript/TSX code for the component.`}function i(e){return`You are a senior React developer creating a form component from a form specification.
+Return only the TypeScript/TSX code for the component.`;
+}
+/**
+* Build prompt for generating form component
+*/
+function buildFormPrompt(specCode) {
+	return `You are a senior React developer creating a form component from a form specification.
 
 Here is the form spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete form component using react-hook-form that:
@@ -56,25 +82,31 @@ Generate a complete form component using react-hook-form that:
 
 The form should provide excellent UX with real-time validation and helpful feedback.
 
-Return only the TypeScript/TSX code for the form component.`}function a(e,t,n){return`You are a senior developer writing comprehensive tests.
+Return only the TypeScript/TSX code for the form component.`;
+}
+/**
+* Build prompt for generating tests
+*/
+function buildTestPrompt(specCode, implementationCode, testType) {
+	return `You are a senior developer writing comprehensive tests.
 
 Spec:
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Implementation:
 \`\`\`typescript
-${t}
+${implementationCode}
 \`\`\`
 
 Generate complete test suite using Vitest that:
-${n===`handler`?`
+${testType === "handler" ? `
   - Test all acceptance scenarios from the spec
   - Test error cases defined in spec.io.errors
   - Verify events are emitted correctly
   - Test input validation
-  - Test happy path and edge cases`:`
+  - Test happy path and edge cases` : `
   - Test rendering with various props
   - Test user interactions
   - Test accessibility (a11y)
@@ -83,7 +115,13 @@ ${n===`handler`?`
 
 Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
 
-Return only the TypeScript test code.`}function o(){return`You are an expert TypeScript developer with deep knowledge of:
+Return only the TypeScript test code.`;
+}
+/**
+* System prompt for code generation
+*/
+function getCodeGenSystemPrompt() {
+	return `You are an expert TypeScript developer with deep knowledge of:
 - Type-safe API design
 - React and modern hooks
 - Test-driven development
@@ -97,4 +135,8 @@ Generate production-ready code that is:
 - Defensive and error-safe
 - Easy to maintain and extend
 
-Always prioritize code quality, safety, and user experience.`}export{r as buildComponentPrompt,i as buildFormPrompt,n as buildHandlerPrompt,a as buildTestPrompt,t as code_generation_exports,o as getCodeGenSystemPrompt};
+Always prioritize code quality, safety, and user experience.`;
+}
+
+//#endregion
+export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, code_generation_exports, getCodeGenSystemPrompt };

package/dist/ai/prompts/index.js

@@ -1 +1,12 @@
-import{__export as e}from"../../_virtual/rolldown_runtime.js";import{spec_creation_exports as t}from"./spec-creation.js";import{code_generation_exports as n}from"./code-generation.js";var r=e({codeGeneration:()=>n,specCreation:()=>t});export{r as prompts_exports};
+import { __export } from "../../_virtual/rolldown_runtime.js";
+import { spec_creation_exports } from "./spec-creation.js";
+import { code_generation_exports } from "./code-generation.js";
+
+//#region src/ai/prompts/index.ts
+var prompts_exports = /* @__PURE__ */ __export({
+	codeGeneration: () => code_generation_exports,
+	specCreation: () => spec_creation_exports
+});
+
+//#endregion
+export { prompts_exports };

package/dist/ai/prompts/spec-creation.js

@@ -1,8 +1,22 @@
-import{__export as e}from"../../_virtual/rolldown_runtime.js";var t=e({addExampleContext:()=>o,buildEventSpecPrompt:()=>r,buildOperationSpecPrompt:()=>n,buildPresentationSpecPrompt:()=>i,getSystemPrompt:()=>a});function n(e,t){return`You are a senior software architect creating a contract specification for an operation.
-
-The operation is a ${t} (${t===`command`?`changes state, has side effects`:`read-only, idempotent`}).
-
-User description: ${e}
+import { __export } from "../../_virtual/rolldown_runtime.js";
+
+//#region src/ai/prompts/spec-creation.ts
+var spec_creation_exports = /* @__PURE__ */ __export({
+	addExampleContext: () => addExampleContext,
+	buildEventSpecPrompt: () => buildEventSpecPrompt,
+	buildOperationSpecPrompt: () => buildOperationSpecPrompt,
+	buildPresentationSpecPrompt: () => buildPresentationSpecPrompt,
+	getSystemPrompt: () => getSystemPrompt
+});
+/**
+* Build prompt for creating operation spec from description
+*/
+function buildOperationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a contract specification for an operation.
+
+The operation is a ${kind} (${kind === "command" ? "changes state, has side effects" : "read-only, idempotent"}).
+
+User description: ${description}
 
 Create a complete contract specification following these guidelines:
 
@@ -16,9 +30,15 @@ Create a complete contract specification following these guidelines:
 8. **Feature Flags**: Any flags that gate this operation
 9. **Side Effects**: What events might be emitted, analytics to track
 
-Respond with a structured spec.`}function r(e){return`You are a senior software architect creating an event specification.
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating event spec from description
+*/
+function buildEventSpecPrompt(description) {
+	return `You are a senior software architect creating an event specification.
 
-User description: ${e}
+User description: ${description}
 
 Create a complete event specification following these guidelines:
 
@@ -30,11 +50,21 @@ Create a complete event specification following these guidelines:
 
 Events represent things that have already happened and should use past tense.
 
-Respond with a structured spec.`}function i(e,t){return`You are a senior software architect creating a presentation specification.
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating presentation spec from description
+*/
+function buildPresentationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a presentation specification.
 
-This is a ${t} presentation - ${{web_component:`a React component with props schema`,markdown:`markdown/MDX documentation or guide`,data:`structured data export (JSON/XML)`}[t]}.
+This is a ${kind} presentation - ${{
+		web_component: "a React component with props schema",
+		markdown: "markdown/MDX documentation or guide",
+		data: "structured data export (JSON/XML)"
+	}[kind]}.
 
-User description: ${e}
+User description: ${description}
 
 Create a complete presentation specification following these guidelines:
 
@@ -42,13 +72,15 @@ Create a complete presentation specification following these guidelines:
 2. **Version**: Start at 1
 3. **Description**: What this presentation shows/provides
 4. **Kind-specific details**:
-   ${t===`web_component`?`- Component key (symbolic, resolved by host app)
-   - Props structure
-   - Analytics events to track`:t===`markdown`?`- Content or resource URI
-   - Target audience`:`- MIME type (e.g., application/json)
-   - Data structure description`}
+   ${kind === "web_component" ? "- Component key (symbolic, resolved by host app)\n   - Props structure\n   - Analytics events to track" : kind === "markdown" ? "- Content or resource URI\n   - Target audience" : "- MIME type (e.g., application/json)\n   - Data structure description"}
 
-Respond with a structured spec.`}function a(){return`You are an expert software architect specializing in API design and contract-driven development.
+Respond with a structured spec.`;
+}
+/**
+* Build system prompt for all spec generation
+*/
+function getSystemPrompt() {
+	return `You are an expert software architect specializing in API design and contract-driven development.
 
 You create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.
 
@@ -58,12 +90,21 @@ Your specs are:
 - Business-oriented (capturing the "why" not just "what")
 - Designed for both humans and AI agents to understand
 
-Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`}function o(e,t){return t.length===0?e:`${e}
+Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`;
+}
+/**
+* Create example-based prompt for better results
+*/
+function addExampleContext(basePrompt, examples) {
+	if (examples.length === 0) return basePrompt;
+	return `${basePrompt}
 
 Here are some good examples for reference:
 
-${t.join(`
+${examples.join("\n\n")}
 
-`)}
+Follow this structure and quality level.`;
+}
 
-Follow this structure and quality level.`}export{r as buildEventSpecPrompt,n as buildOperationSpecPrompt,i as buildPresentationSpecPrompt,a as getSystemPrompt,t as spec_creation_exports};
+//#endregion
+export { buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt, spec_creation_exports };

package/dist/ai/providers.js

@@ -1 +1,40 @@
-import{i as e}from"../libs/ai-providers/dist/models.js";import{i as t,r as n}from"../libs/ai-providers/dist/legacy.js";import"../libs/ai-providers/dist/index.js";function r(e){return n({aiProvider:e.aiProvider,aiModel:e.aiModel||void 0,customEndpoint:e.customEndpoint||void 0})}async function i(e){return await t({aiProvider:e.aiProvider,aiModel:e.aiModel||void 0,customEndpoint:e.customEndpoint||void 0})}function a(t){return e(t)}export{r as getAIProvider,a as getRecommendedModels,i as validateProvider};
+import { getRecommendedModels } from "../libs/ai-providers/dist/models.js";
+import { getAIProvider, validateProvider } from "../libs/ai-providers/dist/legacy.js";
+import "../libs/ai-providers/dist/index.js";
+
+//#region src/ai/providers.ts
+/**
+* Initialize AI provider based on configuration
+*
+* @deprecated Use createProvider() from @lssm/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 @lssm/lib.ai-providers instead
+*/
+async function validateProvider$1(config) {
+	return await validateProvider({
+		aiProvider: config.aiProvider,
+		aiModel: config.aiModel || void 0,
+		customEndpoint: config.customEndpoint || void 0
+	});
+}
+/**
+* Get recommended models for each provider
+*
+* @deprecated Use getModelsForProvider() from @lssm/lib.ai-providers instead
+*/
+function getRecommendedModels$1(provider) {
+	return getRecommendedModels(provider);
+}
+
+//#endregion
+export { getAIProvider$1 as getAIProvider, getRecommendedModels$1 as getRecommendedModels, validateProvider$1 as validateProvider };

package/dist/formatters/index.js

@@ -1 +1,18 @@
-import{__export as e}from"../_virtual/rolldown_runtime.js";import{formatAsSarif as t,sarifToJson as n}from"./sarif.js";import{formatAsJson as r,formatAsJsonCompact as i,formatAsJsonFull as a}from"./json.js";import{formatAsText as o,formatAsTextLines as s}from"./text.js";var c=e({formatAsJson:()=>r,formatAsJsonCompact:()=>i,formatAsJsonFull:()=>a,formatAsSarif:()=>t,formatAsText:()=>o,formatAsTextLines:()=>s,sarifToJson:()=>n});export{c as formatters_exports};
+import { __export } from "../_virtual/rolldown_runtime.js";
+import { formatAsSarif, sarifToJson } from "./sarif.js";
+import { formatAsJson, formatAsJsonCompact, formatAsJsonFull } from "./json.js";
+import { formatAsText, formatAsTextLines } from "./text.js";
+
+//#region src/formatters/index.ts
+var formatters_exports = /* @__PURE__ */ __export({
+	formatAsJson: () => formatAsJson,
+	formatAsJsonCompact: () => formatAsJsonCompact,
+	formatAsJsonFull: () => formatAsJsonFull,
+	formatAsSarif: () => formatAsSarif,
+	formatAsText: () => formatAsText,
+	formatAsTextLines: () => formatAsTextLines,
+	sarifToJson: () => sarifToJson
+});
+
+//#endregion
+export { formatters_exports };

package/dist/formatters/json.js

@@ -1 +1,71 @@
-function e(e){return{success:e.success,errors:e.totalErrors,warnings:e.totalWarnings,duration:e.durationMs,timestamp:e.timestamp,commit:e.commitSha,branch:e.branch,issues:e.issues.map(e=>({rule:e.ruleId,severity:e.severity,message:e.message,file:e.file,line:e.line}))}}function t(e){return{success:e.success,summary:{totalErrors:e.totalErrors,totalWarnings:e.totalWarnings,totalNotes:e.totalNotes,durationMs:e.durationMs,timestamp:e.timestamp,commitSha:e.commitSha,branch:e.branch},categories:e.categories.map(e=>({category:e.category,label:e.label,passed:e.passed,errors:e.errors,warnings:e.warnings,notes:e.notes,durationMs:e.durationMs})),issues:e.issues.map(e=>({ruleId:e.ruleId,severity:e.severity,message:e.message,category:e.category,file:e.file,line:e.line,column:e.column,endLine:e.endLine,endColumn:e.endColumn,context:e.context}))}}function n(n,r={}){let{pretty:i=!0,includeDetails:a=!0}=r,o=a?t(n):e(n);return i?JSON.stringify(o,null,2):JSON.stringify(o)}export{n as formatAsJson,e as formatAsJsonCompact,t as formatAsJsonFull};
+//#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 };

package/dist/formatters/sarif.js

@@ -1 +1,163 @@
-const e={"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`}};function t(t,a={}){let{toolName:o=`ContractSpec`,toolVersion:s=`1.0.0`,toolUri:c=`https://contractspec.dev`,repositoryUri:l,workingDirectory:u}=a,d=new Map,f=new Map;for(let r of t.issues)if(!d.has(r.ruleId)){let t=e[r.ruleId]??{name:r.ruleId,description:`Rule: ${r.ruleId}`},i={id:r.ruleId,name:t.name,shortDescription:{text:t.description},defaultConfiguration:{level:n(r.severity)}};t.helpUri&&(i.helpUri=t.helpUri),f.set(r.ruleId,d.size),d.set(r.ruleId,i)}let p=t.issues.map(e=>{let t={ruleId:e.ruleId,ruleIndex:f.get(e.ruleId)??0,level:n(e.severity),message:{text:e.message}};if(e.file){let n={physicalLocation:{artifactLocation:{uri:r(e.file),uriBaseId:`%SRCROOT%`}}};e.line!==void 0&&(n.physicalLocation.region={startLine:e.line,startColumn:e.column??1,endLine:e.endLine??e.line,endColumn:e.endColumn}),t.locations=[n]}return t.partialFingerprints={primaryLocationLineHash:i(e)},t}),m=[];(l||t.commitSha||t.branch)&&m.push({repositoryUri:l,revisionId:t.commitSha,branch:t.branch});let h={tool:{driver:{name:o,version:s,informationUri:c,rules:Array.from(d.values())}},results:p,invocations:[{executionSuccessful:t.success,endTimeUtc:t.timestamp,...u&&{workingDirectory:{uri:u}}}]};return m.length>0&&(h.versionControlProvenance=m),{$schema:`https://json.schemastore.org/sarif-2.1.0.json`,version:`2.1.0`,runs:[h]}}function n(e){switch(e){case`error`:return`error`;case`warning`:return`warning`;case`note`:return`note`;default:return`warning`}}function r(e){return e.replace(/^\.\//,``).replace(/\\/g,`/`)}function i(e){let t=[e.ruleId,e.file??``,e.message];return Buffer.from(t.join(`|`)).toString(`base64`).slice(0,16)}function a(e){return JSON.stringify(e,null,2)}export{t as formatAsSarif,a as sarifToJson};
+//#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.dev", repositoryUri, workingDirectory } = options;
+	const ruleMap = /* @__PURE__ */ new Map();
+	const ruleIndexMap = /* @__PURE__ */ new Map();
+	for (const issue of result.issues) 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 = result.issues.map((issue) => {
+		const sarifResult = {
+			ruleId: issue.ruleId,
+			ruleIndex: ruleIndexMap.get(issue.ruleId) ?? 0,
+			level: mapSeverityToLevel(issue.severity),
+			message: { text: issue.message }
+		};
+		if (issue.file) {
+			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 || result.commitSha || result.branch) 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 };