feat: define pure engine contracts and enforce crate boundaries

Author: nosam1998

.cargo/config.toml

@@ -0,0 +1,2 @@
+[alias]
+xtask = "run --package xtask --"

.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: Rust CI
+on:
+  pull_request:
+  push:
+    branches: [main]
+permissions:
+  contents: read
+concurrency:
+  group: rust-ci-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo test --workspace --all-features --locked
+      - run: cargo xtask check-deps
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo fmt --all -- --check
+      - run: cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
+  dependencies:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: taiki-e/install-action@cargo-deny
+      - run: cargo deny --locked check
+  core-api:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: taiki-e/install-action@cargo-semver-checks
+      - name: Check core compatibility against the PR base
+        if: github.event_name == 'pull_request'
+        env:
+          BASE_REF: ${{ github.event.pull_request.base.sha }}
+        run: |
+          if git cat-file -e "$BASE_REF:crates/core/gfa-core/Cargo.toml"; then
+            cargo semver-checks check-release -p gfa-core --baseline-rev "$BASE_REF"
+          else
+            echo "Initial core API: no baseline crate exists yet."
+          fi

.gitignore

@@ -0,0 +1,9 @@
+/target/
+node_modules/
+dist/
+*.db
+*.db-shm
+*.db-wal
+.env
+.venv/
+__pycache__/

Cargo.lock

@@ -0,0 +1,31 @@
+[workspace]
+resolver = "2"
+members = [
+    "crates/core/gfa-core",
+    "xtask",
+]
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"
+license = "GPL-3.0-only"
+repository = "https://github.com/CurtisTechSolutions/GamesForAI"
+
+[workspace.dependencies]
+gfa-core = { version = "0.1.0", path = "crates/core/gfa-core" }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+schemars = "0.8.22"
+thiserror = "2"
+
+[workspace.lints.rust]
+unsafe_code = "forbid"
+missing_docs = "warn"
+
+[workspace.lints.clippy]
+unwrap_used = "deny"
+expect_used = "deny"
+
+[profile.release]
+lto = "thin"
+codegen-units = 1

Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "gfa-core"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[dependencies]
+serde.workspace = true
+serde_json.workspace = true
+schemars.workspace = true
+thiserror.workspace = true
+
+[lints]
+workspace = true