Merge remote-tracking branch 'origin/pr-217-head' into copilot/fix-comments-review-thread-217

Author: Copilot

.github/config/en-drasi.txt

@@ -210,6 +210,7 @@ SignalRHub
 slidingWindow
 sortBy
 SourceConfirm
+startPosition
 sourceprovider
 SourceProvider
 SourceProviders

docs/content/drasi-server/how-to-guides/configuration/configure-bootstrap-providers/_index.md

@@ -32,6 +32,15 @@ description: "Load initial data before streaming begins"
       </div>
     </div>
   </a> -->
+  <a href="configure-mysql-bootstrap-provider/">
+    <div class="unified-card unified-card--howto">
+      <div class="unified-card-icon"><i class="fas fa-database"></i></div>
+      <div class="unified-card-content">
+        <h3 class="unified-card-title">MySQL</h3>
+        <p class="unified-card-summary">Bootstrap from a MySQL snapshot (MySQL sources only)</p>
+      </div>
+    </div>
+  </a>
   <a href="configure-postgres-bootstrap-provider/">
     <div class="unified-card unified-card--howto">
       <div class="unified-card-icon"><i class="fas fa-database"></i></div>

docs/content/drasi-server/how-to-guides/configuration/configure-bootstrap-providers/configure-mysql-bootstrap-provider/_index.md

@@ -0,0 +1,107 @@
+---
+type: "docs"
+title: "Configure MySQL Bootstrap Provider"
+linkTitle: "MySQL"
+weight: 45
+description: "Bootstrap queries from a MySQL snapshot"
+related:
+  howto:
+    - title: "Configure Sources"
+      url: "/drasi-server/how-to-guides/configuration/configure-sources/"
+    - title: "Configure MySQL Source"
+      url: "/drasi-server/how-to-guides/configuration/configure-sources/configure-mysql-source/"
+    - title: "Configure Bootstrap Providers"
+      url: "/drasi-server/how-to-guides/configuration/configure-bootstrap-providers/"
+---
+
+The **MySQL bootstrap provider** loads initial state from a MySQL database so queries start with a complete snapshot before streaming begins.
+
+## When to use MySQL bootstrap
+
+- You need historical/current state from MySQL when a query starts.
+- Your query depends on existing rows (aggregations, joins, thresholds).
+- You want snapshot + binlog streaming from the same database.
+
+## Prerequisites
+
+- Use with a **MySQL source** (`sources[].kind: mysql`).
+- The database user must have **SELECT** permission on the configured tables.
+- The `tables` list is **required** — you must explicitly specify which tables to bootstrap.
+
+## Quick example (Drasi Server config)
+
+In Drasi Server config, bootstrap provider keys are **camelCase**, and the discriminator field is `bootstrapProvider.kind`.
+
+```yaml
+sources:
+  - kind: mysql
+    id: orders-db
+    autoStart: true
+
+    host: ${MYSQL_HOST:-localhost}
+    port: ${MYSQL_PORT:-3306}
+    database: ${MYSQL_DATABASE:-mydb}
+    user: ${MYSQL_USER:-drasi_user}
+    password: ${MYSQL_PASSWORD}
+
+    tables:
+      - orders
+      - customers
+
+    bootstrapProvider:
+      kind: mysql
+```
+
+## Configuration reference
+
+| Field | Type | Required | Description |
+|---|---|---:|---|
+| `kind` | string | Yes | Must be `mysql`. |
+| `host` | string | No | MySQL host (default: `localhost`). |
+| `port` | integer | No | MySQL port (default: `3306`). |
+| `database` | string | Yes | Database name to connect to. |
+| `user` | string | Yes | Database user with SELECT permission. |
+| `password` | string | No | Password (default: `""`). |
+| `tables` | string[] | Yes | Table allow-list for bootstrapping. Must contain at least one table. |
+| `tableKeys` | array | No | Override key columns per table (see below). |
+
+### tableKeys
+
+Use `tableKeys` to define key columns for element ID generation when primary keys are missing.
+
+```yaml
+bootstrapProvider:
+  kind: mysql
+  tableKeys:
+    - table: order_items
+      keyColumns: [order_id, product_id]
+```
+
+## Notes
+
+- Drasi Server only allows `kind: mysql` when the source is also `kind: mysql`.
+- The `tables` list acts as a security allow-list — only tables explicitly listed will be bootstrapped.
+- Table names must use only letters, numbers, and underscores.
+
+## Documentation resources
+
+<div class="card-grid card-grid--2">
+  <a href="https://github.com/drasi-project/drasi-core/blob/main/components/bootstrappers/mysql/README.md" target="_blank" rel="noopener">
+    <div class="unified-card unified-card--tutorials">
+      <div class="unified-card-icon"><i class="fab fa-github"></i></div>
+      <div class="unified-card-content">
+        <h3 class="unified-card-title">MySQL Bootstrap README</h3>
+        <p class="unified-card-summary">Implementation notes and behavior details</p>
+      </div>
+    </div>
+  </a>
+  <a href="https://crates.io/crates/drasi-bootstrap-mysql" target="_blank" rel="noopener">
+    <div class="unified-card unified-card--howto">
+      <div class="unified-card-icon"><i class="fas fa-box"></i></div>
+      <div class="unified-card-content">
+        <h3 class="unified-card-title">drasi-bootstrap-mysql on crates.io</h3>
+        <p class="unified-card-summary">Package info and release history</p>
+      </div>
+    </div>
+  </a>
+</div>

docs/content/drasi-server/how-to-guides/configuration/configure-sources/_index.md

@@ -48,6 +48,15 @@ description: "Connect Drasi Server to databases, APIs, and data streams"
       </div>
     </div>
   </a> -->
+  <a href="configure-mysql-source/">
+    <div class="unified-card unified-card--howto">
+      <div class="unified-card-icon"><i class="fas fa-database"></i></div>
+      <div class="unified-card-content">
+        <h3 class="unified-card-title">MySQL</h3>
+        <p class="unified-card-summary">Stream changes from MySQL using binlog replication</p>
+      </div>
+    </div>
+  </a>
   <a href="configure-postgresql-source/">
     <div class="unified-card unified-card--howto">
       <div class="unified-card-icon"><i class="fas fa-database"></i></div>