feat: add JSON column support and GitHub workflows

- Add JSON column deserialization support in SelectQuery
- Add GitHub CI, build, and publish workflows
- Add issue templates for bug reports and feature requests
- Update version to 0.10.0 and repository URL
- Update documentation with query predicate clarifications
- Make MigrationRunner internal for cleaner API

Author: itsAudioo

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,53 @@
+name: Bug Report
+description: Report a problem with SwiftSQL
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What happened instead?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Reproduction steps
+      description: Provide minimal steps or a small sample
+      placeholder: |
+        1. 
+        2. 
+        3. 
+    validations:
+      required: true
+  - type: dropdown
+    id: dialect
+    attributes:
+      label: Database dialect
+      options:
+        - SQLite
+        - MySQL / MariaDB
+        - PostgreSQL
+        - Other
+    validations:
+      required: true
+  - type: input
+    id: swiftsql_version
+    attributes:
+      label: SwiftSQL version
+      placeholder: 1.0.0
+    validations:
+      required: true
+  - type: input
+    id: swiftly_version
+    attributes:
+      label: SwiftlyS2 version
+      placeholder: 1.0.0

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature Request
+description: Suggest an improvement for SwiftSQL
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem description
+      description: What problem are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the change you want
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you considered
+    validations:
+      required: false
+  - type: textarea
+    id: fit
+    attributes:
+      label: Why this fits SwiftSQL philosophy
+      description: Keep it explicit, small, and predictable
+    validations:
+      required: true

.github/workflows/build.yml

@@ -0,0 +1,21 @@
+name: Build
+
+on:
+  pull_request:
+  push:
+    branches:
+      - '**'
+    tags:
+      - '*'
+
+jobs:
+  build:
+    if: ${{ github.event_name == 'pull_request' || contains(github.event.head_commit.message, '[build]') || startsWith(github.ref, 'refs/tags/') }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+      - run: dotnet restore
+      - run: dotnet build -c Release --no-restore

.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - '**'
+
+jobs:
+  test:
+    if: ${{ github.event_name == 'pull_request' || contains(github.event.head_commit.message, '[ci]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+      - run: dotnet restore
+      - run: dotnet build -c Release --no-restore
+      - run: dotnet test -c Release --no-build --verbosity normal

.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - '**'
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  publish:
+    if: ${{ github.event_name == 'push' && (startsWith(github.ref, 'refs/tags/v') || contains(github.event.head_commit.message, '[publish]')) }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+      - run: dotnet restore
+      - run: dotnet pack -c Release --no-restore
+      - run: dotnet nuget push "**/*.nupkg" --skip-duplicate --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json

CONTRIBUTING.md

@@ -1,95 +1,38 @@
 # Contributing to SwiftSQL
 
-Thanks for your interest in contributing to SwiftSQL.
+SwiftSQL is intentionally small, explicit, and conservative. Thanks for keeping it that way.
 
-SwiftSQL is intentionally small, explicit, and conservative by design.
-Contributions are welcome, but only when they align with the project’s core goals.
+## Local build and tests
 
----
-
-## Project goals
-
-SwiftSQL exists to provide:
-
-- A lightweight async ORM for plugin environments
-- Explicit database access (no hidden magic)
-- Stateless, thread-safe operation
-- Compatibility with externally managed IDbConnection instances
-- Predictable behavior under concurrency (Task.WhenAll)
-
-If a change pushes the project toward a full framework ORM, it will likely be rejected.
-
----
-
-## Non-goals (important)
-
-SwiftSQL does NOT aim to support:
-
-- Change tracking
-- DbContext-style lifetimes
-- Navigation properties or automatic joins
-- Automatic schema diffing or repair
-- Complex LINQ providers
-- JSON-path querying
-- ORM-managed aggregates
-
-Please do not propose features in these areas.
-
----
-
-## What contributions are welcome
-
-- Bug fixes
-- Performance improvements
-- Dialect correctness fixes
-- Test coverage improvements
-- Documentation improvements
-- Small, explicit features that fit the existing design (for example: JSON column support)
-
-When in doubt, open an issue before writing a large change.
-
----
-
-## Code guidelines
-
-- Target framework: net10.0
-- Async-only APIs
-- No global mutable state
-- No connection ownership inside the ORM
-- Prefer explicit behavior over convenience
-- Keep public API surface minimal and intentional
-
-All new behavior should be covered by tests.
-
----
-
-## Tests
-
-- Tests live in `SwiftSQL.Tests`
-- SQLite is sufficient for most tests
-- New features must include tests
-- All tests must pass before a PR is considered
+```
+dotnet build
+dotnet run -c Release --project SwiftSQL.Tests/SwiftSQL.Tests.csproj
+```
 
-Run locally with:
+## Coding style
 
-dotnet build
-dotnet run -c Release --project SwiftSQL.Tests
+- Clarity and predictability over cleverness
+- Keep async APIs async-only
+- Avoid shared mutable state
+- Keep the public API surface minimal and intentional
 
----
+## Public API changes
 
-## Pull requests
+- Breaking changes require discussion before a PR
+- If behavior must change, document the impact and migration path
 
-- Keep PRs focused and small
-- Avoid refactors unrelated to the change
-- Explain why the change is needed, not just what it does
-- Breaking changes require discussion first
+## Issues and pull requests
 
----
+- File issues with clear steps or a minimal repro
+- Keep PRs focused and explain why the change is needed
+- Avoid unrelated refactors
 
-## License
+## Branching
 
-By contributing, you agree that your contributions are licensed under the same license as the project (MIT).
+- main is stable and release-ready
+- Features and fixes land via PRs
 
----
+## Testing expectations
 
-Thanks for helping keep SwiftSQL simple, predictable, and boring (in the best possible way).
+- New code must include tests
+- All tests must pass before review

EntryPoint.cs

@@ -93,6 +93,15 @@ public static Task<int> DeleteAsync<T>(
         return QuerySingleWithJsonAsync<T>(connection, command, map, cancellationToken);
     }
 
+    /// <summary>
+    /// Gets an entity by primary key or returns a default instance without writing to the database.
+    /// </summary>
+    /// <param name="connection">Open database connection.</param>
+    /// <param name="primaryKey">Primary key value.</param>
+    /// <param name="defaultFactory">Factory used when the entity is not found.</param>
+    /// <param name="dialect">SQL dialect.</param>
+    /// <param name="transaction">Optional transaction.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
     public static async Task<T> GetOrDefaultAsync<T>(
         IDbConnection connection,
         object primaryKey,

Migrations/MigrationRunner.cs

@@ -8,7 +8,7 @@ namespace SwiftSQL.Migrations;
 /// <summary>
 /// Runs explicit, versioned migrations and tracks applied versions.
 /// </summary>
-public static class MigrationRunner
+internal static class MigrationRunner
 {
     /// <summary>
     /// Creates the schema migrations tracking table if it does not already exist.

README.md

@@ -299,6 +299,12 @@ GetOrDefaultAsync (read-only, does not write to the database):
         );
 ```
 
+defaultFactory is only invoked when no row exists, and the default value is not
+inserted.
+
+QueryAsync and Select.Where predicates support simple comparisons (==,
+!=, >, >=, <, <=) combined with && and || over mapped properties.
+
 ---
 
 ## 7. Updating data