SQLite read layer for the canonical pricing database — decision record + Phases 0 & 1

.github/workflows/database-release.yml

@@ -0,0 +1,63 @@
+name: Publish Database Release
+
+# Builds the derived SQLite databases from the committed canonical JSON and
+# publishes them to the rolling `database-latest` GitHub Release, giving
+# consumers stable download URLs:
+#   https://github.com/Atena-IT/tokenpricing/releases/download/database-latest/prices.db
+#   https://github.com/Atena-IT/tokenpricing/releases/download/database-latest/prices-current.db
+#
+# Two assets are published:
+#   prices.db          — full database including price_history (dashboard / history charts)
+#   prices-current.db  — slim database without price_history (SDK default, smaller download)
+#
+# Triggers:
+#   - workflow_dispatch: manual, on-demand publish
+#   - push of a `database-release-*` tag: lets the release be (re)published from
+#     any ref, including before this workflow lands on the default branch
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "database-release-*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: latest
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        working-directory: services/sync
+        run: uv sync
+      - name: Build prices.db from committed canonical JSON
+        working-directory: services/sync
+        run: uv run tokenpricing-sync build-db
+      - name: Publish databases to the rolling database-latest release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: database-latest
+          name: Canonical pricing database (latest)
+          body: |
+            Auto-published derived SQLite builds of the canonical pricing database,
+            schema v1 (`PRAGMA user_version = 1`).
+
+            | Asset | Contents | Primary consumer |
+            |---|---|---|
+            | `prices.db` | Full database with `price_history` | Dashboard, history charts |
+            | `prices-current.db` | Slim database without `price_history` | Python SDK (default), other SDK consumers |
+
+            This is a **rolling** release: both assets are replaced on every
+            database sync, so the download URLs are stable. These are data
+            artifacts, not software releases.
+          files: |
+            database/current/prices.db
+            database/current/prices-current.db
+          make_latest: false
+          prerelease: false

.github/workflows/database-sync.yml

@@ -30,7 +30,13 @@ jobs:
           if [ "${#history_files[@]}" -gt 42 ]; then
             printf '%s\0' "${history_files[@]:42}" | xargs -0 rm -f --
           fi
+      - name: Build prices.db
+        working-directory: services/sync
+        run: uv run tokenpricing-sync build-db
       - name: Commit refreshed data
+        # Only scheduled runs persist refreshed data to git. Manual dispatches
+        # refresh the release/artifact for testing without mutating the branch.
+        if: github.event_name == 'schedule'
         run: |
           if git diff --quiet; then
             echo "No database changes"
@@ -41,3 +47,34 @@ jobs:
           git add database/current database/history database/changelog
           git commit -m "chore: refresh canonical pricing database"
           git push
+      - name: Upload databases as workflow artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: prices-db
+          path: |
+            database/current/prices.db
+            database/current/prices-current.db
+          if-no-files-found: error
+          retention-days: 7
+      - name: Publish databases to the rolling database-latest release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: database-latest
+          name: Canonical pricing database (latest)
+          body: |
+            Auto-published derived SQLite builds of the canonical pricing database,
+            schema v1 (`PRAGMA user_version = 1`).
+
+            | Asset | Contents | Primary consumer |
+            |---|---|---|
+            | `prices.db` | Full database with `price_history` | Dashboard, history charts |
+            | `prices-current.db` | Slim database without `price_history` | Python SDK (default), other SDK consumers |
+
+            This is a **rolling** release: both assets are replaced on every
+            database sync, so the download URLs are stable. These are data
+            artifacts, not software releases.
+          files: |
+            database/current/prices.db
+            database/current/prices-current.db
+          make_latest: false
+          prerelease: false

.gitignore

@@ -50,6 +50,16 @@ coverage.xml
 cython_debug
 db.sqlite3
 db.sqlite3-journal
+
+# Derived SQLite databases (built by CI, not committed to git)
+database/current/prices.db
+database/current/prices.db-wal
+database/current/prices.db-shm
+database/current/prices-current.db
+database/current/prices-current.db-wal
+database/current/prices-current.db-shm
+*.db-wal
+*.db-shm
 develop-eggs
 dist
 dmypy.json