feat: standalone app

.github/workflows/ci-absurd-sqlite-extension.yml

@@ -0,0 +1,31 @@
+name: Absurd SQLite Extension CI
+
+on:
+  pull_request:
+    paths:
+      - absurd-sqlite-extension/**
+      - Cargo.toml
+      - Cargo.lock
+      - .github/workflows/ci-absurd-sqlite-extension.yml
+
+jobs:
+  lint-format-test:
+    name: Lint, Format, Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Format check
+        run: cargo fmt -p absurd_sqlite_extension -- --check
+
+      - name: Lint
+        run: cargo clippy -p absurd_sqlite_extension -- -D warnings
+
+      - name: Unit tests
+        run: cargo test -p absurd_sqlite_extension

.github/workflows/ci-standalone.yml

@@ -0,0 +1,57 @@
+name: Standalone App CI
+
+on:
+  pull_request:
+    paths:
+      - standalone/**
+      - Cargo.toml
+      - Cargo.lock
+      - .github/workflows/ci-standalone.yml
+
+jobs:
+  lint-format-test:
+    name: Lint, Format, Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Install Linux dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            librsvg2-dev \
+            libwebkit2gtk-4.1-dev \
+            libglib2.0-dev \
+            pkg-config
+
+      - name: Build SQLite extension
+        run: cargo build -p absurd_sqlite_extension
+
+      - name: Frontend install
+        working-directory: standalone
+        run: bun install --frozen-lockfile
+
+      - name: Frontend check
+        working-directory: standalone
+        run: bun check
+
+      - name: Backend format check
+        run: cargo fmt -p AbsurdSQLite -- --check
+
+      - name: Backend lint
+        run: cargo clippy -p AbsurdSQLite -- -D warnings
+
+      - name: Backend tests
+        run: cargo test -p AbsurdSQLite

AGENTS.md

@@ -0,0 +1,33 @@
+# Absurd-SQLite
+
+Absurd-SQLite is a SQLite based durable execution engine designed for personal / homelab / edge computing environments.
+
+This project is based on the PostgreSQL implementation from [absurd](https://github.com/earendil-works/absurd).
+
+## Key Concepts
+
+A task is subdivided into steps that act as checkpoints. Tasks can suspend (for sleep or events) and resume without data loss.
+State data is stored in the SQLite tables below:
+
+- Queues: `absurd_queues` scopes all durable execution by `queue_name`.
+- Tasks: `absurd_tasks` stores task definitions, parameters, headers, retry/cancel info, idempotency keys, and task state.
+- Runs: `absurd_runs` represents per-attempt execution for a task with claim/lease timing, availability, and results/failures.
+- Checkpoints: `absurd_checkpoints` tracks named task checkpoints with optional state and run ownership.
+- Events: `absurd_events` stores emitted events with JSON payloads scoped by queue and event name.
+- Waits: `absurd_waits` records task steps waiting on events or timeouts.
+
+To interact with the system, a SQLite extension is provided and exposed various SQL functions.
+
+## Repository Structure
+
+- `absurd-sqlite-extension`: Core Rust crate providing the SQLite extension, engine logic, and schema migrations.
+- `standalone`: Tauri + SvelteKit desktop app.
+- `sdks`: Client SDKs for different languages.
+- `samples`: Example applications demonstrating usage.
+
+## Development
+
+General rule: please make sure to lint, format, and test code after making changes. No need to ask for human confirmation
+before running linters / formatters / tests.
+
+Please follow the sub-project README.md / AGENTS.md for detailed instructions.