pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/code-generation/src/templates/registry.ts

@@ -0,0 +1,174 @@
+/**
+ * Code Generation Pipeline - Template Registry
+ *
+ * Registry for managing templates.
+ */
+
+import type {
+	RegistryEntry,
+	RegistryQuery,
+	Template,
+	TemplateSet,
+} from "../types.js";
+
+// ─── Template Registry ────────────────────────────────────────────────────
+
+export class TemplateRegistry {
+	private templates: Map<string, Template> = new Map();
+	private sets: Map<string, TemplateSet> = new Map();
+
+	/**
+	 * Register a template
+	 */
+	register(template: Template): void {
+		this.templates.set(template.id, template);
+	}
+
+	/**
+	 * Register multiple templates
+	 */
+	registerAll(templates: Template[]): void {
+		for (const template of templates) {
+			this.register(template);
+		}
+	}
+
+	/**
+	 * Register a template set
+	 */
+	registerSet(set: TemplateSet): void {
+		this.sets.set(set.id, set);
+		for (const template of set.templates) {
+			this.register(template);
+		}
+	}
+
+	/**
+	 * Get a template by ID
+	 */
+	get(id: string): Template | undefined {
+		return this.templates.get(id);
+	}
+
+	/**
+	 * Get a template set by ID
+	 */
+	getSet(id: string): TemplateSet | undefined {
+		return this.sets.get(id);
+	}
+
+	/**
+	 * List all templates
+	 */
+	list(): Template[] {
+		return Array.from(this.templates.values());
+	}
+
+	/**
+	 * List all template sets
+	 */
+	listSets(): TemplateSet[] {
+		return Array.from(this.sets.values());
+	}
+
+	/**
+	 * Query templates
+	 */
+	query(query: RegistryQuery): Template[] {
+		let results = this.list();
+
+		// Filter by tags
+		if (query.tags && query.tags.length > 0) {
+			results = results.filter((t) =>
+				t.tags?.some((tag) => query.tags?.includes(tag)),
+			);
+		}
+
+		// Filter by language
+		if (query.language) {
+			results = results.filter((t) => t.language === query.language);
+		}
+
+		// Search by name/description
+		if (query.search) {
+			const searchLower = query.search.toLowerCase();
+			results = results.filter(
+				(t) =>
+					t.name.toLowerCase().includes(searchLower) ||
+					t.description.toLowerCase().includes(searchLower),
+			);
+		}
+
+		// Apply limit
+		if (query.limit && query.limit > 0) {
+			results = results.slice(0, query.limit);
+		}
+
+		return results;
+	}
+
+	/**
+	 * List entries (templates and sets)
+	 */
+	listEntries(): RegistryEntry[] {
+		const entries: RegistryEntry[] = [];
+
+		for (const template of this.templates.values()) {
+			entries.push({
+				id: template.id,
+				type: "template",
+				name: template.name,
+				tags: template.tags ?? [],
+				createdAt: template.createdAt,
+			});
+		}
+
+		for (const set of this.sets.values()) {
+			entries.push({
+				id: set.id,
+				type: "template-set",
+				name: set.name,
+				tags: [],
+				createdAt:
+					(set.metadata?.createdAt as string) ?? new Date().toISOString(),
+			});
+		}
+
+		return entries;
+	}
+
+	/**
+	 * Remove a template
+	 */
+	remove(id: string): boolean {
+		return this.templates.delete(id);
+	}
+
+	/**
+	 * Remove a template set
+	 */
+	removeSet(id: string): boolean {
+		const set = this.sets.get(id);
+		if (set) {
+			for (const template of set.templates) {
+				this.templates.delete(template.id);
+			}
+		}
+		return this.sets.delete(id);
+	}
+
+	/**
+	 * Clear all templates
+	 */
+	clear(): void {
+		this.templates.clear();
+		this.sets.clear();
+	}
+
+	/**
+	 * Get template count
+	 */
+	size(): number {
+		return this.templates.size;
+	}
+}

package/packages/code-generation/src/types.ts

@@ -0,0 +1,373 @@
+/**
+ * Code Generation Pipeline - Types
+ *
+ * Core types for code generation from templates.
+ */
+
+// ─── SDK Version ────────────────────────────────────────────────────────────
+
+/**
+ * SDK version for compatibility checks
+ */
+export const SDK_VERSION = "1.0.0";
+
+// ─── Template Types ─────────────────────────────────────────────────────────
+
+/**
+ * Template definition
+ */
+export interface Template {
+	id: string;
+	name: string;
+	description: string;
+	content: string;
+	language?: string;
+	engine: TemplateEngine;
+	variables?: TemplateVariable[];
+	tags?: string[];
+	createdAt: string;
+	updatedAt: string;
+}
+
+/**
+ * Template variable
+ */
+export interface TemplateVariable {
+	name: string;
+	type: "string" | "number" | "boolean" | "array" | "object" | "enum";
+	description?: string;
+	defaultValue?: unknown;
+	required?: boolean;
+	enumValues?: string[];
+	validation?: string;
+}
+
+/**
+ * Template engine
+ */
+export type TemplateEngine = "ejs" | "handlebars" | "mustache" | "custom";
+
+/**
+ * Template set
+ */
+export interface TemplateSet {
+	id: string;
+	name: string;
+	description: string;
+	templates: Template[];
+	metadata?: Record<string, unknown>;
+}
+
+// ─── Generation Types ────────────────────────────────────────────────────────
+
+/**
+ * Generation request
+ */
+export interface GenerationRequest {
+	templateId?: string;
+	schemaId?: string;
+	template?: Template;
+	variables: Record<string, unknown>;
+	outputPath?: string;
+	dryRun?: boolean;
+	validate?: boolean;
+	overwrite?: boolean;
+}
+
+/**
+ * Generated file
+ */
+export interface GeneratedFile {
+	path: string;
+	content: string;
+	language?: string;
+	size: number;
+	checksum?: string;
+	generatedAt: string;
+}
+
+/**
+ * Generation result
+ */
+export interface GenerationResult {
+	success: boolean;
+	files: GeneratedFile[];
+	errors: GenerationError[];
+	warnings: GenerationWarning[];
+	durationMs: number;
+	dryRun: boolean;
+}
+
+/**
+ * Generation error
+ */
+export interface GenerationError {
+	code: string;
+	message: string;
+	file?: string;
+	line?: number;
+	variable?: string;
+}
+
+/**
+ * Generation warning
+ */
+export interface GenerationWarning {
+	code: string;
+	message: string;
+	file?: string;
+	variable?: string;
+}
+
+// ─── Validation Types ───────────────────────────────────────────────────────
+
+/**
+ * Validation rule
+ */
+export interface ValidationRule {
+	id: string;
+	name: string;
+	description: string;
+	validate: (context: ValidationContext) => ValidationResult;
+	severity: "error" | "warning" | "info";
+	category: ValidationCategory;
+}
+
+/**
+ * Validation category
+ */
+export type ValidationCategory =
+	| "syntax"
+	| "security"
+	| "compatibility"
+	| "best-practice"
+	| "custom";
+
+/**
+ * Validation context
+ */
+export interface ValidationContext {
+	template?: Template;
+	variables: Record<string, unknown>;
+	generatedCode?: string;
+	file?: GeneratedFile;
+}
+
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+	valid: boolean;
+	errors: ValidationIssue[];
+	warnings: ValidationIssue[];
+}
+
+/**
+ * Validation issue
+ */
+export interface ValidationIssue {
+	rule: string;
+	message: string;
+	location?: {
+		line?: number;
+		column?: number;
+		startLine?: number;
+		endLine?: number;
+	};
+	suggestion?: string;
+}
+
+// ─── Rollback Types ────────────────────────────────────────────────────────
+
+/**
+ * Snapshot of file state
+ */
+export interface FileSnapshot {
+	path: string;
+	content: string;
+	checksum: string;
+	timestamp: string;
+}
+
+/**
+ * Change record
+ */
+export interface ChangeRecord {
+	id: string;
+	type: "create" | "modify" | "delete";
+	path: string;
+	oldSnapshot?: FileSnapshot;
+	newSnapshot?: FileSnapshot;
+	timestamp: string;
+}
+
+/**
+ * Rollback session
+ */
+export interface RollbackSession {
+	id: string;
+	startTime: string;
+	changes: ChangeRecord[];
+	status: "active" | "completed" | "rolled-back";
+}
+
+/**
+ * Rollback result
+ */
+export interface RollbackResult {
+	success: boolean;
+	restoredFiles: string[];
+	failedFiles: string[];
+	error?: string;
+}
+
+// ─── Change Tracking Types ─────────────────────────────────────────────────
+
+/**
+ * Change set
+ */
+export interface ChangeSet {
+	id: string;
+	description: string;
+	changes: FileChange[];
+	createdAt: string;
+	author?: string;
+}
+
+/**
+ * File change
+ */
+export interface FileChange {
+	path: string;
+	type: "added" | "modified" | "deleted" | "renamed";
+	oldContent?: string;
+	newContent?: string;
+	diff?: string;
+}
+
+/**
+ * Diff chunk
+ */
+export interface DiffChunk {
+	type: "add" | "delete" | "context";
+	value: string;
+	lineNumber?: number;
+}
+
+// ─── Template Registry Types ───────────────────────────────────────────────
+
+/**
+ * Registry entry
+ */
+export interface RegistryEntry {
+	id: string;
+	type: "template" | "template-set";
+	name: string;
+	tags: string[];
+	createdAt: string;
+}
+
+/**
+ * Registry query
+ */
+export interface RegistryQuery {
+	tags?: string[];
+	language?: string;
+	search?: string;
+	limit?: number;
+}
+
+// ─── Configuration Types ────────────────────────────────────────────────────
+
+/**
+ * Generator configuration
+ */
+export interface GeneratorConfig {
+	/**
+	 * Output directory
+	 */
+	outputDir?: string;
+
+	/**
+	 * Enable dry run by default
+	 */
+	dryRun?: boolean;
+
+	/**
+	 * Enable validation
+	 */
+	validate?: boolean;
+
+	/**
+	 * Enable rollback on failure
+	 */
+	enableRollback?: boolean;
+
+	/**
+	 * Template engine
+	 */
+	defaultEngine?: TemplateEngine;
+
+	/**
+	 * Variable resolvers
+	 */
+	variableResolvers?: VariableResolver[];
+
+	/**
+	 * Validation rules
+	 */
+	validationRules?: ValidationRule[];
+}
+
+/**
+ * Variable resolver
+ */
+export interface VariableResolver {
+	name: string;
+	resolve: (name: string, context: Record<string, unknown>) => unknown;
+	priority?: number;
+}
+
+// ─── Output Types ──────────────────────────────────────────────────────────
+
+/**
+ * Output format
+ */
+export type OutputFormat = "file" | "buffer" | "stream" | "stdout";
+
+/**
+ * Output configuration
+ */
+export interface OutputConfig {
+	format: OutputFormat;
+	path?: string;
+	encoding?: BufferEncoding;
+	overwrite?: boolean;
+	backup?: boolean;
+}
+
+// ─── Schema Types ─────────────────────────────────────────────────────────
+
+/**
+ * Schema field definition
+ */
+export interface SchemaField {
+	name: string;
+	type: "string" | "number" | "boolean" | "array" | "object" | "enum";
+	description?: string;
+	defaultValue?: unknown;
+}
+
+/**
+ * Schema definition for code generation
+ */
+export interface SchemaDefinition {
+	/** Schema identifier */
+	id?: string;
+	/** Schema name */
+	name: string;
+	/** Schema description */
+	description?: string;
+	/** Schema fields */
+	fields: SchemaField[];
+}