@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/dist/ai/agents/orchestrator.js

@@ -1,142 +0,0 @@
-import { SimpleAgent } from "./simple-agent.js";
-import { CursorAgent } from "./cursor-agent.js";
-import { ClaudeCodeAgent } from "./claude-code-agent.js";
-import { OpenAICodexAgent } from "./openai-codex-agent.js";
-import chalk from "chalk";
-import ora from "ora";
-
-//#region src/ai/agents/orchestrator.ts
-/**
-* Agent Orchestrator - Coordinates between different AI agents
-* Selects the appropriate agent based on config and task requirements
-*/
-var AgentOrchestrator = class {
-	agents;
-	defaultAgent;
-	constructor(config) {
-		this.config = config;
-		this.agents = /* @__PURE__ */ new Map();
-		const simpleAgent = new SimpleAgent(config);
-		const cursorAgent = new CursorAgent();
-		const claudeAgent = new ClaudeCodeAgent();
-		const openaiAgent = new OpenAICodexAgent();
-		this.agents.set("simple", simpleAgent);
-		this.agents.set("cursor", cursorAgent);
-		this.agents.set("claude-code", claudeAgent);
-		this.agents.set("openai-codex", openaiAgent);
-		this.defaultAgent = simpleAgent;
-	}
-	/**
-	* Execute a task using the configured agent with fallback support
-	*/
-	async executeTask(task) {
-		const agentMode = this.getAgentMode();
-		const agent = this.agents.get(agentMode);
-		if (!agent) {
-			console.log(chalk.yellow(`⚠️  Agent '${agentMode}' not found, using simple agent`));
-			return this.defaultAgent.generate(task);
-		}
-		if (!agent.canHandle(task)) {
-			console.log(chalk.yellow(`⚠️  Agent '${agentMode}' cannot handle this task, falling back to simple agent`));
-			return this.defaultAgent.generate(task);
-		}
-		const spinner = ora(`Executing with ${agentMode} agent...`).start();
-		try {
-			const result = task.type === "validate" ? await agent.validate(task) : await agent.generate(task);
-			if (result.success) {
-				spinner.succeed(chalk.green(`${agentMode} agent completed successfully`));
-				return result;
-			}
-			spinner.warn(chalk.yellow(`${agentMode} agent failed, trying fallback...`));
-			const fallbackMode = this.getFallbackMode(agentMode);
-			if (fallbackMode && fallbackMode !== agentMode) {
-				const fallbackAgent = this.agents.get(fallbackMode);
-				if (fallbackAgent && fallbackAgent.canHandle(task)) return task.type === "validate" ? await fallbackAgent.validate(task) : await fallbackAgent.generate(task);
-			}
-			spinner.info(chalk.gray("Using simple agent as ultimate fallback"));
-			return task.type === "validate" ? await this.defaultAgent.validate(task) : await this.defaultAgent.generate(task);
-		} catch (error) {
-			spinner.fail(chalk.red("Agent execution failed"));
-			console.log(chalk.gray("Falling back to simple agent..."));
-			return task.type === "validate" ? await this.defaultAgent.validate(task) : await this.defaultAgent.generate(task);
-		}
-	}
-	/**
-	* Generate code from specification
-	*/
-	async generate(specCode, targetPath) {
-		return this.executeTask({
-			type: "generate",
-			specCode,
-			targetPath
-		});
-	}
-	/**
-	* Generate tests for implementation
-	*/
-	async generateTests(specCode, implementationCode) {
-		return this.executeTask({
-			type: "test",
-			specCode,
-			existingCode: implementationCode
-		});
-	}
-	/**
-	* Validate implementation against specification
-	*/
-	async validate(specCode, implementationCode) {
-		return this.executeTask({
-			type: "validate",
-			specCode,
-			existingCode: implementationCode
-		});
-	}
-	/**
-	* Refactor existing code
-	*/
-	async refactor(specCode, existingCode) {
-		return this.executeTask({
-			type: "refactor",
-			specCode,
-			existingCode
-		});
-	}
-	/**
-	* List available agents and their status
-	*/
-	async getAvailableAgents() {
-		const results = [];
-		for (const [mode, agent] of this.agents) {
-			const canHandle = agent.canHandle({
-				type: "generate",
-				specCode: "test"
-			});
-			results.push({
-				mode,
-				available: canHandle,
-				reason: canHandle ? void 0 : "Not configured or dependencies missing"
-			});
-		}
-		return results;
-	}
-	/**
-	* Get the configured agent mode
-	*/
-	getAgentMode() {
-		return this.config.agentMode || "simple";
-	}
-	/**
-	* Get fallback mode for an agent
-	*/
-	getFallbackMode(mode) {
-		return {
-			cursor: "claude-code",
-			"claude-code": "openai-codex",
-			"openai-codex": "simple",
-			simple: "simple"
-		}[mode];
-	}
-};
-
-//#endregion
-export { AgentOrchestrator };

package/dist/ai/agents/simple-agent.js

@@ -1,91 +0,0 @@
-import { getAIProvider } from "../providers.js";
-import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "../prompts/code-generation.js";
-import { generateText } from "ai";
-
-//#region src/ai/agents/simple-agent.ts
-/**
-* Simple LLM-based agent using direct API calls
-* This is the default fallback for basic code generation
-*/
-var SimpleAgent = class {
-	name = "simple";
-	constructor(config) {
-		this.config = config;
-	}
-	canHandle(task) {
-		return true;
-	}
-	async generate(task) {
-		try {
-			const result = await generateText({
-				model: getAIProvider(this.config),
-				prompt: this.buildPrompt(task),
-				system: getCodeGenSystemPrompt()
-			});
-			return {
-				success: true,
-				code: result.text,
-				metadata: {
-					model: this.config.aiModel,
-					provider: this.config.aiProvider,
-					tokens: result.usage
-				}
-			};
-		} catch (error) {
-			return {
-				success: false,
-				errors: [error instanceof Error ? error.message : String(error)]
-			};
-		}
-	}
-	async validate(task) {
-		try {
-			const result = await generateText({
-				model: getAIProvider(this.config),
-				prompt: `
-Review the following implementation against its specification.
-
-Specification:
-${task.specCode}
-
-Implementation:
-${task.existingCode || "// No implementation provided"}
-
-Provide a detailed validation report:
-1. Does the implementation match the spec?
-2. Are there any missing features?
-3. Are there any bugs or issues?
-4. Suggestions for improvement
-`,
-				system: "You are a code review expert. Provide thorough, constructive feedback."
-			});
-			const hasErrors = result.text.toLowerCase().includes("error") || result.text.toLowerCase().includes("missing") || result.text.toLowerCase().includes("incorrect");
-			return {
-				success: !hasErrors,
-				code: result.text,
-				warnings: hasErrors ? ["Implementation may not match specification"] : [],
-				metadata: { validationType: "simple-llm" }
-			};
-		} catch (error) {
-			return {
-				success: false,
-				errors: [error instanceof Error ? error.message : String(error)]
-			};
-		}
-	}
-	buildPrompt(task) {
-		switch (task.type) {
-			case "generate":
-				if (task.specCode.includes(".contracts.") || task.specCode.includes("kind:")) return buildHandlerPrompt(task.specCode);
-				else if (task.specCode.includes(".presentation.")) return buildComponentPrompt(task.specCode);
-				else if (task.specCode.includes(".form.")) return buildFormPrompt(task.specCode);
-				return `Generate implementation for:\n${task.specCode}`;
-			case "test": return buildTestPrompt(task.specCode, task.existingCode || "", "handler");
-			case "validate": return `Validate this implementation:\n${task.existingCode}`;
-			default: return task.specCode;
-		}
-	}
-};
-
-//#endregion
-export { SimpleAgent };

package/dist/ai/client.js

@@ -1,162 +0,0 @@
-import { getAIProvider } from "./providers.js";
-import { buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt } from "./prompts/spec-creation.js";
-import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "./prompts/code-generation.js";
-import { generateObject, generateText, streamText } from "ai";
-import * as z$1 from "zod";
-
-//#region src/ai/client.ts
-/**
-* AI Client for spec creation and code generation
-*/
-var AIClient = class {
-	constructor(config) {
-		this.config = config;
-	}
-	/**
-	* Generate operation spec from natural language description
-	*/
-	async generateOperationSpec(description, kind) {
-		return (await generateObject({
-			model: getAIProvider(this.config),
-			schema: z$1.object({
-				name: z$1.string().describe("Dot notation name like \"domain.operation\""),
-				version: z$1.number().int().positive().default(1),
-				description: z$1.string().describe("Clear, concise summary"),
-				goal: z$1.string().describe("Business purpose"),
-				context: z$1.string().describe("Background and constraints"),
-				stability: z$1.enum([
-					"experimental",
-					"beta",
-					"stable",
-					"deprecated"
-				]).default("beta"),
-				owners: z$1.array(z$1.string()).describe("Team/person owners with @ prefix"),
-				tags: z$1.array(z$1.string()).describe("Categorization tags"),
-				auth: z$1.enum([
-					"anonymous",
-					"user",
-					"admin"
-				]).describe("Required auth level"),
-				inputShape: z$1.string().describe("Description of input structure"),
-				outputShape: z$1.string().describe("Description of output structure"),
-				flags: z$1.array(z$1.string()).describe("Feature flags").default([]),
-				possibleEvents: z$1.array(z$1.string()).describe("Events this may emit").default([]),
-				analytics: z$1.array(z$1.string()).describe("Analytics events to track").default([])
-			}),
-			prompt: buildOperationSpecPrompt(description, kind),
-			system: getSystemPrompt()
-		})).object;
-	}
-	/**
-	* Generate event spec from description
-	*/
-	async generateEventSpec(description) {
-		return (await generateObject({
-			model: getAIProvider(this.config),
-			schema: z$1.object({
-				name: z$1.string().describe("Dot notation name like \"domain.event_name\""),
-				version: z$1.number().int().positive().default(1),
-				description: z$1.string().describe("When this event is emitted"),
-				stability: z$1.enum([
-					"experimental",
-					"beta",
-					"stable",
-					"deprecated"
-				]).default("beta"),
-				owners: z$1.array(z$1.string()).default([]),
-				tags: z$1.array(z$1.string()).default([]),
-				payloadShape: z$1.string().describe("Description of event payload"),
-				piiFields: z$1.array(z$1.string()).describe("PII field paths").default([])
-			}),
-			prompt: buildEventSpecPrompt(description),
-			system: getSystemPrompt()
-		})).object;
-	}
-	/**
-	* Generate presentation spec from description
-	*/
-	async generatePresentationSpec(description, kind) {
-		return (await generateObject({
-			model: getAIProvider(this.config),
-			schema: z$1.object({
-				name: z$1.string(),
-				version: z$1.number().int().positive().default(1),
-				description: z$1.string(),
-				stability: z$1.enum([
-					"experimental",
-					"beta",
-					"stable",
-					"deprecated"
-				]).default("beta"),
-				owners: z$1.array(z$1.string()).default([]),
-				tags: z$1.array(z$1.string()).default([]),
-				componentKey: z$1.string().optional(),
-				propsShape: z$1.string().optional(),
-				content: z$1.string().optional(),
-				mimeType: z$1.string().optional(),
-				dataShape: z$1.string().optional()
-			}),
-			prompt: buildPresentationSpecPrompt(description, kind),
-			system: getSystemPrompt()
-		})).object;
-	}
-	/**
-	* Generate handler implementation from spec
-	*/
-	async generateHandler(specCode) {
-		return (await generateText({
-			model: getAIProvider(this.config),
-			prompt: buildHandlerPrompt(specCode),
-			system: getCodeGenSystemPrompt()
-		})).text;
-	}
-	/**
-	* Generate React component from presentation spec
-	*/
-	async generateComponent(specCode) {
-		return (await generateText({
-			model: getAIProvider(this.config),
-			prompt: buildComponentPrompt(specCode),
-			system: getCodeGenSystemPrompt()
-		})).text;
-	}
-	/**
-	* Generate form component from form spec
-	*/
-	async generateForm(specCode) {
-		return (await generateText({
-			model: getAIProvider(this.config),
-			prompt: buildFormPrompt(specCode),
-			system: getCodeGenSystemPrompt()
-		})).text;
-	}
-	/**
-	* Generate tests for implementation
-	*/
-	async generateTests(specCode, implementationCode, testType) {
-		return (await generateText({
-			model: getAIProvider(this.config),
-			prompt: buildTestPrompt(specCode, implementationCode, testType),
-			system: getCodeGenSystemPrompt()
-		})).text;
-	}
-	/**
-	* Stream code generation for better UX
-	*/
-	async streamCodeGeneration(prompt, onChunk) {
-		const result = await streamText({
-			model: getAIProvider(this.config),
-			prompt,
-			system: getCodeGenSystemPrompt()
-		});
-		let fullText = "";
-		for await (const chunk of result.textStream) {
-			fullText += chunk;
-			onChunk(chunk);
-		}
-		return fullText;
-	}
-};
-
-//#endregion
-export { AIClient };

package/dist/ai/index.js

@@ -1,27 +0,0 @@
-import { __export } from "../_virtual/rolldown_runtime.js";
-import { getAIProvider, getRecommendedModels, validateProvider } from "./providers.js";
-import { AIClient } from "./client.js";
-import { SimpleAgent } from "./agents/simple-agent.js";
-import { CursorAgent } from "./agents/cursor-agent.js";
-import { ClaudeCodeAgent } from "./agents/claude-code-agent.js";
-import { OpenAICodexAgent } from "./agents/openai-codex-agent.js";
-import { AgentOrchestrator } from "./agents/orchestrator.js";
-import "./agents/index.js";
-import { prompts_exports } from "./prompts/index.js";
-
-//#region src/ai/index.ts
-var ai_exports = /* @__PURE__ */ __export({
-	AIClient: () => AIClient,
-	AgentOrchestrator: () => AgentOrchestrator,
-	ClaudeCodeAgent: () => ClaudeCodeAgent,
-	CursorAgent: () => CursorAgent,
-	OpenAICodexAgent: () => OpenAICodexAgent,
-	SimpleAgent: () => SimpleAgent,
-	getAIProvider: () => getAIProvider,
-	getRecommendedModels: () => getRecommendedModels,
-	prompts: () => prompts_exports,
-	validateProvider: () => validateProvider
-});
-
-//#endregion
-export { ai_exports };

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

@@ -1,142 +0,0 @@
-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
-${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, code_generation_exports, getCodeGenSystemPrompt };

package/dist/ai/prompts/index.js

@@ -1,12 +0,0 @@
-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,110 +0,0 @@
-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:
-
-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 { buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt, spec_creation_exports };