feat: rename repo surface and add source-aware Databricks targets (#21)

* feat: rename repo surface and add source-aware Databricks targets

* fix: keep delta smoke schemas isolated from source defaults

Author: anand-testcompare

.depot/workflows/release.yml

@@ -14,8 +14,8 @@ jobs:
       contents: write
       pull-requests: write
     outputs:
-      release_created: ${{ steps.release.outputs['apps/convex-sync--release_created'] }}
-      tag_name: ${{ steps.release.outputs['apps/convex-sync--tag_name'] }}
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
       paths_released: ${{ steps.release.outputs.paths_released }}
     steps:
       - name: run-release-please

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  "apps/convex-sync": "0.0.2"
+  ".": "0.0.2"
 }

CHANGELOG.md

@@ -1,4 +1,14 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+## [0.0.2](https://github.com/shpitdev/convex-sync-kit/compare/v0.0.1...v0.0.2) (2026-04-20)
 
+### Features
+
+* automate stable releases from conventional PR titles ([#9](https://github.com/shpitdev/convex-sync-kit/issues/9)) ([494d7ea](https://github.com/shpitdev/convex-sync-kit/commit/494d7eab5ab33b4067e57d135ffdaa4e93bdb8cc))
+
+### Bug Fixes
+
+* make cargo package versions explicit for release-please ([#10](https://github.com/shpitdev/convex-sync-kit/issues/10)) ([00f3993](https://github.com/shpitdev/convex-sync-kit/commit/00f3993a2fb55728fe2c553d4c9b13dfd34192e9))
+* point release-please at convex-sync package ([#11](https://github.com/shpitdev/convex-sync-kit/issues/11)) ([04e5671](https://github.com/shpitdev/convex-sync-kit/commit/04e56710e464df453a29d2ad228177e290e365c6))
+
+All notable changes to `convex-sync-kit` will be documented in this file.

README.md

@@ -1,4 +1,4 @@
-# convex-streaming-olap-export
+# convex-sync-kit
 
 - `Language`: ![Rust](https://img.shields.io/badge/Rust-000000?logo=rust&logoColor=white)
 - `Source`: ![Convex](https://img.shields.io/badge/Convex-EE342F?logo=convex&logoColor=white)
@@ -22,7 +22,7 @@ extraction model:
 
 ```mermaid
 flowchart TD
-  Root[convex-streaming-olap-export]
+  Root[convex-sync-kit]
   Inspect[apps/convex-inspect]
   CLI[apps/convex-sync]
   Core[crates/convex-sync-core]
@@ -49,13 +49,14 @@ Read the repo by layer:
 - [`platform/databricks/README.md`](platform/databricks/README.md): Databricks target family overview
 - [`platform/databricks/s3/README.md`](platform/databricks/s3/README.md): Databricks consuming the S3 export path
 - [`platform/databricks/delta/README.md`](platform/databricks/delta/README.md): Databricks Delta bronze/silver landing
+- [`sources/README.md`](sources/README.md): source-specific defaults layered on top of the shared engine
 
 ## Install
 
 Release install:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/shpitdev/convex-streaming-olap-export/main/install.sh | bash
+curl -fsSL https://raw.githubusercontent.com/shpitdev/convex-sync-kit/main/install.sh | bash
 ```
 
 Local checkout dev install:
@@ -73,6 +74,17 @@ Current release coverage:
 - command symlinks go in `~/.local/bin`
 - `convex-inspect` is repo-local today and not part of the release artifact
 
+## Source Configs
+
+The repo name stays generic. Source-specific defaults live under `sources/`.
+
+- current source profile: `sources/meshix-api/env.sh`
+- activate a source by setting `CONVEX_SYNC_SOURCE=<slug>`
+- explicit env vars still win over source defaults
+
+This is the intended scaling model for running the same engine against many
+Convex projects without forking the repo or renaming the binaries.
+
 ## Operator Binaries
 
 - `convex-inspect`: inspect Convex schemas, snapshot pages, and delta pages directly
@@ -145,10 +157,18 @@ Runtime split:
 Packaged entrypoints:
 
 - `just databricks-delta-sync-secret`
+- `just databricks-delta-bootstrap <warehouse_id>`
 - `just databricks-delta-deploy`
 - `just databricks-delta-run`
 - `just databricks-delta-smoke <warehouse_id>`
 
+Recommended production naming:
+
+- S3-backed Databricks schema: `convex_sync_kit_<source>_s3`
+- Delta control schema: `convex_sync_kit_<source>_delta_control`
+- Delta bronze schema: `convex_sync_kit_<source>_delta_bronze`
+- Delta silver schema: `convex_sync_kit_<source>_delta_silver`
+
 ### `Databricks over S3`
 
 This variation keeps the existing Rust exporter and S3 publish loop, then adds:
@@ -199,7 +219,7 @@ Stable releases are driven by merged PR titles on `main`.
 
 - use conventional PR titles such as `feat: ...`, `fix: ...`, or `deps: ...`
 - `release-please` now starts release history from commit `0cf9f47`
-- merge to `main` opens or advances the stable release PR automatically when a releasable PR lands
+- merge to `main` opens or advances the stable release PR automatically when a releasable PR lands anywhere the repo-wide release config considers in scope
 - both release workflows also support manual `workflow_dispatch`, so there is always a button path in GitHub Actions
 
 ## References

apps/convex-sync/CHANGELOG.md

@@ -3,7 +3,7 @@ set -euo pipefail
 
 BINARY_NAME="convex-sync"
 DEV_BINARY_NAME="${CONVEX_SYNC_DEV_BIN_NAME:-convex-sync-dev}"
-REPO="shpitdev/convex-streaming-olap-export"
+REPO="shpitdev/convex-sync-kit"
 
 VERSION="${CONVEX_SYNC_VERSION:-latest}"
 INSTALL_MODE="${CONVEX_SYNC_INSTALL_MODE:-auto}"

install.sh

@@ -78,6 +78,9 @@ databricks-apply-sql-dir profile warehouse_id sql_dir:
 databricks-delta-sync-secret *args:
   ./scripts/ensure-databricks-delta-secret.sh {{args}}
 
+databricks-delta-bootstrap warehouse_id profile="DEFAULT":
+  ./scripts/bootstrap-databricks-delta.sh {{profile}} {{warehouse_id}}
+
 databricks-delta-deploy profile="DEFAULT" target="dev":
   ./scripts/deploy-databricks-delta.sh {{profile}} {{target}}
 

justfile

@@ -1,7 +1,7 @@
 aws_region                     = "us-east-1"
 aws_account_id                 = "123456789012"
-bucket_name                    = "example-convex-streaming-olap-export-bucket"
+bucket_name                    = "example-convex-sync-kit-bucket"
 current_prefix                 = "prod/staging/current"
-role_name                      = "example-convex-streaming-olap-export-databricks-prod-reader"
+role_name                      = "example-convex-sync-kit-databricks-prod-reader"
 databricks_unity_catalog_role_arn = "arn:aws:iam::123456789012:role/unity-catalog-prod-UCMasterRole-EXAMPLE"
 external_id                    = ""

platform/aws/s3_consumers/terraform/databricks_reader_role/terraform.tfvars.example

@@ -1,5 +1,5 @@
 aws_region                     = "us-east-1"
-bucket_name                    = "example-convex-streaming-olap-export-bucket"
+bucket_name                    = "example-convex-sync-kit-bucket"
 current_prefix                 = "prod/staging/current"
-role_name                      = "example-convex-streaming-olap-export-palantir-prod-reader"
+role_name                      = "example-convex-sync-kit-palantir-prod-reader"
 palantir_cloud_identity_role_arn = "arn:aws:iam::123456789012:role/foundry-cloud-identity-example"

platform/aws/s3_consumers/terraform/palantir_cloud_identity_reader_role/terraform.tfvars.example

@@ -1,7 +1,7 @@
 aws_region      = "us-east-1"
-bucket_name     = "example-convex-streaming-olap-export-bucket"
+bucket_name     = "example-convex-sync-kit-bucket"
 current_prefix  = "prod/staging/current"
-role_name       = "example-convex-streaming-olap-export-palantir-oidc-prod-reader"
+role_name       = "example-convex-sync-kit-palantir-oidc-prod-reader"
 oidc_provider_arn = "arn:aws:iam::123456789012:oidc-provider/example"
 oidc_issuer_url = "https://example.oidc.palantir.com/foundry"
 oidc_audience   = "replace-me"