@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/services/implementation/resolver.js

@@ -1,223 +0,0 @@
-import { scanSpecSource } from "../../modules/contractspec-workspace/dist/analysis/spec-scan.js";
-import { discoverImplementationsForSpec } from "./discovery.js";
-import { createHash } from "crypto";
-
-//#region src/services/implementation/resolver.ts
-/**
-* Implementation resolver service.
-*
-* Resolves all implementations for a spec by merging:
-* 1. Explicit mappings from spec.implementations
-* 2. Auto-discovered references from workspace scanning
-* 3. Convention-based paths (naming conventions)
-*/
-const DEFAULT_OPTIONS = {
-	includeExplicit: true,
-	includeDiscovered: true,
-	includeConvention: true,
-	computeHashes: true
-};
-/**
-* Convert string to kebab-case.
-*/
-function toKebabCase(value) {
-	return value.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-/**
-* Compute SHA256 hash of content.
-*/
-function computeHash(content) {
-	return createHash("sha256").update(content).digest("hex");
-}
-/**
-* Get convention-based implementation paths for a spec.
-*/
-function getConventionPaths(specType, specName, outputDir) {
-	const kebab = toKebabCase(specName);
-	const paths = [];
-	if (specType === "operation") {
-		paths.push({
-			path: `${outputDir}/handlers/${kebab}.handler.ts`,
-			type: "handler"
-		});
-		paths.push({
-			path: `${outputDir}/handlers/${kebab}.handler.test.ts`,
-			type: "test"
-		});
-	}
-	if (specType === "presentation") {
-		paths.push({
-			path: `${outputDir}/components/${kebab}.tsx`,
-			type: "component"
-		});
-		paths.push({
-			path: `${outputDir}/components/${kebab}.test.tsx`,
-			type: "test"
-		});
-	}
-	if (specType === "form") {
-		paths.push({
-			path: `${outputDir}/forms/${kebab}.form.tsx`,
-			type: "form"
-		});
-		paths.push({
-			path: `${outputDir}/forms/${kebab}.form.test.tsx`,
-			type: "test"
-		});
-	}
-	if (specType === "event") {
-		paths.push({
-			path: `${outputDir}/handlers/${kebab}.handler.ts`,
-			type: "handler"
-		});
-		paths.push({
-			path: `${outputDir}/handlers/${kebab}.handler.test.ts`,
-			type: "test"
-		});
-	}
-	return paths;
-}
-/**
-* Determine overall implementation status.
-*/
-function determineStatus(implementations) {
-	if (implementations.length === 0) return "missing";
-	const existingImpls = implementations.filter((i) => i.exists);
-	implementations.filter((i) => i.type !== "test");
-	if (existingImpls.filter((i) => i.type !== "test").length === 0) return "missing";
-	if (implementations.every((i) => i.exists)) return "implemented";
-	return "partial";
-}
-/**
-* Resolve all implementations for a spec file.
-*/
-async function resolveImplementations(specFile, adapters, config, options = {}) {
-	const opts = {
-		...DEFAULT_OPTIONS,
-		...options
-	};
-	const { fs } = adapters;
-	if (!await fs.exists(specFile)) throw new Error(`Spec file not found: ${specFile}`);
-	const specContent = await fs.readFile(specFile);
-	const specHash = opts.computeHashes ? computeHash(specContent) : void 0;
-	const scan = scanSpecSource(specContent, specFile);
-	const specName = scan.name ?? fs.basename(specFile).replace(/\.[jt]s$/, "");
-	const specVersion = scan.version ?? 1;
-	const specType = scan.specType ?? "operation";
-	const implementations = [];
-	const seenPaths = /* @__PURE__ */ new Set();
-	const addImpl = async (path, type, source, description) => {
-		if (seenPaths.has(path)) return;
-		seenPaths.add(path);
-		const exists = await fs.exists(path);
-		let contentHash;
-		if (exists && opts.computeHashes) try {
-			contentHash = computeHash(await fs.readFile(path));
-		} catch {}
-		implementations.push({
-			path,
-			type,
-			source,
-			exists,
-			contentHash,
-			description
-		});
-	};
-	if (opts.includeExplicit) {
-		const explicitImpls = parseExplicitImplementations(specContent);
-		for (const impl of explicitImpls) await addImpl(impl.path, impl.type, "explicit", impl.description);
-	}
-	if (opts.includeDiscovered) {
-		const discovered = await discoverImplementationsForSpec(specName, adapters, opts);
-		const specNameVariants = getSpecNameVariants(specName);
-		for (const variant of specNameVariants) {
-			const variantDiscovered = await discoverImplementationsForSpec(variant, adapters, opts);
-			discovered.push(...variantDiscovered);
-		}
-		for (const ref of discovered) {
-			if (ref.filePath === specFile) continue;
-			await addImpl(ref.filePath, ref.inferredType, "discovered");
-		}
-	}
-	if (opts.includeConvention) {
-		const conventionPaths = getConventionPaths(specType, specName, opts.outputDir ?? config.outputDir ?? "./src");
-		for (const { path, type } of conventionPaths) await addImpl(path, type, "convention");
-	}
-	return {
-		specName,
-		specVersion,
-		specPath: specFile,
-		specType,
-		implementations,
-		status: determineStatus(implementations),
-		specHash
-	};
-}
-/**
-* Parse explicit implementations from spec source code.
-* Looks for: implementations: [{ path: '...', type: '...' }]
-*/
-function parseExplicitImplementations(code) {
-	const implementations = [];
-	const implMatch = code.match(/implementations\s*:\s*\[([\s\S]*?)\]/);
-	if (!implMatch) return implementations;
-	const implBlock = implMatch[1];
-	if (!implBlock) return implementations;
-	const objRegex = /\{\s*path\s*:\s*['"`]([^'"`]+)['"`]\s*,\s*type\s*:\s*['"`]([^'"`]+)['"`](?:\s*,\s*description\s*:\s*['"`]([^'"`]+)['"`])?\s*\}/g;
-	let match;
-	while ((match = objRegex.exec(implBlock)) !== null) implementations.push({
-		path: match[1],
-		type: match[2],
-		description: match[3]
-	});
-	return implementations;
-}
-/**
-* Get common variants of a spec name for discovery.
-*/
-function getSpecNameVariants(specName) {
-	const variants = [];
-	const base = specName.replace(/Spec$/, "").replace(/Contract$/, "").replace(/Command$/, "").replace(/Query$/, "");
-	if (base !== specName) {
-		variants.push(base);
-		variants.push(`${base}Spec`);
-		variants.push(`${base}Contract`);
-	}
-	const parts = specName.split(".");
-	if (parts.length > 1) {
-		const pascalName = parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
-		variants.push(pascalName);
-	}
-	return variants;
-}
-/**
-* Resolve implementations for multiple spec files.
-*/
-async function resolveAllImplementations(specFiles, adapters, config, options = {}) {
-	const results = [];
-	for (const specFile of specFiles) try {
-		const result = await resolveImplementations(specFile, adapters, config, options);
-		results.push(result);
-	} catch (error) {
-		console.error(`Failed to resolve implementations for ${specFile}:`, error);
-	}
-	return results;
-}
-/**
-* Get implementation summary statistics.
-*/
-function getImplementationSummary(results) {
-	const implemented = results.filter((r) => r.status === "implemented").length;
-	const partial = results.filter((r) => r.status === "partial").length;
-	const missing = results.filter((r) => r.status === "missing").length;
-	return {
-		total: results.length,
-		implemented,
-		partial,
-		missing,
-		coverage: results.length > 0 ? Math.round(implemented / results.length * 100) : 100
-	};
-}
-
-//#endregion
-export { getImplementationSummary, resolveAllImplementations, resolveImplementations };

package/dist/services/index.js

@@ -1,53 +0,0 @@
-import { detectPackageManager, findPackageRoot, findWorkspaceRoot, getWorkspaceInfo } from "../adapters/workspace.js";
-import { validateSpec, validateSpecs } from "./validate.js";
-import { validateImplementationFiles } from "./validate-implementation.js";
-import { compareSpecs } from "./diff.js";
-import { analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats } from "./deps.js";
-import { groupSpecsByType, listSpecs } from "./list.js";
-import { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig } from "./config.js";
-import { buildSpec } from "./build.js";
-import { importFromOpenApiService } from "./openapi/import-service.js";
-import { syncWithOpenApiService } from "./openapi/sync-service.js";
-import { validateAgainstOpenApiService } from "./openapi/validate-service.js";
-import { exportOpenApi } from "./openapi/export-service.js";
-import "./openapi/index.js";
-import { RegistryClient, addToRegistry, listFromRegistry, resolveRegistryUrl, searchRegistry } from "./registry.js";
-import { syncSpecs } from "./sync.js";
-import { watchSpecs } from "./watch.js";
-import { cleanArtifacts } from "./clean.js";
-import { runTests } from "./test.js";
-import { createRegeneratorService } from "./regenerator.js";
-import { findAllConfigFiles, formatWorkspaceInfo, getExtendedWorkspaceInfo, mergeMonorepoConfigs } from "./workspace-info.js";
-import { analyzeIntegrity, filterIssuesBySeverity, filterIssuesByType, getAllSpecs } from "./integrity.js";
-import { generateMermaidDiagram } from "./integrity-diagram.js";
-import { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS } from "./setup/types.js";
-import { generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateVscodeSettings, getClaudeDesktopConfigPath } from "./setup/config-generators.js";
-import { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson } from "./setup/file-merger.js";
-import { runSetup } from "./setup/setup-service.js";
-import "./setup/index.js";
-import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS } from "./doctor/types.js";
-import { formatCheckResult, formatDoctorSummary, runDoctor } from "./doctor/doctor-service.js";
-import "./doctor/index.js";
-import { ALL_CI_CHECK_CATEGORIES, CI_CHECK_CATEGORY_LABELS } from "./ci-check/types.js";
-import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./implementation/discovery.js";
-import { getImplementationSummary, resolveAllImplementations, resolveImplementations } from "./implementation/resolver.js";
-import { DEFAULT_CACHE_CONFIG } from "./verification-cache/types.js";
-import { VerificationCacheService, cacheKeyToString, computeContentHash, createVerificationCacheService, stringToCacheKey } from "./verification-cache/cache-service.js";
-import { InMemoryCacheStorage, createInMemoryCacheStorage } from "./verification-cache/adapters/in-memory.js";
-import { FileSystemCacheStorage, createFileSystemCacheStorage } from "./verification-cache/adapters/filesystem.js";
-import { WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage } from "./verification-cache/adapters/workspace-state.js";
-import "./verification-cache/index.js";
-import { runCIChecks } from "./ci-check/ci-check-service.js";
-import "./ci-check/index.js";
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./agent-guide/adapters/claude-code.js";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./agent-guide/adapters/cursor-cli.js";
-import { GenericMCPAdapter, genericMCPAdapter } from "./agent-guide/adapters/generic-mcp.js";
-import { agentAdapters, getAgentAdapter, listAgentTypes } from "./agent-guide/adapters/index.js";
-import { AgentGuideService, agentGuideService, createAgentGuideService } from "./agent-guide/agent-guide-service.js";
-import "./agent-guide/index.js";
-import { verifyStructure } from "./verify/structure-verifier.js";
-import { verifyBehavior } from "./verify/behavior-verifier.js";
-import { createQuickAIReview, verifySemanticFields, verifyWithAI, verifyWithAIEnhanced } from "./verify/ai-verifier.js";
-import { VerifyService, createVerifyService, verifyService } from "./verify/verify-service.js";
-import "./verify/index.js";
-import "./implementation/index.js";

package/dist/services/integrity-diagram.js

@@ -1,274 +0,0 @@
-//#region src/services/integrity-diagram.ts
-/**
-* Generate a Mermaid diagram from integrity analysis results.
-*/
-function generateMermaidDiagram(result, type = "feature-map", options = {}) {
-	switch (type) {
-		case "feature-map": return generateFeatureMapDiagram(result, options);
-		case "orphans": return generateOrphansDiagram(result, options);
-		case "dependencies": return generateDependenciesDiagram(result, options);
-		case "full": return generateFullDiagram(result, options);
-		default: return generateFeatureMapDiagram(result, options);
-	}
-}
-/**
-* Generate a feature map diagram showing features and their linked specs.
-*/
-function generateFeatureMapDiagram(result, options) {
-	const { direction = "LR", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	let features = result.features;
-	if (options.featureKeys && options.featureKeys.length > 0) features = features.filter((f) => options.featureKeys.includes(f.key));
-	let nodeCount = 0;
-	if (features.length > 0) {
-		lines.push("    subgraph features [Features]");
-		for (const feature of features) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`F_${feature.key}`);
-			const label = feature.title ?? feature.key;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const ops = getReferencedSpecs(features, "operations", result.inventory);
-	if (ops.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph ops [Operations]");
-		for (const op of ops) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`O_${op.name}_v${op.version}`);
-			const label = showVersions ? `${op.name}.v${op.version}` : op.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const events = getReferencedSpecs(features, "events", result.inventory);
-	if (events.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph events [Events]");
-		for (const event of events) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`E_${event.name}_v${event.version}`);
-			const label = showVersions ? `${event.name}.v${event.version}` : event.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const presentations = getReferencedSpecs(features, "presentations", result.inventory);
-	if (presentations.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph presentations [Presentations]");
-		for (const pres of presentations) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			const label = showVersions ? `${pres.name}.v${pres.version}` : pres.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	for (const feature of features) {
-		const featureId = sanitizeId(`F_${feature.key}`);
-		for (const op of feature.operations) {
-			const opId = sanitizeId(`O_${op.name}_v${op.version}`);
-			lines.push(`    ${featureId} --> ${opId}`);
-		}
-		for (const event of feature.events) {
-			const eventId = sanitizeId(`E_${event.name}_v${event.version}`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-		}
-		for (const pres of feature.presentations) {
-			const presId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			lines.push(`    ${featureId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a diagram highlighting orphaned specs.
-*/
-function generateOrphansDiagram(result, options) {
-	const { direction = "TB", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	const linkedOps = /* @__PURE__ */ new Set();
-	const linkedEvents = /* @__PURE__ */ new Set();
-	const linkedPres = /* @__PURE__ */ new Set();
-	for (const feature of result.features) {
-		for (const op of feature.operations) linkedOps.add(`${op.name}.v${op.version}`);
-		for (const event of feature.events) linkedEvents.add(`${event.name}.v${event.version}`);
-		for (const pres of feature.presentations) linkedPres.add(`${pres.name}.v${pres.version}`);
-	}
-	let nodeCount = 0;
-	if (result.features.length > 0) {
-		lines.push("    subgraph features [Features]");
-		for (const feature of result.features) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`F_${feature.key}`);
-			lines.push(`        ${nodeId}["${escapeLabel(feature.title ?? feature.key)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	if (result.orphanedSpecs.length > 0) {
-		lines.push("    subgraph orphaned [Orphaned Specs]");
-		for (const spec of result.orphanedSpecs) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`orphan_${spec.type}_${spec.name}_v${spec.version}`);
-			const label = showVersions ? `${spec.name}.v${spec.version}` : spec.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const allLinked = [];
-	for (const key of linkedOps) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "operation",
-			name,
-			version
-		});
-	}
-	for (const key of linkedEvents) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "event",
-			name,
-			version
-		});
-	}
-	for (const key of linkedPres) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "presentation",
-			name,
-			version
-		});
-	}
-	if (allLinked.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph linked [Linked Specs]");
-		for (const spec of allLinked) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`${spec.type}_${spec.name}_v${spec.version}`);
-			const label = showVersions ? `${spec.name}.v${spec.version}` : spec.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	for (const feature of result.features) {
-		const featureId = sanitizeId(`F_${feature.key}`);
-		for (const op of feature.operations) {
-			const opId = sanitizeId(`operation_${op.name}_v${op.version}`);
-			lines.push(`    ${featureId} --> ${opId}`);
-		}
-		for (const event of feature.events) {
-			const eventId = sanitizeId(`event_${event.name}_v${event.version}`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-		}
-		for (const pres of feature.presentations) {
-			const presId = sanitizeId(`presentation_${pres.name}_v${pres.version}`);
-			lines.push(`    ${featureId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a dependency diagram showing spec relationships.
-*/
-function generateDependenciesDiagram(result, options) {
-	const { direction = "TB", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	let nodeCount = 0;
-	for (const feature of result.features) {
-		if (nodeCount >= maxNodes) break;
-		const featureId = sanitizeId(`F_${feature.key}`);
-		lines.push(`    ${featureId}["${escapeLabel(feature.title ?? feature.key)}"]`);
-		nodeCount++;
-		for (const op of feature.operations) {
-			if (nodeCount >= maxNodes) break;
-			const opId = sanitizeId(`O_${op.name}_v${op.version}`);
-			const label = showVersions ? `${op.name}.v${op.version}` : op.name;
-			lines.push(`    ${opId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} --> ${opId}`);
-			nodeCount++;
-		}
-		for (const event of feature.events) {
-			if (nodeCount >= maxNodes) break;
-			const eventId = sanitizeId(`E_${event.name}_v${event.version}`);
-			const label = showVersions ? `${event.name}.v${event.version}` : event.name;
-			lines.push(`    ${eventId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-			nodeCount++;
-		}
-		for (const pres of feature.presentations) {
-			if (nodeCount >= maxNodes) break;
-			const presId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			const label = showVersions ? `${pres.name}.v${pres.version}` : pres.name;
-			lines.push(`    ${presId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} --> ${presId}`);
-			nodeCount++;
-		}
-		for (const link of feature.opToPresentationLinks) {
-			const opId = sanitizeId(`O_${link.op.name}_v${link.op.version}`);
-			const presId = sanitizeId(`P_${link.pres.name}_v${link.pres.version}`);
-			lines.push(`    ${opId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a full diagram with all relationships.
-*/
-function generateFullDiagram(result, options) {
-	const featureMap = generateFeatureMapDiagram(result, options);
-	if (result.orphanedSpecs.length === 0) return featureMap;
-	const lines = featureMap.split("\n");
-	lines.push("    subgraph orphaned [Orphaned Specs]");
-	for (const spec of result.orphanedSpecs.slice(0, 20)) {
-		const nodeId = sanitizeId(`orphan_${spec.type}_${spec.name}_v${spec.version}`);
-		const label = `${spec.name}.v${spec.version}`;
-		lines.push(`        ${nodeId}["${escapeLabel(label)}"]:::orphan`);
-	}
-	lines.push("    end");
-	lines.push("    classDef orphan stroke-dasharray: 5 5");
-	return lines.join("\n");
-}
-/**
-* Get referenced specs from features.
-*/
-function getReferencedSpecs(features, field, _inventory) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
-	for (const feature of features) for (const ref of feature[field]) {
-		const key = `${ref.name}.v${ref.version}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			result.push(ref);
-		}
-	}
-	return result;
-}
-/**
-* Parse a spec key like "name.v1" into [name, version].
-*/
-function parseSpecKey(key) {
-	const match = key.match(/^(.+)\.v(\d+)$/);
-	if (!match) return [void 0, void 0];
-	return [match[1], Number(match[2])];
-}
-/**
-* Sanitize an ID for use in Mermaid.
-*/
-function sanitizeId(id) {
-	return id.replace(/[^a-zA-Z0-9_]/g, "_");
-}
-/**
-* Escape a label for use in Mermaid.
-*/
-function escapeLabel(label) {
-	return label.replace(/"/g, "'").replace(/\[/g, "(").replace(/\]/g, ")").replace(/\{/g, "(").replace(/\}/g, ")");
-}
-
-//#endregion
-export { generateMermaidDiagram };