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

package/dist/modules/contractspec-workspace/dist/ai/code-generation.js

@@ -1,137 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/ai/code-generation.js
-/**
-* AI prompts for code generation.
-* Extracted from cli-contracts/src/ai/prompts/code-generation.ts
-*/
-/**
-* 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
-${specCode}
-\`\`\`
-
-Generate a complete handler implementation that:
-
-1. **Matches the spec signature**: Input/output types from the spec
-2. **Handles errors**: Implement error cases defined in spec.io.errors
-3. **Emits events**: Use the events declared in spec.sideEffects.emits
-4. **Validates input**: Use zod validation from the schema
-5. **Follows best practices**: Clean, type-safe TypeScript
-6. **Includes comments**: Explain business logic
-
-The handler should be production-ready with proper error handling, logging points, and clear structure.
-
-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
-${specCode}
-\`\`\`
-
-Generate a complete React component that:
-
-1. **Props interface**: Typed props from the spec
-2. **Accessibility**: Proper ARIA labels, roles, keyboard navigation
-3. **Mobile-first**: Optimized for small screens and touch
-4. **Clean UI**: Simple, intuitive interface
-5. **Type-safe**: Full TypeScript with no 'any' types
-6. **Best practices**: React hooks, proper state management
-
-The component should follow Atomic Design principles and be reusable.
-
-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
-${specCode}
-\`\`\`
-
-Generate a complete form component using react-hook-form that:
-
-1. **Form validation**: Use zod schema for validation
-2. **Field types**: Proper inputs for each field type
-3. **Conditional logic**: Support visibleWhen, enabledWhen, requiredWhen predicates
-4. **Error handling**: Clear, user-friendly error messages
-5. **Accessibility**: Labels, hints, ARIA attributes
-6. **Mobile-optimized**: Touch-friendly, appropriate input types
-7. **Type-safe**: Full TypeScript
-
-The form should provide excellent UX with real-time validation and helpful feedback.
-
-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
-${specCode}
-\`\`\`
-
-Implementation:
-\`\`\`typescript
-${implementationCode}
-\`\`\`
-
-Generate complete test suite using Vitest that:
-${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 rendering with various props
-  - Test user interactions
-  - Test accessibility (a11y)
-  - Test responsive behavior
-  - Test error states`}
-
-Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
-
-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
-- Accessibility best practices
-- Clean code principles
-
-Generate production-ready code that is:
-- Fully typed (no 'any' or type assertions unless absolutely necessary)
-- Well-documented with TSDoc comments
-- Following project conventions
-- Defensive and error-safe
-- Easy to maintain and extend
-
-Always prioritize code quality, safety, and user experience.`;
-}
-
-//#endregion
-export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt };

package/dist/modules/contractspec-workspace/dist/ai/spec-creation.js

@@ -1,101 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/ai/spec-creation.js
-/**
-* 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:
-
-1. **Name**: Use dot notation like "domain.operationName" (e.g., "user.signup", "payment.charge")
-2. **Version**: Start at 1
-3. **Description**: Clear, concise summary (1-2 sentences)
-4. **Goal**: Business purpose - why this operation exists
-5. **Context**: Background, constraints, scope (what it does and doesn't do)
-6. **Input/Output**: Describe the shape (we'll create schemas separately)
-7. **Auth**: Who can call this - anonymous, user, or admin
-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.`;
-}
-/**
-* Build prompt for creating event spec from description.
-*/
-function buildEventSpecPrompt(description) {
-	return `You are a senior software architect creating an event specification.
-
-User description: ${description}
-
-Create a complete event specification following these guidelines:
-
-1. **Name**: Use dot notation like "domain.event_name" (e.g., "user.signup_completed", "payment.charged")
-2. **Version**: Start at 1
-3. **Description**: Clear description of when this event is emitted
-4. **Payload**: Describe what data the event carries
-5. **PII Fields**: List any personally identifiable information fields (e.g., ["email", "name"])
-
-Events represent things that have already happened and should use past tense.
-
-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 ${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: ${description}
-
-Create a complete presentation specification following these guidelines:
-
-1. **Name**: Use dot notation like "domain.presentation_name" (e.g., "user.profile_card", "docs.api_guide")
-2. **Version**: Start at 1
-3. **Description**: What this presentation shows/provides
-4. **Kind-specific details**:
-   ${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.`;
-}
-/**
-* 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.
-
-Your specs are:
-- Precise and unambiguous
-- Following TypeScript conventions
-- 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.`;
-}
-/**
-* 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:
-
-${examples.join("\n\n")}
-
-Follow this structure and quality level.`;
-}
-
-//#endregion
-export { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt };

package/dist/modules/contractspec-workspace/dist/analysis/deps/graph.js

@@ -1,84 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/analysis/deps/graph.js
-/**
-* Build reverse edges (dependents) for all nodes in the graph.
-*/
-function buildReverseEdges(graph) {
-	for (const node of graph.values()) node.dependents = [];
-	for (const [name, node] of graph) for (const dep of node.dependencies) {
-		const depNode = graph.get(dep);
-		if (depNode) depNode.dependents.push(name);
-	}
-	for (const node of graph.values()) node.dependents.sort((a, b) => a.localeCompare(b));
-}
-/**
-* Detect circular dependencies in the graph.
-*/
-function detectCycles(graph) {
-	const visited = /* @__PURE__ */ new Set();
-	const stack = /* @__PURE__ */ new Set();
-	const cycles = [];
-	function dfs(name, path) {
-		if (stack.has(name)) {
-			const start = path.indexOf(name);
-			if (start >= 0) cycles.push([...path.slice(start), name]);
-			return;
-		}
-		if (visited.has(name)) return;
-		visited.add(name);
-		stack.add(name);
-		const node = graph.get(name);
-		if (node) for (const dep of node.dependencies) dfs(dep, [...path, name]);
-		stack.delete(name);
-	}
-	for (const name of graph.keys()) if (!visited.has(name)) dfs(name, []);
-	return cycles;
-}
-/**
-* Find missing dependencies (referenced but not defined).
-*/
-function findMissingDependencies(graph) {
-	const missing = [];
-	for (const [name, node] of graph) {
-		const absent = node.dependencies.filter((dep) => !graph.has(dep));
-		if (absent.length > 0) missing.push({
-			contract: name,
-			missing: absent
-		});
-	}
-	return missing;
-}
-/**
-* Generate DOT format output for visualization.
-*/
-function toDot(graph) {
-	const lines = [];
-	lines.push("digraph ContractDependencies {");
-	lines.push("  rankdir=LR;");
-	lines.push("  node [shape=box];");
-	for (const [name, node] of graph) {
-		for (const dep of node.dependencies) lines.push(`  "${name}" -> "${dep}";`);
-		if (node.dependencies.length === 0) lines.push(`  "${name}";`);
-	}
-	lines.push("}");
-	return lines.join("\n");
-}
-/**
-* Create an empty contract graph.
-*/
-function createContractGraph() {
-	return /* @__PURE__ */ new Map();
-}
-/**
-* Add a node to the contract graph.
-*/
-function addContractNode(graph, name, file, dependencies) {
-	graph.set(name, {
-		name,
-		file,
-		dependencies,
-		dependents: []
-	});
-}
-
-//#endregion
-export { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot };

package/dist/modules/contractspec-workspace/dist/analysis/deps/parse-imports.js

@@ -1,30 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/analysis/deps/parse-imports.js
-/**
-* Import parsing utilities for dependency analysis.
-* Extracted from cli-contracts/src/commands/deps/parse-imports.ts
-*/
-/**
-* Parse spec imports from source code.
-* Returns the names of imported specs based on file naming conventions.
-*
-* @param sourceCode - The source code to parse
-* @param fromFilePath - The path of the file being parsed (for relative resolution)
-* @returns Array of imported spec names
-*/
-function parseImportedSpecNames(sourceCode, _fromFilePath) {
-	const imports = [];
-	const importRegex = /import\s+.*?\s+from\s+['"]([^'"]+\.(?:contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)(?:\.[jt]s)?)['"]/g;
-	let match;
-	while ((match = importRegex.exec(sourceCode)) !== null) {
-		const importPath = match[1];
-		if (!importPath) continue;
-		if (!importPath.startsWith(".") && !importPath.startsWith("/")) continue;
-		const pathParts = importPath.split("/");
-		const name = (pathParts[pathParts.length - 1] ?? "").replace(/\.(ts|js)$/, "").replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/, "");
-		if (name.length > 0) imports.push(name);
-	}
-	return Array.from(new Set(imports)).sort((a, b) => a.localeCompare(b));
-}
-
-//#endregion
-export { parseImportedSpecNames };

package/dist/modules/contractspec-workspace/dist/analysis/diff/semantic.js

@@ -1,96 +0,0 @@
-import { scanSpecSource } from "../spec-scan.js";
-
-//#region ../../modules/contractspec-workspace/dist/analysis/diff/semantic.js
-/**
-* Compute semantic differences between two spec sources.
-*/
-function computeSemanticDiff(aCode, aPath, bCode, bPath, options = {}) {
-	const a = scanSpecSource(aCode, aPath);
-	const b = scanSpecSource(bCode, bPath);
-	const diffs = [];
-	compareScalar(diffs, "specType", a.specType, b.specType, {
-		breaking: true,
-		label: "Spec type"
-	});
-	compareScalar(diffs, "name", a.name, b.name, {
-		breaking: true,
-		label: "Name"
-	});
-	compareScalar(diffs, "version", a.version, b.version, {
-		breaking: true,
-		label: "Version"
-	});
-	compareScalar(diffs, "kind", a.kind, b.kind, {
-		breaking: true,
-		label: "Kind"
-	});
-	compareScalar(diffs, "stability", a.stability, b.stability, {
-		breaking: isStabilityDowngrade(a, b),
-		label: "Stability"
-	});
-	compareArray(diffs, "owners", a.owners ?? [], b.owners ?? [], { label: "Owners" });
-	compareArray(diffs, "tags", a.tags ?? [], b.tags ?? [], { label: "Tags" });
-	compareStructuralHints(diffs, a, b);
-	return options.breakingOnly ? diffs.filter((d) => d.type === "breaking") : diffs;
-}
-function compareScalar(diffs, path, a, b, config) {
-	if (a === b) return;
-	diffs.push({
-		type: config.breaking ? "breaking" : "changed",
-		path,
-		oldValue: a,
-		newValue: b,
-		description: `${config.label} changed`
-	});
-}
-function compareArray(diffs, path, a, b, config) {
-	const aSorted = [...a].sort();
-	const bSorted = [...b].sort();
-	if (JSON.stringify(aSorted) === JSON.stringify(bSorted)) return;
-	diffs.push({
-		type: "changed",
-		path,
-		oldValue: aSorted,
-		newValue: bSorted,
-		description: `${config.label} changed`
-	});
-}
-function isStabilityDowngrade(a, b) {
-	const order = {
-		experimental: 0,
-		beta: 1,
-		stable: 2,
-		deprecated: 3
-	};
-	const aValue = a.stability ? order[a.stability] ?? 0 : 0;
-	return (b.stability ? order[b.stability] ?? 0 : 0) > aValue;
-}
-function compareStructuralHints(diffs, a, b) {
-	compareScalar(diffs, "hasMeta", a.hasMeta, b.hasMeta, {
-		breaking: a.specType === "operation" || b.specType === "operation",
-		label: "meta section presence"
-	});
-	compareScalar(diffs, "hasIo", a.hasIo, b.hasIo, {
-		breaking: a.specType === "operation" || b.specType === "operation",
-		label: "io section presence"
-	});
-	compareScalar(diffs, "hasPolicy", a.hasPolicy, b.hasPolicy, {
-		breaking: a.specType === "operation" || b.specType === "operation",
-		label: "policy section presence"
-	});
-	compareScalar(diffs, "hasPayload", a.hasPayload, b.hasPayload, {
-		breaking: a.specType === "event" || b.specType === "event",
-		label: "payload section presence"
-	});
-	compareScalar(diffs, "hasContent", a.hasContent, b.hasContent, {
-		breaking: a.specType === "presentation" || b.specType === "presentation",
-		label: "content section presence"
-	});
-	compareScalar(diffs, "hasDefinition", a.hasDefinition, b.hasDefinition, {
-		breaking: a.specType === "workflow" || b.specType === "workflow",
-		label: "definition section presence"
-	});
-}
-
-//#endregion
-export { computeSemanticDiff };

package/dist/modules/contractspec-workspace/dist/analysis/feature-scan.js

@@ -1,151 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/analysis/feature-scan.js
-/**
-* Check if a file is a feature file based on naming conventions.
-*/
-function isFeatureFile(filePath) {
-	return filePath.includes(".feature.");
-}
-/**
-* Scan a feature source file to extract metadata.
-*/
-function scanFeatureSource(code, filePath) {
-	const key = matchStringField(code, "key") ?? extractKeyFromFilePath(filePath);
-	const title = matchStringField(code, "title") ?? void 0;
-	const description = matchStringField(code, "description") ?? void 0;
-	const domain = matchStringField(code, "domain") ?? void 0;
-	const stabilityRaw = matchStringField(code, "stability");
-	return {
-		filePath,
-		key,
-		title,
-		description,
-		domain,
-		stability: isStability(stabilityRaw) ? stabilityRaw : void 0,
-		owners: matchStringArrayField(code, "owners"),
-		tags: matchStringArrayField(code, "tags"),
-		operations: extractRefsFromArray(code, "operations"),
-		events: extractRefsFromArray(code, "events"),
-		presentations: extractRefsFromArray(code, "presentations"),
-		experiments: extractRefsFromArray(code, "experiments"),
-		capabilities: extractCapabilities(code),
-		opToPresentationLinks: extractOpToPresentationLinks(code)
-	};
-}
-/**
-* Extract refs from a named array (e.g., operations, events, presentations).
-*/
-function extractRefsFromArray(code, fieldName) {
-	const refs = [];
-	const arrayPattern = new RegExp(`${escapeRegex(fieldName)}\\s*:\\s*\\[([\\s\\S]*?)\\]`, "m");
-	const arrayMatch = code.match(arrayPattern);
-	if (!arrayMatch?.[1]) return refs;
-	const refPattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-	let match;
-	while ((match = refPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2]) refs.push({
-		name: match[1],
-		version: Number(match[2])
-	});
-	return refs;
-}
-/**
-* Extract capability bindings (provides and requires).
-*/
-function extractCapabilities(code) {
-	const provides = [];
-	const requires = [];
-	const capabilitiesMatch = code.match(/capabilities\s*:\s*\{([\s\S]*?)\}/);
-	if (!capabilitiesMatch?.[1]) return {
-		provides,
-		requires
-	};
-	const capabilitiesContent = capabilitiesMatch[1];
-	const providesMatch = capabilitiesContent.match(/provides\s*:\s*\[([\s\S]*?)\]/);
-	if (providesMatch?.[1]) {
-		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-		let match;
-		while ((match = refPattern.exec(providesMatch[1])) !== null) if (match[1] && match[2]) provides.push({
-			name: match[1],
-			version: Number(match[2])
-		});
-	}
-	const requiresMatch = capabilitiesContent.match(/requires\s*:\s*\[([\s\S]*?)\]/);
-	if (requiresMatch?.[1]) {
-		const refPatternWithVersion = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-		const refPatternKeyOnly = /\{\s*key:\s*['"]([^'"]+)['"]\s*\}/g;
-		let match = null;
-		while ((match = refPatternWithVersion.exec(requiresMatch[1])) !== null) if (match[1] && match[2]) requires.push({
-			name: match[1],
-			version: Number(match[2])
-		});
-		while ((match = refPatternKeyOnly.exec(requiresMatch[1])) !== null) if (match && match[1]) {
-			if (!requires.some((r) => r.name === match[1])) requires.push({
-				name: match[1],
-				version: 1
-			});
-		}
-	}
-	return {
-		provides,
-		requires
-	};
-}
-/**
-* Extract opToPresentation links.
-*/
-function extractOpToPresentationLinks(code) {
-	const links = [];
-	const arrayMatch = code.match(/opToPresentation\s*:\s*\[([\s\S]*?)\]/);
-	if (!arrayMatch?.[1]) return links;
-	const linkPattern = /\{\s*op:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}\s*,\s*pres:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}/g;
-	let match;
-	while ((match = linkPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2] && match[3] && match[4]) links.push({
-		op: {
-			name: match[1],
-			version: Number(match[2])
-		},
-		pres: {
-			name: match[3],
-			version: Number(match[4])
-		}
-	});
-	return links;
-}
-/**
-* Extract key from file path as fallback.
-*/
-function extractKeyFromFilePath(filePath) {
-	return (filePath.split("/").pop() ?? filePath).replace(/\.feature\.[jt]s$/, "").replace(/[^a-zA-Z0-9-]/g, "-");
-}
-/**
-* Match a string field in source code.
-*/
-function matchStringField(code, field) {
-	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
-	return code.match(regex)?.[1] ?? null;
-}
-/**
-* Match a string array field in source code.
-*/
-function matchStringArrayField(code, field) {
-	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
-	const match = code.match(regex);
-	if (!match?.[1]) return void 0;
-	const inner = match[1];
-	const items = Array.from(inner.matchAll(/['"]([^'"]+)['"]/g)).map((m) => m[1]).filter((value) => typeof value === "string" && value.length > 0);
-	return items.length > 0 ? items : void 0;
-}
-/**
-* Check if a value is a valid stability.
-*/
-function isStability(value) {
-	return value === "experimental" || value === "beta" || value === "stable" || value === "deprecated";
-}
-/**
-* Escape regex special characters.
-*/
-function escapeRegex(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-//#endregion
-export { isFeatureFile, scanFeatureSource };