feat: add workflows for cherry-picking and release management

- Implement cherry-pick workflow to automate cherry-picking merged PRs to main
- Create script to compute next patch version based on git tags
- Enhance release branch creation workflow with input validation and versioning
- Add publish release workflow for managing npm package releases
- Introduce trigger for documentation updates on release and PR merges

Author: frontegg-david

docs/api-reference/errors.mdx

@@ -0,0 +1,220 @@
+---
+title: "Error Classes"
+description: "VectoriaDB error types and codes"
+icon: "triangle-exclamation"
+---
+
+All VectoriaDB errors extend `VectoriaError` and include machine-readable `code` values.
+
+## Error Types
+
+| Error | Code | Description |
+|-------|------|-------------|
+| `VectoriaNotInitializedError` | `NOT_INITIALIZED` | Call `initialize()` first |
+| `DocumentValidationError` | `DOCUMENT_VALIDATION_ERROR` | Invalid document data |
+| `DocumentNotFoundError` | `DOCUMENT_NOT_FOUND` | Document ID doesn't exist |
+| `DocumentExistsError` | `DOCUMENT_EXISTS` | Document ID already exists |
+| `DuplicateDocumentError` | `DUPLICATE_DOCUMENT` | Duplicate in batch |
+| `QueryValidationError` | `QUERY_VALIDATION_ERROR` | Invalid search query |
+| `EmbeddingError` | `EMBEDDING_ERROR` | Model embedding failed |
+| `StorageError` | `STORAGE_ERROR` | Storage operation failed |
+| `ConfigurationError` | `CONFIGURATION_ERROR` | Invalid config |
+
+## Importing Errors
+
+```ts
+import {
+  VectoriaError,
+  VectoriaNotInitializedError,
+  DocumentValidationError,
+  DocumentNotFoundError,
+  DocumentExistsError,
+  DuplicateDocumentError,
+  QueryValidationError,
+  EmbeddingError,
+  StorageError,
+  ConfigurationError,
+} from 'vectoriadb';
+```
+
+## VectoriaError
+
+Base class for all VectoriaDB errors.
+
+```ts
+class VectoriaError extends Error {
+  readonly code: string;
+
+  constructor(message: string, code: string);
+}
+```
+
+---
+
+## VectoriaNotInitializedError
+
+Thrown when operations are attempted before initialization.
+
+```ts
+class VectoriaNotInitializedError extends VectoriaError {
+  constructor(operation: string);
+}
+```
+
+### Example
+
+```ts
+try {
+  await db.add('id', 'text', metadata);
+} catch (error) {
+  if (error instanceof VectoriaNotInitializedError) {
+    await db.initialize();
+    await db.add('id', 'text', metadata);
+  }
+}
+```
+
+---
+
+## DocumentValidationError
+
+Thrown when document validation fails.
+
+```ts
+class DocumentValidationError extends VectoriaError {
+  readonly documentId?: string;
+
+  constructor(message: string, documentId?: string);
+}
+```
+
+---
+
+## DocumentNotFoundError
+
+Thrown when a document ID doesn't exist.
+
+```ts
+class DocumentNotFoundError extends VectoriaError {
+  readonly documentId: string;
+
+  constructor(documentId: string);
+}
+```
+
+---
+
+## DocumentExistsError
+
+Thrown when adding a document with an existing ID.
+
+```ts
+class DocumentExistsError extends VectoriaError {
+  readonly documentId: string;
+
+  constructor(documentId: string);
+}
+```
+
+---
+
+## DuplicateDocumentError
+
+Thrown when duplicates are found in batch operations.
+
+```ts
+class DuplicateDocumentError extends VectoriaError {
+  readonly documentId: string;
+  readonly context: 'batch' | 'existing';
+
+  constructor(documentId: string, context: 'batch' | 'existing');
+}
+```
+
+---
+
+## QueryValidationError
+
+Thrown when search parameters are invalid.
+
+```ts
+class QueryValidationError extends VectoriaError {
+  constructor(message: string);
+}
+```
+
+---
+
+## EmbeddingError
+
+Thrown when embedding generation fails.
+
+```ts
+class EmbeddingError extends VectoriaError {
+  readonly details?: any;
+
+  constructor(message: string, details?: any);
+}
+```
+
+---
+
+## StorageError
+
+Thrown when storage operations fail.
+
+```ts
+class StorageError extends VectoriaError {
+  readonly originalError?: Error;
+
+  constructor(message: string, originalError?: Error);
+}
+```
+
+---
+
+## ConfigurationError
+
+Thrown when configuration is invalid.
+
+```ts
+class ConfigurationError extends VectoriaError {
+  constructor(message: string);
+}
+```
+
+## Error Handling Pattern
+
+```ts
+try {
+  await db.addMany(documents);
+} catch (error) {
+  if (error instanceof VectoriaNotInitializedError) {
+    await db.initialize();
+    return; // Retry
+  }
+
+  if (error instanceof DocumentValidationError) {
+    console.warn(`Invalid document: ${error.documentId}`);
+    return;
+  }
+
+  if (error instanceof VectoriaError) {
+    console.error(`VectoriaDB error [${error.code}]:`, error.message);
+    return;
+  }
+
+  throw error; // Re-throw unexpected errors
+}
+```
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Common Errors" icon="triangle-exclamation" href="/troubleshooting/common-errors">
+    Error solutions
+  </Card>
+  <Card title="FAQ" icon="circle-question" href="/troubleshooting/faq">
+    Frequently asked questions
+  </Card>
+</CardGroup>

docs/api-reference/interfaces/config.mdx

@@ -0,0 +1,171 @@
+---
+title: "Configuration Interfaces"
+description: "VectoriaConfig and related configuration types"
+icon: "gear"
+---
+
+Configuration interfaces for VectoriaDB.
+
+## VectoriaConfig
+
+Main configuration interface for VectoriaDB constructor.
+
+```ts
+interface VectoriaConfig {
+  /**
+   * Name of the embedding model to use
+   * @default 'Xenova/all-MiniLM-L6-v2'
+   */
+  modelName?: string;
+
+  /**
+   * Directory to cache downloaded models
+   * @default './.cache/transformers'
+   */
+  cacheDir?: string;
+
+  /**
+   * Vector dimensions (auto-detected from model if not provided)
+   */
+  dimensions?: number;
+
+  /**
+   * Default similarity threshold for search results
+   * @default 0.3
+   */
+  defaultSimilarityThreshold?: number;
+
+  /**
+   * Maximum number of results to return by default
+   * @default 10
+   */
+  defaultTopK?: number;
+
+  /**
+   * Enable HNSW index for faster search
+   * @default false
+   */
+  useHNSW?: boolean;
+
+  /**
+   * HNSW index configuration
+   */
+  hnsw?: HNSWConfig;
+
+  /**
+   * Storage adapter for persisting embeddings
+   * @default MemoryStorageAdapter
+   */
+  storageAdapter?: StorageAdapter;
+
+  /**
+   * Tools hash for cache invalidation
+   */
+  toolsHash?: string;
+
+  /**
+   * Version string for cache compatibility
+   * @default '1.0.0'
+   */
+  version?: string;
+
+  /**
+   * Maximum number of documents allowed
+   * @default 100000
+   */
+  maxDocuments?: number;
+
+  /**
+   * Maximum size of a single document text (in characters)
+   * @default 1000000
+   */
+  maxDocumentSize?: number;
+
+  /**
+   * Maximum number of documents in a single batch
+   * @default 1000
+   */
+  maxBatchSize?: number;
+
+  /**
+   * Enable verbose error messages
+   * @default true
+   */
+  verboseErrors?: boolean;
+}
+```
+
+---
+
+## HNSWConfig
+
+Configuration for HNSW indexing.
+
+```ts
+interface HNSWConfig {
+  /**
+   * Maximum connections per node in layer > 0
+   * @default 16
+   */
+  M?: number;
+
+  /**
+   * Maximum connections for layer 0
+   * @default 32
+   */
+  M0?: number;
+
+  /**
+   * Candidate list size during construction
+   * @default 200
+   */
+  efConstruction?: number;
+
+  /**
+   * Candidate list size during search
+   * @default 50
+   */
+  efSearch?: number;
+}
+```
+
+---
+
+## StorageAdapterConfig
+
+Base configuration for storage adapters.
+
+```ts
+interface StorageAdapterConfig {
+  /**
+   * Namespace for storage keys
+   */
+  namespace?: string;
+
+  /**
+   * Whether to automatically save on changes
+   * @default false
+   */
+  autoSave?: boolean;
+
+  /**
+   * Interval for auto-save in milliseconds
+   * @default 60000
+   */
+  autoSaveInterval?: number;
+}
+```
+
+## Related
+
+<CardGroup cols={3}>
+  <Card title="Constructor" icon="plus" href="/api-reference/vectoriadb/constructor">
+    Using config
+  </Card>
+  <Card title="Documents" icon="file-lines" href="/api-reference/interfaces/documents">
+    Document interfaces
+  </Card>
+  <Card title="Search" icon="magnifying-glass" href="/api-reference/interfaces/search">
+    Search interfaces
+  </Card>
+</CardGroup>