@forgespace/siza-gen 0.4.0 → 0.6.0

package/README.md

@@ -38,13 +38,79 @@ const results = searchComponents('hero section');
 const generator = GeneratorFactory.create('react');
 ```
 
+## What's inside
+
+| Module        | Description                                                       |
+| ------------- | ----------------------------------------------------------------- |
+| `generators/` | React, Vue, Angular, Svelte, HTML code generators                 |
+| `registry/`   | 502 snippets — 357 component + 85 animation + 60 backend          |
+| `ml/`         | Embeddings (all-MiniLM-L6-v2), quality scoring, training pipeline |
+| `feedback/`   | Self-learning loop, pattern promotion, feedback-boosted search    |
+| `quality/`    | Anti-generic rules, diversity tracking                            |
+| `artifacts/`  | Generated artifact storage and learning loop                      |
+
+## LLM Providers
+
+Built-in multi-provider support with auto-fallback:
+
+```typescript
+import { createProviderWithFallback } from '@forgespace/siza-gen';
+
+// Tries Ollama first (local), falls back to OpenAI/Anthropic/Gemini
+const provider = await createProviderWithFallback();
+```
+
+Supports: **Ollama** (local), **OpenAI**, **Anthropic**, **Gemini** (via OpenAI
+adapter).
+
+## Brand Integration
+
+Transform [branding-mcp](https://github.com/Forge-Space/branding-mcp) tokens
+into design context:
+
+```typescript
+import { brandToDesignContext } from '@forgespace/siza-gen';
+
+const designContext = brandToDesignContext(brandIdentity);
+```
+
+## Python ML Sidecar
+
+An optional Python FastAPI sidecar handles compute-intensive ML operations. When
+unavailable, the system gracefully degrades to Transformers.js and heuristics.
+
+```bash
+cd python && pip install -e ".[dev]"
+python -m uvicorn siza_ml.app:app --port 8100
+```
+
+Or via npm:
+
+```bash
+npm run sidecar:start     # Launch Python sidecar
+npm run sidecar:test      # Run Python tests (41 tests)
+```
+
+| Endpoint              | Description                     |
+| --------------------- | ------------------------------- |
+| `POST /embed`         | Sentence-transformer embeddings |
+| `POST /embed/batch`   | Batch embeddings                |
+| `POST /vector/search` | FAISS k-NN similarity search    |
+| `POST /score`         | LLM-based quality scoring       |
+| `POST /enhance`       | LLM-based prompt enhancement    |
+| `POST /train/start`   | LoRA fine-tuning via PEFT       |
+| `GET /health`         | Liveness check                  |
+| `GET /metrics/report` | ML observability metrics        |
+
+**Fallback chain**: Python sidecar → Transformers.js/local LLM → heuristics.
+
 ## Development
 
 ```bash
-npm install
-npm run build
-npm test
-npm run lint
+npm install && npm run build
+npm test                  # 424 tests, 21 suites
+npm run validate          # lint + format + typecheck + test
+npm run registry:stats    # Report snippet counts
 ```
 
 ## License

package/dist/index.d.ts

@@ -174,11 +174,12 @@ declare function configureEmbeddings(overrides: Partial<IEmbeddingConfig>): void
 declare function getEmbeddingConfig(): IEmbeddingConfig;
 /**
  * Generate an embedding vector for a single text string.
+ * Delegates to Python sidecar when available, falls back to Transformers.js.
  */
 declare function embed(text: string): Promise<Float32Array>;
 /**
  * Generate embeddings for multiple texts in batch.
- * More efficient than calling embed() in a loop.
+ * Delegates to Python sidecar when available, falls back to Transformers.js.
  */
 declare function embedBatch(texts: string[]): Promise<Float32Array[]>;
 /**
@@ -459,10 +460,10 @@ declare function checkTrainingReadiness(adapter: AdapterType, modelId: ModelId,
  *
  * Returns the job ID for status tracking.
  */
-declare function startTrainingJob(adapter: AdapterType, modelId: ModelId, db: Database.Database, config?: ILoRAConfig, trainingCommand?: string): {
+declare function startTrainingJob(adapter: AdapterType, modelId: ModelId, db: Database.Database, config?: ILoRAConfig, trainingCommand?: string): Promise<{
     jobId: number;
     status: ITrainingStatus;
-};
+}>;
 /**
  * Cancel a running training job.
  */
@@ -764,6 +765,64 @@ interface ITrainingDataResult {
  */
 declare function storeDesignLearning(analysis: IDesignAnalysis, generatedCode: string, componentName: string, framework: string, db: Database.Database): ITrainingDataResult;
 
+declare function setSidecarUrl(url: string): void;
+declare function getSidecarUrl(): string;
+declare function isSidecarAvailable(): Promise<boolean>;
+declare function resetAvailabilityCache(): void;
+declare function sidecarEmbed(text: string): Promise<Float32Array>;
+declare function sidecarEmbedBatch(texts: string[]): Promise<Float32Array[]>;
+interface ISidecarScoreResult {
+    score: number;
+    confidence: number;
+    factors: Record<string, number>;
+    source: string;
+}
+declare function sidecarScoreQuality(prompt: string, code: string, componentType?: string, framework?: string): Promise<ISidecarScoreResult>;
+interface ISidecarEnhanceResult {
+    enhanced: string;
+    additions: string[];
+    source: string;
+}
+declare function sidecarEnhancePrompt(prompt: string, context?: {
+    componentType?: string;
+    framework?: string;
+    style?: string;
+    mood?: string;
+    industry?: string;
+}): Promise<ISidecarEnhanceResult>;
+interface ISidecarVectorSearchResult {
+    id: string;
+    distance: number;
+    metadata?: Record<string, string>;
+}
+declare function sidecarVectorSearch(vector: Float32Array, topK?: number): Promise<ISidecarVectorSearchResult[]>;
+declare function sidecarVectorIndex(vectors: {
+    id: string;
+    vector: Float32Array;
+    metadata?: Record<string, string>;
+}[]): Promise<{
+    indexed: number;
+}>;
+interface ISidecarTrainingJob {
+    job_id: string;
+    status: string;
+}
+declare function sidecarStartTraining(adapterType: string, dataPath: string, config?: {
+    rank?: number;
+    epochs?: number;
+    learningRate?: number;
+    batchSize?: number;
+}): Promise<ISidecarTrainingJob>;
+declare function sidecarGetTrainingStatus(jobId: string): Promise<{
+    job_id: string;
+    status: string;
+    progress: number;
+    error?: string;
+}>;
+declare function sidecarCancelTraining(jobId: string): Promise<{
+    cancelled: boolean;
+}>;
+
 interface IDesignContext {
     typography: {
         fontFamily: string;
@@ -2510,4 +2569,4 @@ declare function isNetworkError(error: unknown): boolean;
  */
 declare function retry<T>(fn: () => Promise<T>, maxAttempts?: number, delay?: number): Promise<T>;
 
-export { ANIMATION_PRESETS, type AdapterType, AngularGenerator, AnthropicProvider, type AppType, type Architecture, type ArtifactType, type BackendCategory, type BackendFramework, BaseGenerator, type BrandIdentityInput, COLOR_SYSTEMS, COMPONENT_LIBRARIES, type ComponentCategory, type ComponentLibrary, type ComponentLibraryId, type ComponentLibraryIntegration, type ComponentLibrarySetupOptions, type Config, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_MAX_TOKENS, DEFAULT_PRESET, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT_MS, type DeployTarget, FONT_PAIRINGS, type Framework, GeneratorFactory, HtmlGenerator, type IAccessibilityIssue, type IAccessibilityReport, type IArtifactQuery, type IBackendSnippet, ICON_LIBRARIES, type ICodePattern, type IComponentLibrary, type IComponentQuery, type IComponentSnippet, type IComponentStructure, type IConfigFile, type IDesignAnalysisResult, type IDesignContext, type IDirectoryStructure, type IEmbedding, type IEmbeddingConfig, type IEnhancedPrompt, type IEnhancementContext, type IExplicitFeedbackInput, type IFeedback, type IFigmaDesignToken, type IFigmaVariable, type IGeneratedArtifact, type IGeneratedFile, type IGeneration, type IImageAnalysis, type IImplicitSignal, type ILLMConfig, type ILLMGenerateOptions, type ILLMProvider, type ILLMResponse, type ILearningStats, type ILoRAConfig, type IModelPaths, INSPIRATION_SOURCES, type IPatternMatch, type IPresetConfig, type IProjectTemplate, type IPromptClassification, type IQualityScore, type IScaffoldOptions, type IScrapedPage, type IScreenElement, type ISearchResult, type ISimilarityResult, type IStyleContext, type IStyleRecommendation, type ITailwindMapping, type ITemplateSelectionCriteria, type ITrainingExample, type ITrainingStatus, type ITransition, type IValidationResult, type ImageType, type IndustryTag, LAYOUT_PATTERNS, type LLMProviderType, type ModelId, type MoodTag, OllamaProvider, OpenAIProvider, PRESETS, type PageTemplateType, type ProjectType, ReactGenerator, SPACING_SYSTEM, type Scale, type StateManagement$1 as StateManagement, SvelteGenerator, TYPE_SCALE, type VisualStyleId, VueGenerator, applyVisualStyle, brandToDesignContext, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createProvider, createProviderWithFallback, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, detectOllama, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getPromptEnhancerLLM, getQualityScorerLLM, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration$1 as recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setPromptEnhancerLLM, setQualityScorerLLM, setupComponentLibraryProject, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };
+export { ANIMATION_PRESETS, type AdapterType, AngularGenerator, AnthropicProvider, type AppType, type Architecture, type ArtifactType, type BackendCategory, type BackendFramework, BaseGenerator, type BrandIdentityInput, COLOR_SYSTEMS, COMPONENT_LIBRARIES, type ComponentCategory, type ComponentLibrary, type ComponentLibraryId, type ComponentLibraryIntegration, type ComponentLibrarySetupOptions, type Config, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_MAX_TOKENS, DEFAULT_PRESET, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT_MS, type DeployTarget, FONT_PAIRINGS, type Framework, GeneratorFactory, HtmlGenerator, type IAccessibilityIssue, type IAccessibilityReport, type IArtifactQuery, type IBackendSnippet, ICON_LIBRARIES, type ICodePattern, type IComponentLibrary, type IComponentQuery, type IComponentSnippet, type IComponentStructure, type IConfigFile, type IDesignAnalysisResult, type IDesignContext, type IDirectoryStructure, type IEmbedding, type IEmbeddingConfig, type IEnhancedPrompt, type IEnhancementContext, type IExplicitFeedbackInput, type IFeedback, type IFigmaDesignToken, type IFigmaVariable, type IGeneratedArtifact, type IGeneratedFile, type IGeneration, type IImageAnalysis, type IImplicitSignal, type ILLMConfig, type ILLMGenerateOptions, type ILLMProvider, type ILLMResponse, type ILearningStats, type ILoRAConfig, type IModelPaths, INSPIRATION_SOURCES, type IPatternMatch, type IPresetConfig, type IProjectTemplate, type IPromptClassification, type IQualityScore, type IScaffoldOptions, type IScrapedPage, type IScreenElement, type ISearchResult, type ISidecarEnhanceResult, type ISidecarScoreResult, type ISidecarTrainingJob, type ISidecarVectorSearchResult, type ISimilarityResult, type IStyleContext, type IStyleRecommendation, type ITailwindMapping, type ITemplateSelectionCriteria, type ITrainingExample, type ITrainingStatus, type ITransition, type IValidationResult, type ImageType, type IndustryTag, LAYOUT_PATTERNS, type LLMProviderType, type ModelId, type MoodTag, OllamaProvider, OpenAIProvider, PRESETS, type PageTemplateType, type ProjectType, ReactGenerator, SPACING_SYSTEM, type Scale, type StateManagement$1 as StateManagement, SvelteGenerator, TYPE_SCALE, type VisualStyleId, VueGenerator, applyVisualStyle, brandToDesignContext, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createProvider, createProviderWithFallback, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, detectOllama, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getPromptEnhancerLLM, getQualityScorerLLM, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSidecarUrl, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isSidecarAvailable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration$1 as recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetAvailabilityCache, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setPromptEnhancerLLM, setQualityScorerLLM, setSidecarUrl, setupComponentLibraryProject, sidecarCancelTraining, sidecarEmbed, sidecarEmbedBatch, sidecarEnhancePrompt, sidecarGetTrainingStatus, sidecarScoreQuality, sidecarStartTraining, sidecarVectorIndex, sidecarVectorSearch, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };

package/dist/index.js

@@ -3786,7 +3786,7 @@ ${prompt}` : prompt,
       };
     } catch (err) {
       if (err.name === "AbortError") {
-        throw new Error(`Ollama request timed out after ${timeout}ms`);
+        throw new Error(`Ollama request timed out after ${timeout}ms`, { cause: err });
       }
       throw err;
     } finally {
@@ -3872,7 +3872,7 @@ var OpenAIProvider = class {
       };
     } catch (err) {
       if (err.name === "AbortError") {
-        throw new Error(`OpenAI request timed out after ${timeout}ms`);
+        throw new Error(`OpenAI request timed out after ${timeout}ms`, { cause: err });
       }
       throw err;
     } finally {
@@ -3964,7 +3964,7 @@ var AnthropicProvider = class {
       };
     } catch (err) {
       if (err.name === "AbortError") {
-        throw new Error(`Anthropic request timed out after ${timeout}ms`);
+        throw new Error(`Anthropic request timed out after ${timeout}ms`, { cause: err });
       }
       throw err;
     } finally {
@@ -4059,7 +4059,135 @@ async function createProviderWithFallback(config3) {
   logger5.debug("No LLM provider available");
   return null;
 }
-var logger6 = pino({ name: "ml-embeddings" });
+
+// src/ml/sidecar-client.ts
+createLogger("sidecar-client");
+var sidecarUrl = "http://localhost:8100";
+var lastAvailabilityCheck = 0;
+var lastAvailabilityResult = false;
+var AVAILABILITY_CACHE_MS = 3e4;
+var REQUEST_TIMEOUT_MS = 5e3;
+function setSidecarUrl(url) {
+  sidecarUrl = url;
+  lastAvailabilityCheck = 0;
+  lastAvailabilityResult = false;
+}
+function getSidecarUrl() {
+  return sidecarUrl;
+}
+function decodeBase64Vector(b64) {
+  const binary = atob(b64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return new Float32Array(bytes.buffer);
+}
+async function sidecarFetch(path3, body, timeoutMs = REQUEST_TIMEOUT_MS) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const resp = await fetch(`${sidecarUrl}${path3}`, {
+      method: body ? "POST" : "GET",
+      headers: body ? { "Content-Type": "application/json" } : void 0,
+      body: body ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+    if (!resp.ok) {
+      throw new Error(`Sidecar ${path3}: ${resp.status} ${resp.statusText}`);
+    }
+    return await resp.json();
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function isSidecarAvailable() {
+  const now = Date.now();
+  if (now - lastAvailabilityCheck < AVAILABILITY_CACHE_MS) {
+    return lastAvailabilityResult;
+  }
+  try {
+    const result = await sidecarFetch("/ready", void 0, 2e3);
+    lastAvailabilityResult = result.ready;
+  } catch {
+    lastAvailabilityResult = false;
+  }
+  lastAvailabilityCheck = now;
+  return lastAvailabilityResult;
+}
+function resetAvailabilityCache() {
+  lastAvailabilityCheck = 0;
+  lastAvailabilityResult = false;
+}
+async function sidecarEmbed(text) {
+  const result = await sidecarFetch("/embed", { text });
+  return decodeBase64Vector(result.vector);
+}
+async function sidecarEmbedBatch(texts) {
+  const result = await sidecarFetch("/embed/batch", { texts });
+  return result.vectors.map(decodeBase64Vector);
+}
+async function sidecarScoreQuality(prompt, code, componentType, framework) {
+  return sidecarFetch(
+    "/score",
+    {
+      prompt,
+      code,
+      component_type: componentType,
+      framework
+    },
+    1e4
+  );
+}
+async function sidecarEnhancePrompt(prompt, context) {
+  return sidecarFetch(
+    "/enhance",
+    {
+      prompt,
+      component_type: context?.componentType,
+      framework: context?.framework,
+      style: context?.style,
+      mood: context?.mood,
+      industry: context?.industry
+    },
+    1e4
+  );
+}
+async function sidecarVectorSearch(vector, topK = 5) {
+  const b64 = Buffer.from(vector.buffer).toString("base64");
+  return sidecarFetch("/vector/search", {
+    vector: b64,
+    top_k: topK
+  });
+}
+async function sidecarVectorIndex(vectors) {
+  const entries = vectors.map((v) => ({
+    id: v.id,
+    vector: Buffer.from(v.vector.buffer).toString("base64"),
+    metadata: v.metadata
+  }));
+  return sidecarFetch("/vector/index", { entries });
+}
+async function sidecarStartTraining(adapterType, dataPath, config3) {
+  return sidecarFetch(
+    "/train/start",
+    {
+      adapter_type: adapterType,
+      data_path: dataPath,
+      config: config3
+    },
+    1e4
+  );
+}
+async function sidecarGetTrainingStatus(jobId) {
+  return sidecarFetch(`/train/status/${jobId}`);
+}
+async function sidecarCancelTraining(jobId) {
+  return sidecarFetch(`/train/cancel/${jobId}`, {});
+}
+
+// src/ml/embeddings.ts
+var logger7 = pino({ name: "ml-embeddings" });
 var extractor = null;
 var pipelineFn = null;
 var DEFAULT_CONFIG = {
@@ -4087,20 +4215,27 @@ async function getExtractor() {
       transformers.env.cacheDir = config.cacheDir;
     }
   }
-  logger6.info({ model: config.modelId, cache: config.cacheDir }, "Loading embedding model");
+  logger7.info({ model: config.modelId, cache: config.cacheDir }, "Loading embedding model");
   try {
     extractor = await pipelineFn("feature-extraction", config.modelId, {
       quantized: true
       // Use quantized model for smaller size & faster CPU inference
     });
-    logger6.info("Embedding model loaded");
+    logger7.info("Embedding model loaded");
     return extractor;
   } catch (err) {
-    logger6.error({ err, model: config.modelId }, "Failed to load embedding model");
-    throw new Error(`Failed to load embedding model: ${err}`);
+    logger7.error({ err, model: config.modelId }, "Failed to load embedding model");
+    throw new Error(`Failed to load embedding model: ${err}`, { cause: err });
   }
 }
 async function embed(text) {
+  try {
+    if (await isSidecarAvailable()) {
+      return await sidecarEmbed(text);
+    }
+  } catch (err) {
+    logger7.debug({ err }, "Sidecar embed failed, falling back to Transformers.js");
+  }
   const ext = await getExtractor();
   const output = await ext(text, { pooling: "mean", normalize: true });
   if (output.data instanceof Float32Array) {
@@ -4110,6 +4245,13 @@ async function embed(text) {
 }
 async function embedBatch(texts) {
   if (texts.length === 0) return [];
+  try {
+    if (await isSidecarAvailable()) {
+      return await sidecarEmbedBatch(texts);
+    }
+  } catch (err) {
+    logger7.debug({ err }, "Sidecar embedBatch failed, falling back");
+  }
   const ext = await getExtractor();
   const results = [];
   const BATCH_SIZE = 8;
@@ -4160,9 +4302,9 @@ function isModelLoaded() {
 }
 function unloadModel() {
   extractor = null;
-  logger6.info("Embedding model unloaded");
+  logger7.info("Embedding model unloaded");
 }
-var logger7 = pino({ name: "vector-index" });
+var logger8 = pino({ name: "vector-index" });
 var DIMENSIONS = 384;
 var VSS_TABLE = "vss_embeddings";
 var vssAvailable = false;
@@ -4177,11 +4319,11 @@ function initVectorIndex(db2) {
     loadVss(db2);
     db2.exec(`CREATE VIRTUAL TABLE IF NOT EXISTS ${VSS_TABLE} USING vss0(vector(${DIMENSIONS}))`);
     vssAvailable = true;
-    logger7.info("sqlite-vss loaded, vector index ready");
+    logger8.info("sqlite-vss loaded, vector index ready");
     return true;
   } catch (err) {
     vssAvailable = false;
-    logger7.warn({ err }, "sqlite-vss unavailable, falling back to brute-force search");
+    logger8.warn({ err }, "sqlite-vss unavailable, falling back to brute-force search");
     return false;
   }
 }
@@ -4317,7 +4459,7 @@ function deleteEmbeddings(sourceType, db2) {
   const result = db2.prepare("DELETE FROM embeddings WHERE source_type = ?").run(sourceType);
   return result.changes;
 }
-var logger8 = pino({ name: "training-data-exporter" });
+var logger9 = pino({ name: "training-data-exporter" });
 function exportRawExamples(db2, opts = {}) {
   const minAbs = opts.minAbsScore ?? 0.3;
   const limit = opts.limit ?? 1e4;
@@ -4386,7 +4528,7 @@ function writeJsonl(rows, filePath) {
   const lines = rows.map((r) => JSON.stringify(r)).join("\n");
   writeFileSync(filePath, `${lines}
 `, "utf-8");
-  logger8.info({ path: filePath, rows: rows.length }, "Training data written");
+  logger9.info({ path: filePath, rows: rows.length }, "Training data written");
   return rows.length;
 }
 function exportForAdapter(adapter, db2, outputDir) {
@@ -4426,7 +4568,7 @@ function hasEnoughData(adapter, db2, includeSynthetic = false) {
   const required = includeSynthetic ? syntheticThresholds[adapter] : feedbackThresholds[adapter];
   return { ready: count >= required, count, required };
 }
-var logger9 = pino({ name: "model-manager" });
+var logger10 = pino({ name: "model-manager" });
 var DEFAULT_BASE_DIR = join(homedir(), ".uiforge");
 var MODEL_REGISTRY = {
   "qwen2.5-0.5b": {
@@ -4438,7 +4580,7 @@ var MODEL_REGISTRY = {
 var _baseDir = DEFAULT_BASE_DIR;
 function configureModelDir(baseDir) {
   _baseDir = baseDir;
-  logger9.debug({ baseDir }, "Model directory configured");
+  logger10.debug({ baseDir }, "Model directory configured");
 }
 function getBaseDir() {
   return _baseDir;
@@ -4457,7 +4599,7 @@ function ensureDirectories() {
   for (const dir of Object.values(paths)) {
     if (!existsSync(dir)) {
       mkdirSync(dir, { recursive: true });
-      logger9.debug({ dir }, "Created directory");
+      logger10.debug({ dir }, "Created directory");
     }
   }
   return paths;
@@ -4527,7 +4669,7 @@ function getDirectorySize(dir) {
   }
   return total;
 }
-var logger10 = pino({ name: "training-pipeline" });
+var logger11 = pino({ name: "training-pipeline" });
 var DEFAULT_LORA_CONFIG = {
   rank: 8,
   epochs: 3,
@@ -4602,7 +4744,7 @@ function checkTrainingReadiness(adapter, modelId, db2) {
   }
   return { ready: issues.length === 0, issues };
 }
-function startTrainingJob(adapter, modelId, db2, config3 = DEFAULT_LORA_CONFIG, trainingCommand) {
+async function startTrainingJob(adapter, modelId, db2, config3 = DEFAULT_LORA_CONFIG, trainingCommand) {
   const paths = ensureDirectories();
   const { path: dataPath, count } = exportForAdapter(adapter, db2, paths.trainingData);
   if (count === 0) {
@@ -4619,10 +4761,29 @@ function startTrainingJob(adapter, modelId, db2, config3 = DEFAULT_LORA_CONFIG,
     };
   }
   const jobId = createTrainingJob(adapter, count, db2);
+  try {
+    if (await isSidecarAvailable()) {
+      const sidecarJob = await sidecarStartTraining(adapter, dataPath, {
+        rank: config3.rank,
+        epochs: config3.epochs,
+        learningRate: config3.learningRate,
+        batchSize: config3.batchSize
+      });
+      updateJobStatus(jobId, "training", 10, db2);
+      logger11.info({ adapter, jobId, sidecarJobId: sidecarJob.job_id }, "Training via sidecar");
+      pollSidecarTraining(jobId, sidecarJob.job_id, adapter, db2);
+      return {
+        jobId,
+        status: { adapter, status: "training", progress: 10, startedAt: Date.now() }
+      };
+    }
+  } catch (err) {
+    logger11.debug({ error: err.message }, "Sidecar training unavailable, falling back");
+  }
   const modelPath = getModelPath(modelId);
   const adapterPath = getAdapterPath(adapter);
   const cmd = trainingCommand ?? buildDefaultTrainingCommand(modelPath, dataPath, adapterPath, config3);
-  logger10.info({ adapter, jobId, count, modelId }, "Starting LoRA training job");
+  logger11.info({ adapter, jobId, count, modelId }, "Starting LoRA training job via child_process");
   try {
     const cmdParts = cmd.split(/\s+/);
     const child = spawn(cmdParts[0], cmdParts.slice(1), {
@@ -4637,10 +4798,10 @@ function startTrainingJob(adapter, modelId, db2, config3 = DEFAULT_LORA_CONFIG,
       if (progress !== null) {
         updateJobStatus(jobId, "training", progress, db2);
       }
-      logger10.debug({ adapter, line }, "Training output");
+      logger11.debug({ adapter, line }, "Training output");
     });
     child.stderr?.on("data", (data) => {
-      logger10.warn({ adapter, stderr: data.toString().trim() }, "Training stderr");
+      logger11.warn({ adapter, stderr: data.toString().trim() }, "Training stderr");
     });
     child.on("close", (code) => {
       activeJobs.delete(adapter);
@@ -4648,21 +4809,21 @@ function startTrainingJob(adapter, modelId, db2, config3 = DEFAULT_LORA_CONFIG,
         try {
           process.kill(-child.pid, "SIGTERM");
         } catch (err) {
-          logger10.debug({ err }, "Process group already terminated");
+          logger11.debug({ err }, "Process group already terminated");
         }
       }
       if (code === 0 && existsSync(adapterPath)) {
         updateJobStatus(jobId, "complete", 100, db2);
-        logger10.info({ adapter, jobId }, "Training completed successfully");
+        logger11.info({ adapter, jobId }, "Training completed successfully");
       } else {
         updateJobStatus(jobId, "failed", 0, db2, `Process exited with code ${code}`);
-        logger10.error({ adapter, jobId, code }, "Training failed");
+        logger11.error({ adapter, jobId, code }, "Training failed");
       }
     });
     child.on("error", (err) => {
       activeJobs.delete(adapter);
       updateJobStatus(jobId, "failed", 0, db2, err.message);
-      logger10.error({ adapter, jobId, error: err.message }, "Training process error");
+      logger11.error({ adapter, jobId, error: err.message }, "Training process error");
     });
     child.unref();
   } catch (err) {
@@ -4691,7 +4852,7 @@ function cancelTrainingJob(adapter, db2) {
         updateJobStatus(row.id, "failed", 0, db2, "Cancelled by user");
       }
     }
-    logger10.info({ adapter }, "Training job cancelled");
+    logger11.info({ adapter }, "Training job cancelled");
     return true;
   } catch {
     return false;
@@ -4709,6 +4870,21 @@ function getTrainingSummary(db2) {
     activeCount: activeJobs.size
   };
 }
+function pollSidecarTraining(dbJobId, sidecarJobId, adapter, db2) {
+  const interval = setInterval(async () => {
+    try {
+      const status = await sidecarGetTrainingStatus(sidecarJobId);
+      updateJobStatus(dbJobId, status.status, status.progress, db2, status.error);
+      if (status.status === "complete" || status.status === "failed" || status.status === "cancelled") {
+        clearInterval(interval);
+      }
+    } catch {
+      clearInterval(interval);
+      updateJobStatus(dbJobId, "failed", 0, db2, "Lost connection to sidecar");
+    }
+  }, 5e3);
+  interval.unref();
+}
 function buildDefaultTrainingCommand(modelPath, dataPath, adapterPath, config3) {
   return [
     "llama-finetune",
@@ -4918,7 +5094,7 @@ function safeJSONParse(jsonString, defaultValue) {
 }
 
 // src/registry/database/store.ts
-var logger11 = pino({ name: "design-references-db" });
+var logger12 = pino({ name: "design-references-db" });
 var db = null;
 function getDatabase(customPath) {
   if (db) return db;
@@ -4934,7 +5110,7 @@ function getDatabase(customPath) {
   db.pragma("synchronous = NORMAL");
   db.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)").run("schema_version", String(SCHEMA_VERSION));
   initVectorIndex(db);
-  logger11.info({ dbPath: resolvedPath }, "Database opened/created");
+  logger12.info({ dbPath: resolvedPath }, "Database opened/created");
   return db;
 }
 function closeDatabase() {
@@ -5010,7 +5186,7 @@ function seedComponents(snippets2, database) {
     d.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)").run("seed_count", String(snippets2.length));
   });
   seedAll();
-  logger11.info({ count: snippets2.length }, "Components seeded to database");
+  logger12.info({ count: snippets2.length }, "Components seeded to database");
 }
 function hydrateSnippetsBatch(ids, d) {
   if (ids.length === 0) return [];
@@ -5117,7 +5293,7 @@ function getDefaultDbPath() {
 }
 
 // src/ml/quality-scorer.ts
-var logger12 = createLogger("quality-scorer");
+var logger13 = createLogger("quality-scorer");
 var llmProvider = null;
 function setQualityScorerLLM(provider) {
   llmProvider = provider;
@@ -5128,12 +5304,29 @@ function getQualityScorerLLM() {
 async function scoreQuality(prompt, generatedCode, params) {
   const start = Date.now();
   const heuristic = scoreWithHeuristics(prompt, generatedCode, params, start);
+  try {
+    if (await isSidecarAvailable()) {
+      const result = await sidecarScoreQuality(prompt, generatedCode, params?.componentType, params?.framework);
+      return blendScores(
+        heuristic,
+        {
+          score: result.score,
+          confidence: result.confidence,
+          source: "model",
+          latencyMs: Date.now() - start
+        },
+        start
+      );
+    }
+  } catch (err) {
+    logger13.debug({ error: err.message }, "Sidecar scoring failed");
+  }
   if (!llmProvider) return heuristic;
   try {
     const llmScore = await scoreWithLLM(prompt, generatedCode, params, start);
     return blendScores(heuristic, llmScore, start);
   } catch (err) {
-    logger12.debug({ error: err.message }, "LLM scoring failed, using heuristic");
+    logger13.debug({ error: err.message }, "LLM scoring failed, using heuristic");
     return heuristic;
   }
 }
@@ -5335,7 +5528,7 @@ async function scoreQualityWithRAG(prompt, generatedCode, params) {
       latencyMs: Date.now() - start
     };
   } catch (err) {
-    logger12.warn({ error: err.message }, "RAG quality scoring failed");
+    logger13.warn({ error: err.message }, "RAG quality scoring failed");
     return baseScore;
   }
 }
@@ -5345,7 +5538,7 @@ async function isLikelyAccepted(prompt, generatedCode, params) {
 }
 
 // src/ml/prompt-enhancer.ts
-var logger13 = createLogger("prompt-enhancer");
+var logger14 = createLogger("prompt-enhancer");
 var llmProvider2 = null;
 function setPromptEnhancerLLM(provider) {
   llmProvider2 = provider;
@@ -5355,13 +5548,27 @@ function getPromptEnhancerLLM() {
 }
 async function enhancePrompt(prompt, context) {
   const start = Date.now();
+  try {
+    if (await isSidecarAvailable()) {
+      const result = await sidecarEnhancePrompt(prompt, context);
+      return {
+        enhanced: result.enhanced,
+        original: prompt,
+        source: result.source === "ollama" ? "model" : "rules",
+        additions: result.additions,
+        latencyMs: Date.now() - start
+      };
+    }
+  } catch (err) {
+    logger14.debug({ error: err.message }, "Sidecar enhancement failed");
+  }
   if (!llmProvider2) {
     return enhanceWithRules(prompt, context, start);
   }
   try {
     return await enhanceWithModel(prompt, context, start);
   } catch (err) {
-    logger13.debug({ error: err.message }, "LLM enhancement failed, using rules");
+    logger14.debug({ error: err.message }, "LLM enhancement failed, using rules");
     return enhanceWithRules(prompt, context, start);
   }
 }
@@ -5452,7 +5659,7 @@ function enhanceWithRules(prompt, context, start = Date.now()) {
       additions.push(...ragAdditions.additions);
     }
   } catch (err) {
-    logger13.debug({ error: err.message }, "RAG enhancement skipped");
+    logger14.debug({ error: err.message }, "RAG enhancement skipped");
   }
   return {
     enhanced,
@@ -5513,7 +5720,7 @@ async function enhancePromptWithRAG(prompt, context) {
       }
     }
   } catch (err) {
-    logger13.warn({ error: err.message }, "RAG enhancement failed");
+    logger14.warn({ error: err.message }, "RAG enhancement failed");
   }
   return {
     enhanced,
@@ -5574,7 +5781,7 @@ function addComponentHints(prompt, componentType, additions) {
   }
   return prompt;
 }
-var logger14 = pino({ name: "style-recommender" });
+var logger15 = pino({ name: "style-recommender" });
 var INDUSTRY_STYLES = {
   fintech: {
     primaryColor: "#0F172A",
@@ -5678,7 +5885,7 @@ async function recommendStyle(prompt, context) {
     try {
       return await recommendWithRAG(prompt, context, db2);
     } catch (err) {
-      logger14.warn({ error: err.message }, "RAG style recommendation failed, using heuristic");
+      logger15.warn({ error: err.message }, "RAG style recommendation failed, using heuristic");
     }
   }
   return recommendWithHeuristic(prompt, context);
@@ -5925,7 +6132,7 @@ function extractMetadata(description, code) {
     accessibilityNotes
   };
 }
-var logger15 = pino({ name: "visual-styles" });
+var logger16 = pino({ name: "visual-styles" });
 var styles = [];
 var initialized = false;
 function registerVisualStyle(style) {
@@ -5957,7 +6164,7 @@ function applyVisualStyle(snippet, style) {
     }
   }
   if (droppedModifiers.length > 0) {
-    logger15.warn(
+    logger16.warn(
       { styleId: style.id, snippetId: snippet.id, droppedModifiers },
       "Some style modifiers could not be applied - no matching role in snippet"
     );
@@ -6143,7 +6350,7 @@ function initializeStyles() {
     registerVisualStyle(style);
   }
   initialized = true;
-  logger15.debug("Visual styles initialized");
+  logger16.debug("Visual styles initialized");
 }
 
 // src/registry/micro-interactions/entrance-fade.ts
@@ -7758,7 +7965,7 @@ function fingerprint(code) {
 function isPromotable(pattern) {
   return pattern.frequency >= 3 && pattern.avgScore > 0.5 && !pattern.promoted;
 }
-var logger16 = pino({ name: "feedback-tracker" });
+var logger17 = pino({ name: "feedback-tracker" });
 var lastGeneration = /* @__PURE__ */ new Map();
 function recordGeneration(gen, generatedCode, db2, promptContext) {
   const codeHash = createHash("sha256").update(generatedCode).digest("hex").slice(0, 16);
@@ -7778,7 +7985,7 @@ function recordGeneration(gen, generatedCode, db2, promptContext) {
         timestamp: Date.now()
       };
       storeFeedback(implicitFeedback, db2);
-      logger16.debug(
+      logger17.debug(
         { generationId: prev.id, score: implicitFeedback.score, signals: classification.signals.length },
         "Implicit feedback recorded"
       );
@@ -7803,7 +8010,7 @@ function recordExplicitFeedback(generationId, rating, db2, comment) {
     timestamp: Date.now()
   };
   storeFeedback(feedback, db2);
-  logger16.info({ generationId, rating }, "Explicit feedback recorded");
+  logger17.info({ generationId, rating }, "Explicit feedback recorded");
   return feedback;
 }
 function getAggregateScore(componentType, db2) {
@@ -7871,7 +8078,7 @@ function storeFeedback(feedback, db2) {
 function upsertPattern(hash, skeleton, code, db2) {
   const existing = db2.prepare("SELECT source_id FROM embeddings WHERE source_id = ? AND source_type = ?").get(hash, "description");
   if (!existing) {
-    logger16.debug({ hash, skeleton }, "New code pattern detected");
+    logger17.debug({ hash, skeleton }, "New code pattern detected");
   }
 }
 function clearSessionCache() {
@@ -7952,7 +8159,7 @@ function getFeedbackBoost(componentType, db2) {
   const boost = normalizedScore * FEEDBACK_BOOST_FACTOR;
   return Math.max(0.7, Math.min(1.3, 1 + boost));
 }
-var logger17 = pino({ name: "pattern-promotion" });
+var logger18 = pino({ name: "pattern-promotion" });
 var PATTERNS_TABLE = `
   CREATE TABLE IF NOT EXISTS code_patterns (
     id             TEXT PRIMARY KEY,
@@ -8028,7 +8235,7 @@ function getPromotablePatternsFromDb(db2) {
 }
 function promotePattern(pattern, componentType, category, db2) {
   if (!isPromotable(pattern)) {
-    logger17.debug({ patternId: pattern.id }, "Pattern not eligible for promotion");
+    logger18.debug({ patternId: pattern.id }, "Pattern not eligible for promotion");
     return null;
   }
   const snippet = {
@@ -8067,13 +8274,13 @@ function promotePattern(pattern, componentType, category, db2) {
       Math.floor(Date.now() / 1e3),
       pattern.id
     );
-    logger17.info(
+    logger18.info(
       { patternId: pattern.id, snippetId: snippet.id, freq: pattern.frequency, score: pattern.avgScore },
       "Pattern promoted to registry snippet"
     );
     return snippet;
   } catch (err) {
-    logger17.error({ err, patternId: pattern.id }, "Failed to promote pattern");
+    logger18.error({ err, patternId: pattern.id }, "Failed to promote pattern");
     return null;
   }
 }
@@ -8088,7 +8295,7 @@ function runPromotionCycle(db2) {
     if (result) promoted++;
   }
   if (promoted > 0) {
-    logger17.info({ promoted, candidates: candidates.length }, "Promotion cycle complete");
+    logger18.info({ promoted, candidates: candidates.length }, "Promotion cycle complete");
   }
   return promoted;
 }
@@ -8190,7 +8397,7 @@ function validateSnippetStrict(snippet) {
 }
 
 // src/registry/component-registry/index.ts
-var logger18 = pino({ name: "component-registry" });
+var logger19 = pino({ name: "component-registry" });
 var registry = [];
 var moodAffinities = {
   bold: ["energetic", "premium"],
@@ -8208,27 +8415,27 @@ var moodAffinities = {
 };
 function registerSnippet(snippet) {
   if (!snippet?.id || typeof snippet.id !== "string") {
-    logger18.warn({ snippet }, "Invalid snippet: missing or invalid id");
+    logger19.warn({ snippet }, "Invalid snippet: missing or invalid id");
     return;
   }
   if (!snippet.type || typeof snippet.type !== "string" || !snippet.type.trim()) {
-    logger18.warn({ snippet }, "Invalid snippet: missing or invalid type");
+    logger19.warn({ snippet }, "Invalid snippet: missing or invalid type");
     return;
   }
   if (!snippet.variant || typeof snippet.variant !== "string" || !snippet.variant.trim()) {
-    logger18.warn({ snippet }, "Invalid snippet: missing or invalid variant");
+    logger19.warn({ snippet }, "Invalid snippet: missing or invalid variant");
     return;
   }
   if (!Array.isArray(snippet.tags)) {
-    logger18.warn({ snippet }, "Invalid snippet: tags must be an array");
+    logger19.warn({ snippet }, "Invalid snippet: tags must be an array");
     return;
   }
   const validation = validateSnippet(snippet);
   if (!validation.valid) {
-    logger18.warn({ id: snippet.id, errors: validation.errors }, "Snippet failed quality validation");
+    logger19.warn({ id: snippet.id, errors: validation.errors }, "Snippet failed quality validation");
   }
   if (validation.warnings.length > 0) {
-    logger18.debug({ id: snippet.id, warnings: validation.warnings }, "Snippet quality warnings");
+    logger19.debug({ id: snippet.id, warnings: validation.warnings }, "Snippet quality warnings");
   }
   const normalized = {
     ...snippet,
@@ -8238,19 +8445,19 @@ function registerSnippet(snippet) {
   };
   const exists = registry.findIndex((s) => s.id === normalized.id);
   if (exists >= 0) {
-    logger18.warn(
+    logger19.warn(
       { id: normalized.id, existingSource: registry[exists].name, newSource: normalized.name },
       "Overwriting existing snippet with duplicate id"
     );
     registry[exists] = normalized;
   } else {
     registry.push(normalized);
-    logger18.debug({ id: normalized.id, name: normalized.name }, "Registered new snippet");
+    logger19.debug({ id: normalized.id, name: normalized.name }, "Registered new snippet");
   }
 }
 function clearRegistry() {
   registry.length = 0;
-  logger18.debug("Registry cleared");
+  logger19.debug("Registry cleared");
 }
 function registerSnippets(snippets2) {
   for (const snippet of snippets2) {
@@ -8352,7 +8559,7 @@ function getByIndustry(industry) {
 function applyVisualStyle2(snippet, styleId) {
   const style = getVisualStyle(styleId);
   if (!style) {
-    logger18.warn(
+    logger19.warn(
       { styleId, snippetId: snippet.id, snippetType: snippet.type },
       "Visual style not found in applyVisualStyle, returning original snippet"
     );
@@ -8381,7 +8588,7 @@ ${anim.keyframes}`;
   } else {
     const rootKey = "root" in newTailwindClasses ? "root" : "container" in newTailwindClasses ? "container" : keys[0];
     if (rootKey !== "root" && rootKey !== "container") {
-      logger18.warn({ snippetId: snippet.id, animationIds, rootKey }, "No root/container key found, using first key");
+      logger19.warn({ snippetId: snippet.id, animationIds, rootKey }, "No root/container key found, using first key");
     }
     newTailwindClasses[rootKey] = `${newTailwindClasses[rootKey]} ${additionalClasses.join(" ")}`.trim();
   }
@@ -8438,7 +8645,7 @@ function getBestMatchWithFeedback(type, options, db2) {
         return boosted[0].snippet;
       }
     } catch (err) {
-      logger18.error({ err, type }, "Failed to apply feedback boost, falling back to base search");
+      logger19.error({ err, type }, "Failed to apply feedback boost, falling back to base search");
     }
   }
   const results = searchComponents({
@@ -8457,13 +8664,13 @@ function triggerPatternPromotion(db2) {
     const promoted = runPromotionCycle(db2);
     return promoted;
   } catch (err) {
-    logger18.warn({ error: err }, "Pattern promotion failed");
+    logger19.warn({ error: err }, "Pattern promotion failed");
     return 0;
   }
 }
 
 // src/ml/design-to-training-data.ts
-var logger19 = pino({ name: "design-to-training-data" });
+var logger20 = pino({ name: "design-to-training-data" });
 function storeDesignLearning(analysis, generatedCode, componentName, framework, db2) {
   const result = {
     snippetsCreated: 0,
@@ -8478,12 +8685,12 @@ function storeDesignLearning(analysis, generatedCode, componentName, framework,
         registerSnippet(snippet);
         result.snippetsCreated++;
       }
-      logger19.info(
+      logger20.info(
         { count: snippets2.length, qualityScore: analysis.qualityScore },
         "Component snippets created from design analysis"
       );
     } catch (err) {
-      logger19.error({ err }, "Failed to convert design to component snippets");
+      logger20.error({ err }, "Failed to convert design to component snippets");
     }
   }
   const feedbackEntries = generateFeedbackEntries(analysis, componentName, db2);
@@ -8491,7 +8698,7 @@ function storeDesignLearning(analysis, generatedCode, componentName, framework,
   const patterns = detectAndStorePatterns(analysis, generatedCode, db2);
   result.patternsDetected = patterns;
   result.summary = generateSummary(analysis, result);
-  logger19.info(result, "Design learning stored successfully");
+  logger20.info(result, "Design learning stored successfully");
   return result;
 }
 function convertToComponentSnippets(analysis, generatedCode, componentName, _framework) {
@@ -8566,7 +8773,7 @@ function generateFeedbackEntries(analysis, componentName, db2) {
     );
     count++;
   }
-  logger19.info({ count, score }, "Feedback entries created from design analysis");
+  logger20.info({ count, score }, "Feedback entries created from design analysis");
   return count;
 }
 function detectAndStorePatterns(analysis, generatedCode, db2) {
@@ -8603,7 +8810,7 @@ function detectAndStorePatterns(analysis, generatedCode, db2) {
     );
     count++;
   }
-  logger19.info({ count }, "Code patterns stored from design analysis");
+  logger20.info({ count }, "Code patterns stored from design analysis");
   return count;
 }
 function generateSummary(analysis, result) {
@@ -10904,7 +11111,7 @@ TODO: Implement HTML project generation.`
 };
 
 // src/generators/generator-factory.ts
-var logger20 = createLogger("generator-factory");
+var logger21 = createLogger("generator-factory");
 var GeneratorFactory = class _GeneratorFactory {
   static instance;
   generators = /* @__PURE__ */ new Map();
@@ -10930,7 +11137,7 @@ var GeneratorFactory = class _GeneratorFactory {
   registerGenerator(framework, generatorClass) {
     this.generators.set(framework, generatorClass);
     this.instances.delete(framework);
-    logger20.info(`Registered generator for framework: ${framework}`);
+    logger21.info(`Registered generator for framework: ${framework}`);
   }
   /**
    * Create a generator instance for the specified framework
@@ -10947,7 +11154,7 @@ var GeneratorFactory = class _GeneratorFactory {
     }
     const instance = new GeneratorClass(framework);
     this.instances.set(framework, instance);
-    logger20.info(`Created generator instance for framework: ${framework}`);
+    logger21.info(`Created generator instance for framework: ${framework}`);
     return instance;
   }
   /**
@@ -11017,7 +11224,7 @@ var GeneratorFactory = class _GeneratorFactory {
    */
   clearInstances() {
     this.instances.clear();
-    logger20.info("Cleared all generator instances");
+    logger21.info("Cleared all generator instances");
   }
   /**
    * Clear instance for a specific framework
@@ -11025,7 +11232,7 @@ var GeneratorFactory = class _GeneratorFactory {
    */
   clearInstance(framework) {
     this.instances.delete(framework);
-    logger20.info(`Cleared generator instance for framework: ${framework}`);
+    logger21.info(`Cleared generator instance for framework: ${framework}`);
   }
   /**
    * Unregister a generator
@@ -11034,7 +11241,7 @@ var GeneratorFactory = class _GeneratorFactory {
   unregisterGenerator(framework) {
     this.generators.delete(framework);
     this.instances.delete(framework);
-    logger20.info(`Unregistered generator for framework: ${framework}`);
+    logger21.info(`Unregistered generator for framework: ${framework}`);
   }
   /**
    * Get default design context
@@ -11102,14 +11309,14 @@ var GeneratorFactory = class _GeneratorFactory {
    * Register default generators for all supported frameworks
    */
   registerDefaultGenerators() {
-    logger20.info("Registering default generators");
+    logger21.info("Registering default generators");
     this.registerGenerator("react", ReactGenerator);
     this.registerGenerator("vue", VueGenerator);
     this.registerGenerator("svelte", SvelteGenerator);
     this.registerGenerator("angular", AngularGenerator);
     this.registerGenerator("html", HtmlGenerator);
     this.registerGenerator("nextjs", ReactGenerator);
-    logger20.info(`Registered ${this.getSupportedFrameworks().length} framework generators`);
+    logger21.info(`Registered ${this.getSupportedFrameworks().length} framework generators`);
   }
 };
 function generateComponent(framework, componentType, props, designContext, componentLibrary) {
@@ -33864,7 +34071,7 @@ function composePageFromTemplate(compositionId, options) {
     };
     const results = searchComponents(query);
     const snippet = results[0];
-    let jsx = "";
+    let jsx;
     let snippetId;
     if (snippet) {
       jsx = snippet.snippet.jsx;
@@ -35041,7 +35248,7 @@ function initializePacks() {
   registerPack(startupLandingPack);
   registerPack(aiChatAppPack);
 }
-var logger21 = pino({ name: "registry-init" });
+var logger22 = pino({ name: "registry-init" });
 var initialized3 = false;
 function initializeRegistry() {
   if (initialized3) return;
@@ -35056,14 +35263,14 @@ function initializeRegistry() {
       registerOrganisms();
       const staticSnippets = getAllSnippets();
       seedComponents(staticSnippets, db2);
-      logger21.info({ count: staticSnippets.length }, "Seeded DB from static files");
+      logger22.info({ count: staticSnippets.length }, "Seeded DB from static files");
     }
     clearRegistry();
     const dbSnippets = getAllComponents(db2);
     registerSnippets(dbSnippets);
-    logger21.info({ count: dbSnippets.length }, "Loaded in-memory registry from DB");
+    logger22.info({ count: dbSnippets.length }, "Loaded in-memory registry from DB");
   } catch (err) {
-    logger21.warn({ err }, "DB unavailable, falling back to static files");
+    logger22.warn({ err }, "DB unavailable, falling back to static files");
     clearRegistry();
     registerAtoms();
     registerMolecules();
@@ -35072,12 +35279,12 @@ function initializeRegistry() {
   try {
     initializeCompositions();
   } catch (err) {
-    logger21.warn({ err }, "Compositions init failed; page templates still work");
+    logger22.warn({ err }, "Compositions init failed; page templates still work");
   }
   try {
     initializePacks();
   } catch (err) {
-    logger21.warn({ err }, "Packs init failed; template packs still available");
+    logger22.warn({ err }, "Packs init failed; template packs still available");
   }
   initialized3 = true;
 }
@@ -38976,7 +39183,7 @@ var ARTIFACTS_SCHEMA = `
 `;
 
 // src/artifacts/artifact-store.ts
-var logger22 = pino({ name: "artifact-store" });
+var logger23 = pino({ name: "artifact-store" });
 var schemaInitialized = false;
 function ensureSchema(db2) {
   if (schemaInitialized) return;
@@ -39010,7 +39217,7 @@ function storeArtifact(artifact, db2) {
     artifact.inspirationSources ? JSON.stringify(artifact.inspirationSources) : null,
     artifact.createdAt
   );
-  logger22.debug({ id: artifact.id, type: artifact.type }, "Artifact stored");
+  logger23.debug({ id: artifact.id, type: artifact.type }, "Artifact stored");
 }
 function getArtifact(id, db2) {
   ensureSchema(db2);
@@ -39098,7 +39305,7 @@ function hydrateArtifact(row) {
     createdAt: row.created_at
   };
 }
-var logger23 = pino({ name: "learning-loop" });
+var logger24 = pino({ name: "learning-loop" });
 var PROMOTION_QUALITY_THRESHOLD = 7;
 var PROMOTION_FEEDBACK_THRESHOLD = 1;
 var MIN_ARTIFACTS_FOR_STATS = 5;
@@ -39116,7 +39323,7 @@ function recordGeneratedArtifact(prompt, code, type, db2, options) {
     createdAt: Date.now()
   };
   storeArtifact(artifact, db2);
-  logger23.info({ id: artifact.id, type }, "Generation recorded");
+  logger24.info({ id: artifact.id, type }, "Generation recorded");
   return artifact;
 }
 function getPromotionCandidates(db2) {
@@ -40837,7 +41044,7 @@ function applyDesignContextToPattern(content, designContext, customizations) {
 }
 
 // src/component-libraries/shadcn/index.ts
-var logger24 = createLogger("shadcn");
+var logger25 = createLogger("shadcn");
 function setupShadcnProject(options) {
   const files = [];
   const setupFiles = generateShadcnSetup(options.framework, options.projectName, void 0, []);
@@ -40852,7 +41059,7 @@ function setupShadcnProject(options) {
         );
         files.push(...componentFiles);
       } catch (error) {
-        logger24.warn({ error }, `Failed to generate component ${componentName}:`);
+        logger25.warn({ error }, `Failed to generate component ${componentName}:`);
       }
     });
   }
@@ -40866,7 +41073,7 @@ function setupShadcnProject(options) {
         );
         files.push(...patternFiles);
       } catch (error) {
-        logger24.warn({ error }, `Failed to generate pattern ${patternName}:`);
+        logger25.warn({ error }, `Failed to generate pattern ${patternName}:`);
       }
     });
   }
@@ -42415,6 +42622,6 @@ async function retry(fn, maxAttempts = 3, delay = 1e3) {
   throw lastError;
 }
 
-export { ANIMATION_PRESETS, AngularGenerator, AnthropicProvider, BaseGenerator, COLOR_SYSTEMS, COMPONENT_LIBRARIES, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_MAX_TOKENS, DEFAULT_PRESET, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT_MS, FONT_PAIRINGS, GeneratorFactory, HtmlGenerator, ICON_LIBRARIES, INSPIRATION_SOURCES, LAYOUT_PATTERNS, OllamaProvider, OpenAIProvider, PRESETS, ReactGenerator, SPACING_SYSTEM, SvelteGenerator, TYPE_SCALE, VueGenerator, applyVisualStyle2 as applyVisualStyle, brandToDesignContext, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createProvider, createProviderWithFallback, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, detectOllama, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getPromptEnhancerLLM, getQualityScorerLLM, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration2 as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setPromptEnhancerLLM, setQualityScorerLLM, setupComponentLibraryProject, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates2 as templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };
+export { ANIMATION_PRESETS, AngularGenerator, AnthropicProvider, BaseGenerator, COLOR_SYSTEMS, COMPONENT_LIBRARIES, DEFAULT_COLOR_SYSTEM, DEFAULT_CONTEXT, DEFAULT_DESIGN_CONTEXT, DEFAULT_FONT_PAIRING, DEFAULT_LORA_CONFIG, DEFAULT_MAX_TOKENS, DEFAULT_PRESET, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT_MS, FONT_PAIRINGS, GeneratorFactory, HtmlGenerator, ICON_LIBRARIES, INSPIRATION_SOURCES, LAYOUT_PATTERNS, OllamaProvider, OpenAIProvider, PRESETS, ReactGenerator, SPACING_SYSTEM, SvelteGenerator, TYPE_SCALE, VueGenerator, applyVisualStyle2 as applyVisualStyle, brandToDesignContext, buildPromptEnhancerData, buildQualityScorerData, buildStyleRecommenderData, cancelTrainingJob, capitalize, checkTrainingReadiness, classifyPromptPair, classifyPromptText, cleanJsxSyntax, clearAllMicroInteractions, clearCompositions, clearHistory as clearDiversityHistory, clearRegistry, clearSessionCache, closeDatabase, composePageFromTemplate, composeSection, configureEmbeddings, configureModelDir, convertPathForFramework, convertStyleObjectToString, cosineSimilarity, createEmbedding, createError, createLogger, createProvider, createProviderWithFallback, createTrainingJob, customizeTemplate, deleteArtifact, deleteEmbeddings, designContextStore, detectOllama, embed, embedBatch, enhancePrompt, enhancePromptWithRAG, enhanceWithRules, ensureDirectories, ensurePatternsTable, escapeHtml, exportForAdapter, exportRawExamples, exportTrainingData, expressApiTemplate, extractDesignPatterns, extractSkeleton, feedbackBoostedSearch, findBestComposition, findSimilar, fingerprint, fullstackMonoTemplate, generateArtifactId, generateComponent, generateComponentFromLibrary, generateRandomId, getAdapterPath, getAggregateScore, getAllCompositions, getAllInteractions, getAllJobStatuses, getAllPacks, getAllSnippets, getAllTemplates, getAnimationsByCategory, getArtifact, getArtifactCount, getAvailableComponentLibraries, getAvailableComponentsForLibrary, getAvailablePatternsForLibrary, getAvailableTypes, getBaseDir, getBestMatch, getBestMatchWithFeedback, getByCategory, getByIndustry, getByMood, getColorSystem, getColorSystemsByMood, getComponentLibrariesForFramework, getComponentLibrary, getComposition, getConfig, getDatabase, getDefaultIconLibrary, getDiskUsage, getEmbedding, getEmbeddingConfig, getEmbeddingCount, getFallbackDesignReference, getFeedbackBoost, getFeedbackCount, getFeedbackStats, getFileExtension, getFileName, getFontPairing, getFontPairingsByMood, getInspirationByCategory, getInspirationByPriority, getInteractionsByCategory, getLatestJobStatus, getLayoutPattern, getLayoutPatternsByUseCase, getLearningStats, getMicroInteraction, getModelDownloadUrl, getModelPath, getModelPaths, getPack, getPatternStats, getPreset, getPrimaryDesignReference, getPromotablePatternsFromDb, getPromotionCandidates, getPromptEnhancerLLM, getQualityScorerLLM, getRecentArtifacts, getRecommendations, getRecommendedLibrary, getRegistrySize, getSidecarUrl, getSimilarArtifacts, getSnippetById, getTemplate, getTopArtifacts, getTrainingDataPath, getTrainingSummary, getVariants, groupBy, hasEnoughData, hashSkeleton, htmlToJsxAttributes, includesCaseInsensitive, initializeBackendRegistry, initializeInteractions, initializeRegistry, injectAnimations, isAdapterAvailable, isArray, isDuplicateConsecutive, isFunction, isLikelyAccepted, isModelAvailable, isModelLoaded, isNetworkError, isNumber, isObject, isPromotable, isSidecarAvailable, isString, isTraining, isValidComponentName, isValidEmail, isValidHexColor, isValidProjectName, isValidUrl, jsxToHtml, jsxToHtmlAttributes, jsxToSvelte, listAdapters, listModels, listPresets, loadConfig, loadEmbeddings, logger, mergeStyles, needsEnhancement, nextAppTemplate, nextSaasTemplate, parseStyleString, pluralize, promotePattern, queryArtifacts, reactEventsToHtml, reactEventsToSvelte, reactSpaTemplate, recommendStyle, recordGeneration2 as recordDiversityGeneration, recordExplicitFeedback, recordGeneratedArtifact, recordGeneration, recordPattern, reduxToolkitPattern as reduxToolkitPatterns, registerComposition, registerInteraction, registerInteractions, registerPack, registerSnippet, registerSnippets, resetAvailabilityCache, resetSchemaInit, retry, runPromotionCycle, safeJSONParse, sanitizeClassName, scoreQuality, scoreQualityWithRAG, searchBackendSnippets, searchComponents, searchPacks, selectTemplate, semanticSearch, setPromptEnhancerLLM, setQualityScorerLLM, setSidecarUrl, setupComponentLibraryProject, sidecarCancelTraining, sidecarEmbed, sidecarEmbedBatch, sidecarEnhancePrompt, sidecarGetTrainingStatus, sidecarScoreQuality, sidecarStartTraining, sidecarVectorIndex, sidecarVectorSearch, sortBy, startTrainingJob, stateManagementPatterns, storeArtifact, storeDesignLearning, storeEmbedding, storeEmbeddings, suggestDiverseVariant, tanstackQueryPattern as tanstackQueryPatterns, templateList, templates2 as templates, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, triggerPatternPromotion, truncate, unique, unloadModel, updateFeedbackScore, updateJobStatus, updateQualityScore, validateSnippet, validateSnippetStrict, writeJsonl, zustandPatterns };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgespace/siza-gen",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Siza AI generation engine — multi-framework code generation, component registry, and ML-powered quality scoring",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,12 @@
     "validate:tokens": "npx tsx src/scripts/check-semantic-tokens.ts",
     "registry:stats": "npx tsx src/scripts/count-registry.ts",
     "export:training": "npx tsx src/scripts/export-training-data.ts",
-    "prepare": "husky install || true",
+    "seed:rules": "npx tsx src/scripts/seed-axe-core-rules.ts",
+    "ingest:hf": "npx tsx src/scripts/ingest-huggingface.ts",
+    "sidecar:start": "bash scripts/start-sidecar.sh",
+    "sidecar:test": "cd python && source .venv/bin/activate && python -m pytest tests/ -v",
+    "metrics:report": "curl -s http://localhost:8100/metrics/report | node -e \"process.stdin.resume();let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.stringify(JSON.parse(d),null,2)))\"",
+    "prepare": "husky || true",
     "prepublishOnly": "npm run build",
     "prepack": "npm run build"
   },
@@ -41,16 +46,16 @@
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.17.0",
+    "@eslint/js": "^10.0.1",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/jest": "^29.5.14",
+    "@types/jest": "^30.0.0",
     "@types/node": "^22.19.11",
-    "eslint": "^9.0.0",
-    "eslint-config-prettier": "^9.0.0",
-    "globals": "^14.0.0",
-    "husky": "^8.0.3",
-    "jest": "^29.7.0",
-    "lint-staged": "^16.2.7",
+    "eslint": "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.3.0",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.3.0",
     "prettier": "^3.0.0",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",