feat: rebuild Dart ORM with standalone typed layers and native drivers

.github/workflows/ci.yml

@@ -0,0 +1,111 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Dart and databases
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_USER: orm
+          POSTGRES_PASSWORD: orm
+          POSTGRES_DB: orm_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready --username=orm --dbname=orm_test"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: orm_root
+          MYSQL_USER: orm
+          MYSQL_PASSWORD: orm
+          MYSQL_DATABASE: orm_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysql --protocol=TCP --host=127.0.0.1 --user=orm --password=orm --database=orm_test --execute='SELECT 1'"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+      mariadb:
+        image: mariadb:11.8
+        env:
+          MARIADB_ROOT_PASSWORD: orm_root
+          MARIADB_USER: orm
+          MARIADB_PASSWORD: orm
+          MARIADB_DATABASE: orm_test
+        ports:
+          - 3307:3306
+        options: >-
+          --health-cmd="healthcheck.sh --connect --innodb_initialized"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+    env:
+      ORM_TEST_POSTGRES: postgres://orm:orm@127.0.0.1:5432/orm_test
+      # Migration recovery tests create an isolated database per test process.
+      ORM_TEST_MYSQL: mysql://root:orm_root@127.0.0.1:3306/orm_test
+      ORM_TEST_MARIADB: mariadb://root:orm_root@127.0.0.1:3307/orm_test
+      # Both containers generate self-signed certificates. Still require TLS.
+      ORM_TEST_MYSQL_TLS: require
+      ORM_TEST_MARIADB_TLS: require
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: dart-lang/setup-dart@v1
+        with:
+          sdk: 3.13.3
+      - name: Install dependencies
+        run: dart pub get --enforce-lockfile
+      - name: Check formatting
+        run: dart format --output=none --set-exit-if-changed bin lib test tool example
+      - name: Analyze Dart package and examples
+        # The Flutter example is a separate package with its own SDK dependency.
+        run: |
+          for target in bin lib test tool example/*.dart example/migrations example/teams; do
+            dart analyze "$target"
+          done
+      - name: Check committed SQLite web assets
+        run: dart run tool/build_sqlite_web.dart --check
+      - name: Test SQLite, PostgreSQL, MySQL and MariaDB
+        run: dart test --concurrency=1
+
+  browser:
+    name: Chrome JS and WASM
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: dart-lang/setup-dart@v1
+        with:
+          sdk: 3.13.3
+      - name: Install dependencies
+        run: dart pub get --enforce-lockfile
+      - name: Locate Chrome
+        run: echo "CHROME_EXECUTABLE=$(command -v google-chrome)" >> "$GITHUB_ENV"
+      - name: Test Chrome with JavaScript
+        run: dart run tool/test_browser.dart
+      - name: Test Chrome with WebAssembly
+        run: dart run tool/test_browser.dart --wasm

.gitignore

@@ -1,5 +1,7 @@
+.dart_tool/
+build/
+*.sqlite
+*.sqlite-shm
+*.sqlite-wal
 .DS_Store
 .env
-.idea/
-.vscode/
-.dart_tool/

AGENTS.md

@@ -0,0 +1,23 @@
+# Dart ORM
+
+This branch is a new implementation. The design reference is
+`research/new-dart-orm-design.md`; old code and upstream architecture are retired.
+
+- Keep one product package. Add abstractions only to support real use cases.
+- Use Dart 3.13 stable syntax, static generation, explicit sessions and typed selections.
+- Table identity is independent of Dart record identity.
+- Parameterize values, quote identifiers, and validate SQL scope before execution.
+- Make relationship query counts and transaction boundaries observable.
+- SQLite and PostgreSQL have separate driver configuration and capability checks.
+- Verify behavior against real databases. Mark unverified platforms explicitly.
+- Preserve immutable migration history and never infer destructive renames.
+- Each migration history fixes one database engine. Save only that engine's SQL,
+  steps and frozen schema; reject mixed histories and mismatched connections.
+- Prefer small Conventional Commits. Do not push without explicit authorization.
+- Keep `docs/progress.md` accurate, including unfinished work and validation limits.
+- Schema snapshots and saved migrations are Dart source. Retire the old JSON file
+  workflow directly; do not add compatibility readers or parallel output modes.
+- Keep historical migration definitions independent of current application models.
+  Persist reviewed fingerprints and use static imports for migration registration.
+
+Commands: `dart run bin/orm.dart`, `dart analyze`, `dart test`.