@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/formatter.d.ts

@@ -0,0 +1,42 @@
+import { FormatterConfig, FormatterType } from "@contractspec/lib.contracts";
+
+//#region src/formatter.d.ts
+
+interface FormatterOptions {
+  /** Override formatter type from config */
+  type?: FormatterType;
+  /** Skip formatting entirely */
+  skip?: boolean;
+  /** Working directory for formatter */
+  cwd?: string;
+  /** Silent mode - don't log output */
+  silent?: boolean;
+}
+interface FormatResult {
+  success: boolean;
+  formatted: boolean;
+  error?: string;
+  duration?: number;
+  formatterUsed?: FormatterType;
+}
+/**
+ * Auto-detect available formatters in the workspace.
+ * Returns the first detected formatter in priority order.
+ */
+declare function detectFormatter(cwd?: string): Promise<FormatterType | null>;
+interface FormatLogger {
+  log: (message: string) => void;
+  warn: (message: string) => void;
+  success: (message: string) => void;
+}
+/**
+ * Format a single file or array of files.
+ */
+declare function formatFiles(files: string | string[], config?: FormatterConfig, options?: FormatterOptions, logger?: FormatLogger): Promise<FormatResult>;
+/**
+ * Format files in batch, grouping by directory for efficiency.
+ */
+declare function formatFilesBatch(files: string[], config?: FormatterConfig, options?: FormatterOptions, logger?: FormatLogger): Promise<FormatResult>;
+//#endregion
+export { FormatLogger, FormatResult, FormatterOptions, detectFormatter, formatFiles, formatFilesBatch };
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","names":[],"sources":["../src/formatter.ts"],"sourcesContent":[],"mappings":";;;;AAoLiB,UAlKA,gBAAA,CAkKY;EASP;EAEX,IAAA,CAAA,EA3KF,aA2KE;EACC;EACD,IAAA,CAAA,EAAA,OAAA;EACA;EAAR,GAAA,CAAA,EAAA,MAAA;EAAO;EA8EY,MAAA,CAAA,EAAA,OAAA;;AAGV,UAtPK,YAAA,CAsPL;EACD,OAAA,EAAA,OAAA;EACA,SAAA,EAAA,OAAA;EAAR,KAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAAA,MAAA;kBAnPQ;;;;;;iBAkDI,eAAA,gBAEnB,QAAQ;UA8FM,YAAA;;;;;;;;iBASK,WAAA,oCAEX,2BACC,2BACD,eACR,QAAQ;;;;iBA8EW,gBAAA,2BAEX,2BACC,2BACD,eACR,QAAQ"}

package/dist/formatter.js

@@ -0,0 +1,163 @@
+import { readFile } from "node:fs/promises";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+//#region src/formatter.ts
+/**
+* Formatter utility for ContractSpec CLI.
+*
+* Detects and runs code formatters on generated files.
+*/
+const execAsync = promisify(exec);
+/**
+* Config files that indicate a formatter is available.
+*/
+const FORMATTER_CONFIG_FILES = {
+	prettier: [
+		".prettierrc",
+		".prettierrc.json",
+		".prettierrc.yaml",
+		".prettierrc.yml",
+		".prettierrc.js",
+		".prettierrc.cjs",
+		".prettierrc.mjs",
+		"prettier.config.js",
+		"prettier.config.cjs",
+		"prettier.config.mjs"
+	],
+	eslint: [
+		".eslintrc",
+		".eslintrc.json",
+		".eslintrc.yaml",
+		".eslintrc.yml",
+		".eslintrc.js",
+		".eslintrc.cjs",
+		"eslint.config.js",
+		"eslint.config.mjs",
+		"eslint.config.cjs"
+	],
+	biome: ["biome.json", "biome.jsonc"],
+	dprint: ["dprint.json", ".dprint.json"],
+	custom: []
+};
+/**
+* Package.json dependencies that indicate a formatter is available.
+*/
+const FORMATTER_PACKAGES = {
+	prettier: ["prettier"],
+	eslint: ["eslint"],
+	biome: ["@biomejs/biome"],
+	dprint: ["dprint"],
+	custom: []
+};
+/**
+* Auto-detect available formatters in the workspace.
+* Returns the first detected formatter in priority order.
+*/
+async function detectFormatter(cwd = process.cwd()) {
+	for (const formatter of [
+		"prettier",
+		"biome",
+		"eslint",
+		"dprint"
+	]) if (await isFormatterAvailable(formatter, cwd)) return formatter;
+	return null;
+}
+/**
+* Check if a specific formatter is available in the workspace.
+*/
+async function isFormatterAvailable(formatter, cwd) {
+	const configFiles = FORMATTER_CONFIG_FILES[formatter] || [];
+	for (const configFile of configFiles) if (existsSync(resolve(cwd, configFile))) return true;
+	const packageJsonPath = resolve(cwd, "package.json");
+	if (existsSync(packageJsonPath)) try {
+		const packageJson = JSON.parse(await readFile(packageJsonPath, "utf-8"));
+		const allDeps = {
+			...packageJson.dependencies,
+			...packageJson.devDependencies
+		};
+		const packages = FORMATTER_PACKAGES[formatter] || [];
+		for (const pkg of packages) if (pkg in allDeps) return true;
+	} catch {}
+	const parentDir = dirname(cwd);
+	if (parentDir !== cwd && parentDir !== "/") return isFormatterAvailable(formatter, parentDir);
+	return false;
+}
+/**
+* Get the command for a specific formatter type.
+*/
+function getFormatterCommand(type, files, config) {
+	const fileArgs = files.map((f) => `"${f}"`).join(" ");
+	const extraArgs = config?.args?.join(" ") || "";
+	switch (type) {
+		case "prettier": return `bunx prettier --write ${extraArgs} ${fileArgs}`;
+		case "eslint": return `bunx eslint --fix ${extraArgs} ${fileArgs}`;
+		case "biome": return `bunx @biomejs/biome format --write ${extraArgs} ${fileArgs}`;
+		case "dprint": return `bunx dprint fmt ${extraArgs} ${fileArgs}`;
+		case "custom":
+			if (!config?.command) throw new Error("Custom formatter requires a command to be specified in config");
+			return `${config.command} ${extraArgs} ${fileArgs}`;
+		default: throw new Error(`Unknown formatter type: ${type}`);
+	}
+}
+/**
+* Format a single file or array of files.
+*/
+async function formatFiles(files, config, options, logger) {
+	const startTime = Date.now();
+	const fileList = Array.isArray(files) ? files : [files];
+	const cwd = options?.cwd || process.cwd();
+	if (options?.skip || config?.enabled === false) return {
+		success: true,
+		formatted: false,
+		duration: Date.now() - startTime
+	};
+	let formatterType = options?.type || config?.type;
+	if (!formatterType) {
+		const detected = await detectFormatter(cwd);
+		if (!detected) return {
+			success: true,
+			formatted: false,
+			duration: Date.now() - startTime
+		};
+		formatterType = detected;
+	}
+	const command = getFormatterCommand(formatterType, fileList, config);
+	const timeout = config?.timeout || 3e4;
+	if (!options?.silent && logger) logger.log(`🎨 Formatting ${fileList.length} file(s) with ${formatterType}...`);
+	try {
+		await execAsync(command, {
+			cwd,
+			timeout
+		});
+		if (!options?.silent && logger) logger.success(`✅ Formatted ${fileList.length} file(s)`);
+		return {
+			success: true,
+			formatted: true,
+			duration: Date.now() - startTime,
+			formatterUsed: formatterType
+		};
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		if (!options?.silent && logger) logger.warn(`⚠️ Formatting failed (continuing anyway): ${errorMessage}`);
+		return {
+			success: false,
+			formatted: false,
+			error: errorMessage,
+			duration: Date.now() - startTime,
+			formatterUsed: formatterType
+		};
+	}
+}
+/**
+* Format files in batch, grouping by directory for efficiency.
+*/
+async function formatFilesBatch(files, config, options, logger) {
+	return formatFiles(files, config, options, logger);
+}
+
+//#endregion
+export { detectFormatter, formatFiles, formatFilesBatch };
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","names":[],"sources":["../src/formatter.ts"],"sourcesContent":["/**\n * Formatter utility for ContractSpec CLI.\n *\n * Detects and runs code formatters on generated files.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport { existsSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport type {\n  FormatterConfig,\n  FormatterType,\n} from '@contractspec/lib.contracts';\n\nconst execAsync = promisify(exec);\n\nexport interface FormatterOptions {\n  /** Override formatter type from config */\n  type?: FormatterType;\n  /** Skip formatting entirely */\n  skip?: boolean;\n  /** Working directory for formatter */\n  cwd?: string;\n  /** Silent mode - don't log output */\n  silent?: boolean;\n}\n\nexport interface FormatResult {\n  success: boolean;\n  formatted: boolean;\n  error?: string;\n  duration?: number;\n  formatterUsed?: FormatterType;\n}\n\n/**\n * Config files that indicate a formatter is available.\n */\nconst FORMATTER_CONFIG_FILES: Record<FormatterType, string[]> = {\n  prettier: [\n    '.prettierrc',\n    '.prettierrc.json',\n    '.prettierrc.yaml',\n    '.prettierrc.yml',\n    '.prettierrc.js',\n    '.prettierrc.cjs',\n    '.prettierrc.mjs',\n    'prettier.config.js',\n    'prettier.config.cjs',\n    'prettier.config.mjs',\n  ],\n  eslint: [\n    '.eslintrc',\n    '.eslintrc.json',\n    '.eslintrc.yaml',\n    '.eslintrc.yml',\n    '.eslintrc.js',\n    '.eslintrc.cjs',\n    'eslint.config.js',\n    'eslint.config.mjs',\n    'eslint.config.cjs',\n  ],\n  biome: ['biome.json', 'biome.jsonc'],\n  dprint: ['dprint.json', '.dprint.json'],\n  custom: [],\n};\n\n/**\n * Package.json dependencies that indicate a formatter is available.\n */\nconst FORMATTER_PACKAGES: Record<FormatterType, string[]> = {\n  prettier: ['prettier'],\n  eslint: ['eslint'],\n  biome: ['@biomejs/biome'],\n  dprint: ['dprint'],\n  custom: [],\n};\n\n/**\n * Auto-detect available formatters in the workspace.\n * Returns the first detected formatter in priority order.\n */\nexport async function detectFormatter(\n  cwd: string = process.cwd()\n): Promise<FormatterType | null> {\n  // Priority order for formatters\n  const priority: FormatterType[] = ['prettier', 'biome', 'eslint', 'dprint'];\n\n  for (const formatter of priority) {\n    if (await isFormatterAvailable(formatter, cwd)) {\n      return formatter;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Check if a specific formatter is available in the workspace.\n */\nasync function isFormatterAvailable(\n  formatter: FormatterType,\n  cwd: string\n): Promise<boolean> {\n  // Check for config files\n  const configFiles = FORMATTER_CONFIG_FILES[formatter] || [];\n  for (const configFile of configFiles) {\n    if (existsSync(resolve(cwd, configFile))) {\n      return true;\n    }\n  }\n\n  // Check package.json dependencies\n  const packageJsonPath = resolve(cwd, 'package.json');\n  if (existsSync(packageJsonPath)) {\n    try {\n      const packageJson = JSON.parse(\n        await readFile(packageJsonPath, 'utf-8')\n      ) as {\n        dependencies?: Record<string, string>;\n        devDependencies?: Record<string, string>;\n      };\n      const allDeps = {\n        ...packageJson.dependencies,\n        ...packageJson.devDependencies,\n      };\n      const packages = FORMATTER_PACKAGES[formatter] || [];\n      for (const pkg of packages) {\n        if (pkg in allDeps) {\n          return true;\n        }\n      }\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  // Walk up to find monorepo root\n  const parentDir = dirname(cwd);\n  if (parentDir !== cwd && parentDir !== '/') {\n    return isFormatterAvailable(formatter, parentDir);\n  }\n\n  return false;\n}\n\n/**\n * Get the command for a specific formatter type.\n */\nfunction getFormatterCommand(\n  type: FormatterType,\n  files: string[],\n  config?: FormatterConfig\n): string {\n  const fileArgs = files.map((f) => `\"${f}\"`).join(' ');\n  const extraArgs = config?.args?.join(' ') || '';\n\n  switch (type) {\n    case 'prettier':\n      return `bunx prettier --write ${extraArgs} ${fileArgs}`;\n    case 'eslint':\n      return `bunx eslint --fix ${extraArgs} ${fileArgs}`;\n    case 'biome':\n      return `bunx @biomejs/biome format --write ${extraArgs} ${fileArgs}`;\n    case 'dprint':\n      return `bunx dprint fmt ${extraArgs} ${fileArgs}`;\n    case 'custom':\n      if (!config?.command) {\n        throw new Error(\n          'Custom formatter requires a command to be specified in config'\n        );\n      }\n      return `${config.command} ${extraArgs} ${fileArgs}`;\n    default:\n      throw new Error(`Unknown formatter type: ${type}`);\n  }\n}\n\nexport interface FormatLogger {\n  log: (message: string) => void;\n  warn: (message: string) => void;\n  success: (message: string) => void;\n}\n\n/**\n * Format a single file or array of files.\n */\nexport async function formatFiles(\n  files: string | string[],\n  config?: FormatterConfig,\n  options?: FormatterOptions,\n  logger?: FormatLogger\n): Promise<FormatResult> {\n  const startTime = Date.now();\n  const fileList = Array.isArray(files) ? files : [files];\n  const cwd = options?.cwd || process.cwd();\n\n  // Skip if explicitly disabled\n  if (options?.skip || config?.enabled === false) {\n    return {\n      success: true,\n      formatted: false,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  // Determine formatter to use\n  let formatterType = options?.type || config?.type;\n\n  // Auto-detect if not specified\n  if (!formatterType) {\n    const detected = await detectFormatter(cwd);\n    if (!detected) {\n      // No formatter available - silently skip\n      return {\n        success: true,\n        formatted: false,\n        duration: Date.now() - startTime,\n      };\n    }\n    formatterType = detected;\n  }\n\n  // Build command\n  const command = getFormatterCommand(formatterType, fileList, config);\n  const timeout = config?.timeout || 30000;\n\n  if (!options?.silent && logger) {\n    logger.log(\n      `🎨 Formatting ${fileList.length} file(s) with ${formatterType}...`\n    );\n  }\n\n  try {\n    await execAsync(command, {\n      cwd,\n      timeout,\n    });\n\n    if (!options?.silent && logger) {\n      logger.success(`✅ Formatted ${fileList.length} file(s)`);\n    }\n\n    return {\n      success: true,\n      formatted: true,\n      duration: Date.now() - startTime,\n      formatterUsed: formatterType,\n    };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n\n    // Log warning but don't fail the operation\n    if (!options?.silent && logger) {\n      logger.warn(`⚠️ Formatting failed (continuing anyway): ${errorMessage}`);\n    }\n\n    return {\n      success: false,\n      formatted: false,\n      error: errorMessage,\n      duration: Date.now() - startTime,\n      formatterUsed: formatterType,\n    };\n  }\n}\n\n/**\n * Format files in batch, grouping by directory for efficiency.\n */\nexport async function formatFilesBatch(\n  files: string[],\n  config?: FormatterConfig,\n  options?: FormatterOptions,\n  logger?: FormatLogger\n): Promise<FormatResult> {\n  // For now, just format all files together\n  // Future optimization: group by directory and run formatter per directory\n  return formatFiles(files, config, options, logger);\n}\n"],"mappings":"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"}

package/dist/formatters/index.js

@@ -0,0 +1,2 @@
+import { combineSpecMarkdowns, generateSpecsSummaryHeader, specToMarkdown, specToMarkdownWithOptions } from "./spec-markdown.js";
+import { convertSpecToDocBlock } from "./spec-to-docblock.js";

package/dist/formatters/spec-markdown.d.ts

@@ -0,0 +1,31 @@
+import { LLMExportFormat, ParsedSpec, SpecToMarkdownOptions } from "../types/llm-types.js";
+
+//#region src/formatters/spec-markdown.d.ts
+
+/**
+ * Generate markdown from a parsed spec.
+ *
+ * Formats:
+ * - **full**: Complete information including source code and all details (for deep LLM context)
+ * - **prompt**: Concise with implementation instructions (actionable for LLM)
+ * - **context**: Brief summary with counts and key fields (lightweight overview)
+ */
+declare function specToMarkdown(spec: ParsedSpec, format: LLMExportFormat, optionsOrDepth?: number | {
+  depth?: number;
+  rootPath?: string;
+}): string;
+/**
+ * Convert spec to markdown with custom options.
+ */
+declare function specToMarkdownWithOptions(spec: ParsedSpec, options: SpecToMarkdownOptions): string;
+/**
+ * Generate a summary header for multiple specs.
+ */
+declare function generateSpecsSummaryHeader(specs: ParsedSpec[], format: LLMExportFormat): string;
+/**
+ * Combine multiple spec markdowns into a single document.
+ */
+declare function combineSpecMarkdowns(specs: ParsedSpec[], format: LLMExportFormat): string;
+//#endregion
+export { combineSpecMarkdowns, generateSpecsSummaryHeader, specToMarkdown, specToMarkdownWithOptions };
+//# sourceMappingURL=spec-markdown.d.ts.map

package/dist/formatters/spec-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-markdown.d.ts","names":[],"sources":["../../src/formatters/spec-markdown.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;iBAuBgB,cAAA,OACR,oBACE;;;;;;;iBA4WM,yBAAA,OACR,qBACG;;;;iBAQK,0BAAA,QACP,sBACC;;;;iBAiCM,oBAAA,QACP,sBACC"}

package/dist/formatters/spec-markdown.js

@@ -0,0 +1,263 @@
+import * as path from "node:path";
+
+//#region src/formatters/spec-markdown.ts
+/**
+* Generate markdown from a parsed spec.
+*
+* Formats:
+* - **full**: Complete information including source code and all details (for deep LLM context)
+* - **prompt**: Concise with implementation instructions (actionable for LLM)
+* - **context**: Brief summary with counts and key fields (lightweight overview)
+*/
+function specToMarkdown(spec, format, optionsOrDepth = 0) {
+	const options = typeof optionsOrDepth === "number" ? { depth: optionsOrDepth } : optionsOrDepth;
+	const depth = options.depth ?? 0;
+	const rootPath = options.rootPath;
+	const lines = [];
+	const indent = depth > 0 ? "  ".repeat(depth) : "";
+	const headerLevel = Math.min(depth + 1, 6);
+	const headerPrefix = "#".repeat(headerLevel);
+	lines.push(`${indent}${headerPrefix} ${spec.meta.key}`);
+	lines.push("");
+	if (spec.meta.description) {
+		lines.push(`${indent}${spec.meta.description}`);
+		lines.push("");
+	}
+	if (format === "context") return formatContextMode(spec, lines, indent);
+	if (format === "prompt") return formatPromptMode(spec, lines, indent);
+	return formatFullMode(spec, lines, indent, rootPath);
+}
+/**
+* Format spec in context mode (brief summary).
+*/
+function formatContextMode(spec, lines, indent) {
+	const metaParts = [];
+	metaParts.push(`**${spec.specType}**`);
+	if (spec.kind && spec.kind !== "unknown") metaParts.push(`(${spec.kind})`);
+	metaParts.push(`v${spec.meta.version}`);
+	if (spec.meta.stability) metaParts.push(`[${spec.meta.stability}]`);
+	lines.push(`${indent}${metaParts.join(" ")}`);
+	lines.push("");
+	if (spec.specType === "feature") {
+		const counts = [];
+		if (spec.operations?.length) counts.push(`${spec.operations.length} operation(s)`);
+		if (spec.events?.length) counts.push(`${spec.events.length} event(s)`);
+		if (spec.presentations?.length) counts.push(`${spec.presentations.length} presentation(s)`);
+		if (counts.length > 0) {
+			lines.push(`${indent}Contains: ${counts.join(", ")}`);
+			lines.push("");
+		}
+	}
+	if (spec.specType === "operation") {
+		const indicators = [];
+		if (spec.hasIo) indicators.push("I/O");
+		if (spec.hasPolicy) indicators.push("Policy");
+		if (spec.emittedEvents?.length) indicators.push(`${spec.emittedEvents.length} event(s)`);
+		if (indicators.length > 0) {
+			lines.push(`${indent}Includes: ${indicators.join(", ")}`);
+			lines.push("");
+		}
+	}
+	return lines.join("\n");
+}
+/**
+* Format spec in prompt mode (implementation-focused).
+*/
+function formatPromptMode(spec, lines, indent) {
+	lines.push(`${indent}**Type**: ${spec.specType}${spec.kind && spec.kind !== "unknown" ? ` (${spec.kind})` : ""}`);
+	lines.push(`${indent}**Version**: ${spec.meta.version}`);
+	if (spec.meta.stability) lines.push(`${indent}**Stability**: ${spec.meta.stability}`);
+	if (spec.meta.owners?.length) lines.push(`${indent}**Owners**: ${spec.meta.owners.join(", ")}`);
+	if (spec.meta.tags?.length) lines.push(`${indent}**Tags**: ${spec.meta.tags.join(", ")}`);
+	lines.push("");
+	if (spec.meta.goal) {
+		lines.push(`${indent}**Goal**: ${spec.meta.goal}`);
+		lines.push("");
+	}
+	if (spec.meta.context) {
+		lines.push(`${indent}**Context**: ${spec.meta.context}`);
+		lines.push("");
+	}
+	if (spec.specType === "operation") {
+		const structure = [];
+		if (spec.hasIo) structure.push("Input/Output Schema");
+		if (spec.hasPolicy) structure.push("Policy Enforcement");
+		if (spec.hasPayload) structure.push("Payload");
+		if (spec.hasContent) structure.push("Content");
+		if (structure.length > 0) {
+			lines.push(`${indent}**Structure**: ${structure.join(", ")}`);
+			lines.push("");
+		}
+	}
+	if (spec.specType === "feature") appendFeatureRefs(spec, lines, indent);
+	if (spec.emittedEvents?.length) {
+		lines.push(`${indent}**Emits**: ${formatRefs(spec.emittedEvents)}`);
+		lines.push("");
+	}
+	lines.push(`${indent}---`);
+	lines.push("");
+	lines.push(`${indent}**Implementation Instructions**:`);
+	lines.push("");
+	appendImplementationInstructions(spec, lines, indent);
+	return lines.join("\n");
+}
+/**
+* Format spec in full mode (complete with source code).
+*/
+function formatFullMode(spec, lines, indent, rootPath) {
+	lines.push(`${indent}## Metadata`);
+	lines.push("");
+	lines.push(`${indent}- **Type**: ${spec.specType}${spec.kind && spec.kind !== "unknown" ? ` (${spec.kind})` : ""}`);
+	lines.push(`${indent}- **Version**: ${spec.meta.version}`);
+	if (spec.meta.stability) lines.push(`${indent}- **Stability**: ${spec.meta.stability}`);
+	if (spec.meta.owners?.length) lines.push(`${indent}- **Owners**: ${spec.meta.owners.join(", ")}`);
+	if (spec.meta.tags?.length) lines.push(`${indent}- **Tags**: ${spec.meta.tags.join(", ")}`);
+	if (spec.filePath) {
+		const displayPath = rootPath ? path.relative(rootPath, spec.filePath) : spec.filePath;
+		lines.push(`${indent}- **File**: \`${displayPath}\``);
+	}
+	lines.push("");
+	if (spec.meta.goal) {
+		lines.push(`${indent}## Goal`);
+		lines.push("");
+		lines.push(`${indent}${spec.meta.goal}`);
+		lines.push("");
+	}
+	if (spec.meta.context) {
+		lines.push(`${indent}## Context`);
+		lines.push("");
+		lines.push(`${indent}${spec.meta.context}`);
+		lines.push("");
+	}
+	if (spec.specType === "feature") appendFeatureSections(spec, lines, indent);
+	if (spec.emittedEvents?.length) {
+		lines.push(`${indent}## Emitted Events`);
+		lines.push("");
+		for (const ev of spec.emittedEvents) lines.push(`${indent}- \`${ev.name}\` (v${ev.version})`);
+		lines.push("");
+	}
+	if (spec.policyRefs?.length) {
+		lines.push(`${indent}## Policy References`);
+		lines.push("");
+		for (const policy of spec.policyRefs) lines.push(`${indent}- \`${policy.name}\` (v${policy.version})`);
+		lines.push("");
+	}
+	if (spec.testRefs?.length) {
+		lines.push(`${indent}## Test Specifications`);
+		lines.push("");
+		for (const test of spec.testRefs) lines.push(`${indent}- \`${test.name}\` (v${test.version})`);
+		lines.push("");
+	}
+	if (spec.sourceBlock) {
+		lines.push(`${indent}## Source Definition`);
+		lines.push("");
+		lines.push(`${indent}\`\`\`typescript`);
+		const sourceLines = spec.sourceBlock.split("\n");
+		for (const sourceLine of sourceLines) lines.push(`${indent}${sourceLine}`);
+		lines.push(`${indent}\`\`\``);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Format a list of spec refs as inline code.
+*/
+function formatRefs(refs) {
+	return refs.map((r) => `\`${r.name}\``).join(", ");
+}
+/**
+* Append feature refs in summary format.
+*/
+function appendFeatureRefs(spec, lines, indent) {
+	if (spec.operations?.length) lines.push(`${indent}**Operations**: ${formatRefs(spec.operations)}`);
+	if (spec.events?.length) lines.push(`${indent}**Events**: ${formatRefs(spec.events)}`);
+	if (spec.presentations?.length) lines.push(`${indent}**Presentations**: ${formatRefs(spec.presentations)}`);
+	lines.push("");
+}
+/**
+* Append feature child sections with full detail.
+*/
+function appendFeatureSections(spec, lines, indent) {
+	if (spec.operations?.length) {
+		lines.push(`${indent}## Operations (${spec.operations.length})`);
+		lines.push("");
+		for (const op of spec.operations) lines.push(`${indent}- \`${op.name}\` (v${op.version})`);
+		lines.push("");
+	}
+	if (spec.events?.length) {
+		lines.push(`${indent}## Events (${spec.events.length})`);
+		lines.push("");
+		for (const ev of spec.events) lines.push(`${indent}- \`${ev.name}\` (v${ev.version})`);
+		lines.push("");
+	}
+	if (spec.presentations?.length) {
+		lines.push(`${indent}## Presentations (${spec.presentations.length})`);
+		lines.push("");
+		for (const pres of spec.presentations) lines.push(`${indent}- \`${pres.name}\` (v${pres.version})`);
+		lines.push("");
+	}
+}
+/**
+* Append implementation instructions based on spec type.
+*/
+function appendImplementationInstructions(spec, lines, indent) {
+	if (spec.specType === "operation") {
+		lines.push(`${indent}Implement the \`${spec.meta.key}\` ${spec.kind ?? "operation"} ensuring:`);
+		if (spec.hasIo) {
+			lines.push(`${indent}- Input validation per schema`);
+			lines.push(`${indent}- Output matches expected schema`);
+		}
+		if (spec.hasPolicy) lines.push(`${indent}- Policy rules are enforced`);
+		if (spec.emittedEvents?.length) lines.push(`${indent}- Events are emitted on success`);
+	} else if (spec.specType === "feature") {
+		lines.push(`${indent}Implement the \`${spec.meta.key}\` feature including:`);
+		if (spec.operations?.length) lines.push(`${indent}- ${spec.operations.length} operation(s)`);
+		if (spec.presentations?.length) lines.push(`${indent}- ${spec.presentations.length} presentation(s)`);
+	} else if (spec.specType === "event") {
+		lines.push(`${indent}Implement the \`${spec.meta.key}\` event ensuring:`);
+		lines.push(`${indent}- Payload matches expected schema`);
+		lines.push(`${indent}- Event is properly typed`);
+	} else if (spec.specType === "presentation") {
+		lines.push(`${indent}Implement the \`${spec.meta.key}\` presentation ensuring:`);
+		lines.push(`${indent}- Component renders correctly`);
+		lines.push(`${indent}- Accessibility requirements are met`);
+	} else lines.push(`${indent}Implement the \`${spec.meta.key}\` ${spec.specType} according to the specification.`);
+	lines.push("");
+}
+/**
+* Convert spec to markdown with custom options.
+*/
+function specToMarkdownWithOptions(spec, options) {
+	return specToMarkdown(spec, options.format, options.depth ?? 0);
+}
+/**
+* Generate a summary header for multiple specs.
+*/
+function generateSpecsSummaryHeader(specs, format) {
+	const lines = [];
+	lines.push("# ContractSpec Export");
+	lines.push("");
+	lines.push(`**Format**: ${format}`);
+	lines.push(`**Specs**: ${specs.length}`);
+	lines.push("");
+	const byType = /* @__PURE__ */ new Map();
+	for (const spec of specs) byType.set(spec.specType, (byType.get(spec.specType) ?? 0) + 1);
+	if (byType.size > 0) {
+		lines.push("**Contents**:");
+		for (const [type, count] of byType) lines.push(`- ${count} ${type}(s)`);
+		lines.push("");
+	}
+	lines.push("---");
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Combine multiple spec markdowns into a single document.
+*/
+function combineSpecMarkdowns(specs, format) {
+	return generateSpecsSummaryHeader(specs, format) + specs.map((spec) => specToMarkdown(spec, format)).join("\n---\n\n");
+}
+
+//#endregion
+export { combineSpecMarkdowns, generateSpecsSummaryHeader, specToMarkdown, specToMarkdownWithOptions };
+//# sourceMappingURL=spec-markdown.js.map

package/dist/formatters/spec-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-markdown.js","names":[],"sources":["../../src/formatters/spec-markdown.ts"],"sourcesContent":["/**\n * Spec to Markdown Formatter\n *\n * Pure functions for converting parsed specs to LLM-friendly markdown formats.\n * Extracted from vscode-contractspec/src/commands/llm.ts for reuse.\n */\n\nimport type {\n  LLMExportFormat,\n  ParsedSpec,\n  SpecRef,\n  SpecToMarkdownOptions,\n} from '../types/llm-types';\nimport * as path from 'node:path';\n\n/**\n * Generate markdown from a parsed spec.\n *\n * Formats:\n * - **full**: Complete information including source code and all details (for deep LLM context)\n * - **prompt**: Concise with implementation instructions (actionable for LLM)\n * - **context**: Brief summary with counts and key fields (lightweight overview)\n */\nexport function specToMarkdown(\n  spec: ParsedSpec,\n  format: LLMExportFormat,\n  optionsOrDepth: number | { depth?: number; rootPath?: string } = 0\n): string {\n  const options =\n    typeof optionsOrDepth === 'number'\n      ? { depth: optionsOrDepth }\n      : optionsOrDepth;\n  const depth = options.depth ?? 0;\n  const rootPath = options.rootPath;\n\n  const lines: string[] = [];\n  const indent = depth > 0 ? '  '.repeat(depth) : '';\n  const headerLevel = Math.min(depth + 1, 6);\n  const headerPrefix = '#'.repeat(headerLevel);\n\n  // Header\n  lines.push(`${indent}${headerPrefix} ${spec.meta.key}`);\n  lines.push('');\n\n  // Description (always included if present)\n  if (spec.meta.description) {\n    lines.push(`${indent}${spec.meta.description}`);\n    lines.push('');\n  }\n\n  // ===== CONTEXT FORMAT: Brief summary only =====\n  if (format === 'context') {\n    return formatContextMode(spec, lines, indent);\n  }\n\n  // ===== PROMPT FORMAT: Implementation-focused =====\n  if (format === 'prompt') {\n    return formatPromptMode(spec, lines, indent);\n  }\n\n  // ===== FULL FORMAT: Complete with source code =====\n  return formatFullMode(spec, lines, indent, rootPath);\n}\n\n/**\n * Format spec in context mode (brief summary).\n */\nfunction formatContextMode(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string\n): string {\n  // Compact metadata line\n  const metaParts: string[] = [];\n  metaParts.push(`**${spec.specType}**`);\n  if (spec.kind && spec.kind !== 'unknown') metaParts.push(`(${spec.kind})`);\n  metaParts.push(`v${spec.meta.version}`);\n  if (spec.meta.stability) metaParts.push(`[${spec.meta.stability}]`);\n  lines.push(`${indent}${metaParts.join(' ')}`);\n  lines.push('');\n\n  // Key counts for features\n  if (spec.specType === 'feature') {\n    const counts: string[] = [];\n    if (spec.operations?.length)\n      counts.push(`${spec.operations.length} operation(s)`);\n    if (spec.events?.length) counts.push(`${spec.events.length} event(s)`);\n    if (spec.presentations?.length)\n      counts.push(`${spec.presentations.length} presentation(s)`);\n    if (counts.length > 0) {\n      lines.push(`${indent}Contains: ${counts.join(', ')}`);\n      lines.push('');\n    }\n  }\n\n  // Key indicators for operations\n  if (spec.specType === 'operation') {\n    const indicators: string[] = [];\n    if (spec.hasIo) indicators.push('I/O');\n    if (spec.hasPolicy) indicators.push('Policy');\n    if (spec.emittedEvents?.length)\n      indicators.push(`${spec.emittedEvents.length} event(s)`);\n    if (indicators.length > 0) {\n      lines.push(`${indent}Includes: ${indicators.join(', ')}`);\n      lines.push('');\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Format spec in prompt mode (implementation-focused).\n */\nfunction formatPromptMode(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string\n): string {\n  // Metadata\n  lines.push(\n    `${indent}**Type**: ${spec.specType}${spec.kind && spec.kind !== 'unknown' ? ` (${spec.kind})` : ''}`\n  );\n  lines.push(`${indent}**Version**: ${spec.meta.version}`);\n  if (spec.meta.stability)\n    lines.push(`${indent}**Stability**: ${spec.meta.stability}`);\n  if (spec.meta.owners?.length)\n    lines.push(`${indent}**Owners**: ${spec.meta.owners.join(', ')}`);\n  if (spec.meta.tags?.length)\n    lines.push(`${indent}**Tags**: ${spec.meta.tags.join(', ')}`);\n  lines.push('');\n\n  // Goal and Context\n  if (spec.meta.goal) {\n    lines.push(`${indent}**Goal**: ${spec.meta.goal}`);\n    lines.push('');\n  }\n  if (spec.meta.context) {\n    lines.push(`${indent}**Context**: ${spec.meta.context}`);\n    lines.push('');\n  }\n\n  // Structure for operations\n  if (spec.specType === 'operation') {\n    const structure: string[] = [];\n    if (spec.hasIo) structure.push('Input/Output Schema');\n    if (spec.hasPolicy) structure.push('Policy Enforcement');\n    if (spec.hasPayload) structure.push('Payload');\n    if (spec.hasContent) structure.push('Content');\n    if (structure.length > 0) {\n      lines.push(`${indent}**Structure**: ${structure.join(', ')}`);\n      lines.push('');\n    }\n  }\n\n  // Child refs for features (summary only)\n  if (spec.specType === 'feature') {\n    appendFeatureRefs(spec, lines, indent);\n  }\n\n  // Emitted events\n  if (spec.emittedEvents?.length) {\n    lines.push(`${indent}**Emits**: ${formatRefs(spec.emittedEvents)}`);\n    lines.push('');\n  }\n\n  // Implementation instructions\n  lines.push(`${indent}---`);\n  lines.push('');\n  lines.push(`${indent}**Implementation Instructions**:`);\n  lines.push('');\n  appendImplementationInstructions(spec, lines, indent);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format spec in full mode (complete with source code).\n */\nfunction formatFullMode(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string,\n  rootPath?: string\n): string {\n  // Full metadata section\n  lines.push(`${indent}## Metadata`);\n  lines.push('');\n  lines.push(\n    `${indent}- **Type**: ${spec.specType}${spec.kind && spec.kind !== 'unknown' ? ` (${spec.kind})` : ''}`\n  );\n  lines.push(`${indent}- **Version**: ${spec.meta.version}`);\n  if (spec.meta.stability) {\n    lines.push(`${indent}- **Stability**: ${spec.meta.stability}`);\n  }\n  if (spec.meta.owners?.length) {\n    lines.push(`${indent}- **Owners**: ${spec.meta.owners.join(', ')}`);\n  }\n  if (spec.meta.tags?.length) {\n    lines.push(`${indent}- **Tags**: ${spec.meta.tags.join(', ')}`);\n  }\n  if (spec.filePath) {\n    const displayPath = rootPath\n      ? path.relative(rootPath, spec.filePath)\n      : spec.filePath;\n    lines.push(`${indent}- **File**: \\`${displayPath}\\``);\n  }\n  lines.push('');\n\n  // Goal and Context\n  if (spec.meta.goal) {\n    lines.push(`${indent}## Goal`);\n    lines.push('');\n    lines.push(`${indent}${spec.meta.goal}`);\n    lines.push('');\n  }\n  if (spec.meta.context) {\n    lines.push(`${indent}## Context`);\n    lines.push('');\n    lines.push(`${indent}${spec.meta.context}`);\n    lines.push('');\n  }\n\n  // Child specs for features (with full detail)\n  if (spec.specType === 'feature') {\n    appendFeatureSections(spec, lines, indent);\n  }\n\n  // Emitted events (for operations)\n  if (spec.emittedEvents?.length) {\n    lines.push(`${indent}## Emitted Events`);\n    lines.push('');\n    for (const ev of spec.emittedEvents) {\n      lines.push(`${indent}- \\`${ev.name}\\` (v${ev.version})`);\n    }\n    lines.push('');\n  }\n\n  // Policy references\n  if (spec.policyRefs?.length) {\n    lines.push(`${indent}## Policy References`);\n    lines.push('');\n    for (const policy of spec.policyRefs) {\n      lines.push(`${indent}- \\`${policy.name}\\` (v${policy.version})`);\n    }\n    lines.push('');\n  }\n\n  // Test references\n  if (spec.testRefs?.length) {\n    lines.push(`${indent}## Test Specifications`);\n    lines.push('');\n    for (const test of spec.testRefs) {\n      lines.push(`${indent}- \\`${test.name}\\` (v${test.version})`);\n    }\n    lines.push('');\n  }\n\n  // Source code block (the key differentiator for full format!)\n  if (spec.sourceBlock) {\n    lines.push(`${indent}## Source Definition`);\n    lines.push('');\n    lines.push(`${indent}\\`\\`\\`typescript`);\n    // Add source block with proper indentation\n    const sourceLines = spec.sourceBlock.split('\\n');\n    for (const sourceLine of sourceLines) {\n      lines.push(`${indent}${sourceLine}`);\n    }\n    lines.push(`${indent}\\`\\`\\``);\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Format a list of spec refs as inline code.\n */\nfunction formatRefs(refs: SpecRef[]): string {\n  return refs.map((r) => `\\`${r.name}\\``).join(', ');\n}\n\n/**\n * Append feature refs in summary format.\n */\nfunction appendFeatureRefs(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string\n): void {\n  if (spec.operations?.length) {\n    lines.push(`${indent}**Operations**: ${formatRefs(spec.operations)}`);\n  }\n  if (spec.events?.length) {\n    lines.push(`${indent}**Events**: ${formatRefs(spec.events)}`);\n  }\n  if (spec.presentations?.length) {\n    lines.push(`${indent}**Presentations**: ${formatRefs(spec.presentations)}`);\n  }\n  lines.push('');\n}\n\n/**\n * Append feature child sections with full detail.\n */\nfunction appendFeatureSections(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string\n): void {\n  if (spec.operations?.length) {\n    lines.push(`${indent}## Operations (${spec.operations.length})`);\n    lines.push('');\n    for (const op of spec.operations) {\n      lines.push(`${indent}- \\`${op.name}\\` (v${op.version})`);\n    }\n    lines.push('');\n  }\n  if (spec.events?.length) {\n    lines.push(`${indent}## Events (${spec.events.length})`);\n    lines.push('');\n    for (const ev of spec.events) {\n      lines.push(`${indent}- \\`${ev.name}\\` (v${ev.version})`);\n    }\n    lines.push('');\n  }\n  if (spec.presentations?.length) {\n    lines.push(`${indent}## Presentations (${spec.presentations.length})`);\n    lines.push('');\n    for (const pres of spec.presentations) {\n      lines.push(`${indent}- \\`${pres.name}\\` (v${pres.version})`);\n    }\n    lines.push('');\n  }\n}\n\n/**\n * Append implementation instructions based on spec type.\n */\nfunction appendImplementationInstructions(\n  spec: ParsedSpec,\n  lines: string[],\n  indent: string\n): void {\n  if (spec.specType === 'operation') {\n    lines.push(\n      `${indent}Implement the \\`${spec.meta.key}\\` ${spec.kind ?? 'operation'} ensuring:`\n    );\n    if (spec.hasIo) {\n      lines.push(`${indent}- Input validation per schema`);\n      lines.push(`${indent}- Output matches expected schema`);\n    }\n    if (spec.hasPolicy) {\n      lines.push(`${indent}- Policy rules are enforced`);\n    }\n    if (spec.emittedEvents?.length) {\n      lines.push(`${indent}- Events are emitted on success`);\n    }\n  } else if (spec.specType === 'feature') {\n    lines.push(\n      `${indent}Implement the \\`${spec.meta.key}\\` feature including:`\n    );\n    if (spec.operations?.length) {\n      lines.push(`${indent}- ${spec.operations.length} operation(s)`);\n    }\n    if (spec.presentations?.length) {\n      lines.push(`${indent}- ${spec.presentations.length} presentation(s)`);\n    }\n  } else if (spec.specType === 'event') {\n    lines.push(`${indent}Implement the \\`${spec.meta.key}\\` event ensuring:`);\n    lines.push(`${indent}- Payload matches expected schema`);\n    lines.push(`${indent}- Event is properly typed`);\n  } else if (spec.specType === 'presentation') {\n    lines.push(\n      `${indent}Implement the \\`${spec.meta.key}\\` presentation ensuring:`\n    );\n    lines.push(`${indent}- Component renders correctly`);\n    lines.push(`${indent}- Accessibility requirements are met`);\n  } else {\n    lines.push(\n      `${indent}Implement the \\`${spec.meta.key}\\` ${spec.specType} according to the specification.`\n    );\n  }\n  lines.push('');\n}\n\n/**\n * Convert spec to markdown with custom options.\n */\nexport function specToMarkdownWithOptions(\n  spec: ParsedSpec,\n  options: SpecToMarkdownOptions\n): string {\n  return specToMarkdown(spec, options.format, options.depth ?? 0);\n}\n\n/**\n * Generate a summary header for multiple specs.\n */\nexport function generateSpecsSummaryHeader(\n  specs: ParsedSpec[],\n  format: LLMExportFormat\n): string {\n  const lines: string[] = [];\n\n  lines.push('# ContractSpec Export');\n  lines.push('');\n  lines.push(`**Format**: ${format}`);\n  lines.push(`**Specs**: ${specs.length}`);\n  lines.push('');\n\n  // Group by type\n  const byType = new Map<string, number>();\n  for (const spec of specs) {\n    byType.set(spec.specType, (byType.get(spec.specType) ?? 0) + 1);\n  }\n\n  if (byType.size > 0) {\n    lines.push('**Contents**:');\n    for (const [type, count] of byType) {\n      lines.push(`- ${count} ${type}(s)`);\n    }\n    lines.push('');\n  }\n\n  lines.push('---');\n  lines.push('');\n\n  return lines.join('\\n');\n}\n\n/**\n * Combine multiple spec markdowns into a single document.\n */\nexport function combineSpecMarkdowns(\n  specs: ParsedSpec[],\n  format: LLMExportFormat\n): string {\n  const header = generateSpecsSummaryHeader(specs, format);\n  const specMarkdowns = specs.map((spec) => specToMarkdown(spec, format));\n\n  return header + specMarkdowns.join('\\n---\\n\\n');\n}\n"],"mappings":"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"}

package/dist/formatters/spec-to-docblock.d.ts

@@ -0,0 +1,14 @@
+import { ParsedSpec } from "../types/llm-types.js";
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/formatters/spec-to-docblock.d.ts
+
+/**
+ * Convert a parsed spec to a DocBlock for documentation generation.
+ */
+declare function convertSpecToDocBlock(spec: ParsedSpec, options?: {
+  rootPath?: string;
+}): DocBlock;
+//#endregion
+export { convertSpecToDocBlock };
+//# sourceMappingURL=spec-to-docblock.d.ts.map

package/dist/formatters/spec-to-docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-to-docblock.d.ts","names":[],"sources":["../../src/formatters/spec-to-docblock.ts"],"sourcesContent":[],"mappings":";;;;;;;AAOA;iBAAgB,qBAAA,OACR;;IAEL"}

package/dist/formatters/spec-to-docblock.js

@@ -0,0 +1,48 @@
+import { specToMarkdown } from "./spec-markdown.js";
+
+//#region src/formatters/spec-to-docblock.ts
+/**
+* Convert a parsed spec to a DocBlock for documentation generation.
+*/
+function convertSpecToDocBlock(spec, options) {
+	const body = specToMarkdown(spec, "full", { rootPath: options?.rootPath });
+	return {
+		id: spec.meta.key,
+		title: spec.meta.description ? `${spec.meta.key} - ${spec.meta.description}` : spec.meta.key,
+		body,
+		summary: spec.meta.description,
+		kind: mapSpecTypeToDocKind(spec.specType),
+		visibility: "public",
+		version: spec.meta.version,
+		tags: spec.meta.tags,
+		owners: spec.meta.owners,
+		stability: spec.meta.stability,
+		domain: inferDomain(spec.meta.key),
+		relatedSpecs: extractRelatedSpecs(spec)
+	};
+}
+function mapSpecTypeToDocKind(specType) {
+	switch (specType) {
+		case "feature": return "goal";
+		case "operation": return "reference";
+		case "event": return "reference";
+		case "presentation": return "usage";
+		default: return "reference";
+	}
+}
+function inferDomain(key) {
+	const parts = key.split(".");
+	if (parts.length > 2) return parts[0];
+}
+function extractRelatedSpecs(spec) {
+	const related = [];
+	if (spec.emittedEvents) related.push(...spec.emittedEvents.map((r) => r.name));
+	if (spec.operations) related.push(...spec.operations.map((r) => r.name));
+	if (spec.events) related.push(...spec.events.map((r) => r.name));
+	if (spec.testRefs) related.push(...spec.testRefs.map((r) => r.name));
+	return [...new Set(related)];
+}
+
+//#endregion
+export { convertSpecToDocBlock };
+//# sourceMappingURL=spec-to-docblock.js.map

package/dist/formatters/spec-to-docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-to-docblock.js","names":[],"sources":["../../src/formatters/spec-to-docblock.ts"],"sourcesContent":["import type { ParsedSpec } from '../types/llm-types';\nimport type { DocBlock, DocKind } from '@contractspec/lib.contracts/docs';\nimport { specToMarkdown } from './spec-markdown';\n\n/**\n * Convert a parsed spec to a DocBlock for documentation generation.\n */\nexport function convertSpecToDocBlock(\n  spec: ParsedSpec,\n  options?: { rootPath?: string }\n): DocBlock {\n  const body = specToMarkdown(spec, 'full', { rootPath: options?.rootPath });\n\n  return {\n    id: spec.meta.key,\n    title: spec.meta.description\n      ? `${spec.meta.key} - ${spec.meta.description}`\n      : spec.meta.key,\n    body: body,\n    summary: spec.meta.description,\n    kind: mapSpecTypeToDocKind(spec.specType),\n    visibility: 'public', // Default to public for now\n    version: spec.meta.version,\n    tags: spec.meta.tags,\n    owners: spec.meta.owners,\n    stability: spec.meta.stability,\n    domain: inferDomain(spec.meta.key),\n    relatedSpecs: extractRelatedSpecs(spec),\n  };\n}\n\nfunction mapSpecTypeToDocKind(specType: string): DocKind {\n  switch (specType) {\n    case 'feature':\n      return 'goal'; // Features often describe goals\n    case 'operation':\n      return 'reference';\n    case 'event':\n      return 'reference';\n    case 'presentation':\n      return 'usage';\n    default:\n      return 'reference';\n  }\n}\n\nfunction inferDomain(key: string): string | undefined {\n  const parts = key.split('.');\n  if (parts.length > 2) {\n    return parts[0]; // e.g. \"crm.users.create\" -> \"crm\"\n  }\n  return undefined;\n}\n\nfunction extractRelatedSpecs(spec: ParsedSpec): string[] {\n  const related: string[] = [];\n\n  if (spec.emittedEvents) {\n    related.push(...spec.emittedEvents.map((r) => r.name));\n  }\n  if (spec.operations) {\n    related.push(...spec.operations.map((r) => r.name));\n  }\n  if (spec.events) {\n    related.push(...spec.events.map((r) => r.name));\n  }\n  if (spec.testRefs) {\n    related.push(...spec.testRefs.map((r) => r.name));\n  }\n\n  return [...new Set(related)];\n}\n"],"mappings":";;;;;;AAOA,SAAgB,sBACd,MACA,SACU;CACV,MAAM,OAAO,eAAe,MAAM,QAAQ,EAAE,UAAU,SAAS,UAAU,CAAC;AAE1E,QAAO;EACL,IAAI,KAAK,KAAK;EACd,OAAO,KAAK,KAAK,cACb,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,gBAChC,KAAK,KAAK;EACR;EACN,SAAS,KAAK,KAAK;EACnB,MAAM,qBAAqB,KAAK,SAAS;EACzC,YAAY;EACZ,SAAS,KAAK,KAAK;EACnB,MAAM,KAAK,KAAK;EAChB,QAAQ,KAAK,KAAK;EAClB,WAAW,KAAK,KAAK;EACrB,QAAQ,YAAY,KAAK,KAAK,IAAI;EAClC,cAAc,oBAAoB,KAAK;EACxC;;AAGH,SAAS,qBAAqB,UAA2B;AACvD,SAAQ,UAAR;EACE,KAAK,UACH,QAAO;EACT,KAAK,YACH,QAAO;EACT,KAAK,QACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAS,YAAY,KAAiC;CACpD,MAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,KAAI,MAAM,SAAS,EACjB,QAAO,MAAM;;AAKjB,SAAS,oBAAoB,MAA4B;CACvD,MAAM,UAAoB,EAAE;AAE5B,KAAI,KAAK,cACP,SAAQ,KAAK,GAAG,KAAK,cAAc,KAAK,MAAM,EAAE,KAAK,CAAC;AAExD,KAAI,KAAK,WACP,SAAQ,KAAK,GAAG,KAAK,WAAW,KAAK,MAAM,EAAE,KAAK,CAAC;AAErD,KAAI,KAAK,OACP,SAAQ,KAAK,GAAG,KAAK,OAAO,KAAK,MAAM,EAAE,KAAK,CAAC;AAEjD,KAAI,KAAK,SACP,SAAQ,KAAK,GAAG,KAAK,SAAS,KAAK,MAAM,EAAE,KAAK,CAAC;AAGnD,QAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC"}