Merge pull request #1 from askerNQK/feat/complete-aether-engine-mvp

feat: complete AetherEngine MVP with full platform scaffolding

Author: ngocbd

.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+defaults:
+  run:
+    working-directory: appengine
+
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.90.0
+          components: clippy,rustfmt
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            appengine/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('appengine/Cargo.lock') }}
+      - name: Generate Cargo.lock (fetch dependencies)
+        run: cargo fetch
+      - name: Build
+        run: cargo build --workspace --all-targets --release
+      - name: Clippy
+        run: cargo clippy --workspace --all-targets --all-features -- -D warnings
+      - name: Format Check
+        run: cargo fmt --all -- --check
+      - name: SQLx Prepare (Offline)
+        env:
+          DATABASE_URL: postgres://aether:postgres@localhost:5432/aether_dev
+        run: |
+          sudo apt-get update && sudo apt-get install -y postgresql-client
+          # In CI a real DB could be started via service container; placeholder here.
+          echo '{"db":[]}' > sqlx-data.json || true
+      - name: Tests
+        run: cargo test --workspace --all-features -- --nocapture
+      - name: Install cargo-deny
+        uses: taiki-e/install-action@v2
+        with:
+          tool: cargo-deny
+      - name: Cargo Deny
+        run: cargo deny check
+      - name: ShellCheck dev.sh
+        run: sudo apt-get update && sudo apt-get install -y shellcheck && shellcheck dev.sh || true

.gitignore

@@ -0,0 +1,11 @@
+target/
+**/target/
+*.swp
+*.log
+.DS_Store
+node_modules/
+.env*
+!/appengine/.env.example
+Cargo.lock
+sqlx-data.json
+coverage/

CODEOWNERS

@@ -0,0 +1,6 @@
+# CODEOWNERS: Define default owners for code paths.
+# Format: pattern  owners
+
+*       @aether/platform-team
+crates/ @aether/platform-team
+k8s/    @aether/platform-team

CONTRIBUTING.md

@@ -0,0 +1,101 @@
+# Contributing Guide
+
+Thank you for your interest in improving AetherEngine. This document outlines the lightweight
+process for contributing during the MVP phase. As the platform matures we will expand and
+formalize governance and engineering policies.
+
+## Principles
+
+1. Security & Reproducibility First – Changes must build deterministically using the pinned
+   Rust toolchain and produce no new critical `cargo-deny` violations.
+2. Small, Reviewable Changes – Prefer a sequence of incremental pull requests over a large
+   monolith.
+3. Test What You Touch – For any user‑facing logic or new data model, add or extend tests.
+4. Explicit Ownership – Each PR must list at least one reviewer from `@aether/platform-team`.
+
+## Development Quick Start
+
+```bash
+./dev.sh bootstrap      # install toolchain & local services
+./dev.sh verify         # quick smoke validation
+make test               # run workspace tests
+```
+
+The control plane expects Postgres at the URL printed by `dev.sh bootstrap`. Override with:
+
+```bash
+export DATABASE_URL=postgres://aether:postgres@localhost:5432/aether_dev
+```
+
+## Branching & Commits
+
+- Default branch: `main`
+- Feature branches: `feat/<short-topic>` (e.g. `feat/deploy-endpoint`)
+- Bugfix branches: `fix/<issue-or-symptom>`
+- Commit messages: Conventional prefix recommended (e.g. `feat: add /deployments POST handler`).
+
+## Pull Request Checklist
+
+Before requesting review ensure:
+
+- [ ] `cargo build --workspace --all-targets` succeeds
+- [ ] `cargo test --workspace` is green
+- [ ] `cargo fmt -- --check` has no diff
+- [ ] `cargo clippy -- -D warnings` is clean (use `allow` attributes sparingly)
+- [ ] `cargo deny check` passes
+- [ ] Added / updated tests & docs for any new behavior
+- [ ] Generated artifacts (e.g. CRD YAML) updated if schema changed (`make crd`)
+
+## SQLx Offline Metadata
+
+We use SQLx offline mode. When you add or modify queries:
+
+```bash
+docker run --rm -p 5433:5432 -e POSTGRES_PASSWORD=postgres postgres:15 &
+# Wait a few seconds for readiness or use pg_isready
+export DATABASE_URL=postgres://postgres:postgres@localhost:5433/postgres
+cargo sqlx migrate run
+cargo sqlx prepare --workspace --check -- --all-features
+```
+
+Commit the updated `sqlx-data.json` at workspace root if changed.
+
+## CRD Updates
+
+If you change the `AetherApp` Rust definition regenerate the CRD manifest:
+
+```bash
+make crd
+```
+
+Commit the resulting `k8s/aetherapp-crd.yaml`.
+
+## Coding Conventions
+
+- Use ` anyhow::Result<T>` for fallible public async functions in binaries.
+- Map domain errors with `thiserror` enums where appropriate (avoid stringly typed errors).
+- Keep modules focused; prefer a short file over a megafile.
+- Avoid premature abstraction; duplicate once, abstract the third time.
+
+## Observability
+
+- Use structured logs: `info!(app_id=%id, "deployed")` style.
+- Avoid logging secrets or personally identifiable information.
+
+## License & Ownership
+
+Source code is proprietary (see `LICENSE`). All contributors must have signed the internal
+contributor agreement (handled out-of-band) before merge.
+
+## Reporting Issues
+
+File issues in the repository with a clear description, reproduction steps, and expected vs actual
+behavior. Tag with `bug`, `enhancement`, or `question`.
+
+## Roadmap Alignment
+
+Large changes (schema, public API, multi-component refactors) require a short design proposal
+(1–2 pages, problem statement, options, decision) added under `docs/` and linked in the PR.
+
+---
+Thank you for helping build AetherEngine!

Cargo.toml

@@ -0,0 +1,33 @@
+[workspace]
+members = [
+  "crates/aether-cli",
+  "crates/control-plane",
+  "crates/operator"
+]
+resolver = "2"
+
+[workspace.package]
+edition = "2021"
+license = "Proprietary"
+authors = ["AetherEngine Team <engineering@example.com>"]
+rust-version = "1.90"
+
+[workspace.dependencies]
+anyhow = "1"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["fmt", "env-filter"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+tokio = { version = "1", features = ["macros", "rt-multi-thread", "signal", "sync"] }
+clap = { version = "4", features = ["derive"] }
+reqwest = { version = "0.11", features = ["json", "gzip", "stream", "rustls-tls"] }
+thiserror = "1"
+sqlx = { version = "0.7", default-features = false, features = ["runtime-tokio", "macros", "postgres", "uuid", "chrono", "migrate", "json"] }
+uuid = { version = "1", features = ["v4", "serde"] }
+chrono = { version = "0.4", features = ["serde", "clock"] }
+flate2 = { version = "1" }
+tar = "0.4"
+axum = { version = "0.7", features = ["json", "macros"] }
+kube = { version = "0.88", features = ["runtime", "derive", "client"] }
+futures = "0.3"
+once_cell = "1"