AIPbase

AIPbase is an alpha, AIP-first backend compiler and runtime. A versioned YAML or JSON DSL defines resources, standard methods, indexes, policies, and persistence requirements. The compiler produces resource-oriented proto contracts, PostgreSQL or SQLite migrations, TypeScript capability metadata, and runtime plans from one semantic IR.

PostgreSQL is the production backend. SQLite is a compatibility backend for local development, tests, and explicitly single-process deployments.

Status

The first vertical slice supports:

• strict aipbase.dsl/v1alpha1 parsing and semantic validation
• stable proto field allocation through aipbase.lock.json
• AIP-shaped proto and OpenAPI generation for Get, List, Create, Update, and Delete
• PostgreSQL and SQLite migration generation from the same resource model
• backend-neutral CRUD plans with etag and keyset pagination contracts
• PostgreSQL-first and SQLite repository implementations for the Post fixture
• TypeScript capability manifest generation

The project is alpha. DSL and generated artifacts may change incompatibly.

Development

CARGO_INCREMENTAL=0 cargo check --workspace
CARGO_INCREMENTAL=0 cargo test --release --workspace
cargo run --release -p aipbase-cli -- check examples/posts.aipbase.yaml
cargo run --release -p aipbase-cli -- generate \
  --backend postgresql \
  --postgres-schema db_generated \
  --input examples/posts.aipbase.yaml \
  --lock examples/posts.aipbase.lock.json \
  --out generated

Documentation

• Design
• Architecture
• Implementation tasks
• First API codelab
• DSL JSON Schema