GroundPlane

GroundPlane is the shared lower infrastructure workspace for the nshkr platform core.

It holds the reusable lower primitives that sit underneath outer_brain, Citadel, jido_integration, and app_kit.

Scope

• shared contracts and state vocabulary
• Postgres transaction, outbox, inbox, and checkpoint helpers
• generic projection publication helpers

Internal Libraries

• ground_plane_contracts
• ground_plane_postgres
• ground_plane_projection

Status

Workspace root established. The internal packages are intentionally small and generic.

Development

The project targets Elixir ~> 1.19 and Erlang/OTP 28.

mix ci

The welded ground_plane_contracts artifact is tracked through the prepared bundle flow:

mix release.prepare
mix release.track
mix release.archive

mix release.track updates the orphan-backed projection/ground_plane_contracts branch so downstream repos can pin a real generated-source ref before any formal release boundary exists.

Documentation

Workspace docs cover the overview, layout, contracts, Postgres helpers, and projection helpers.

License

MIT. Copyright (c) 2026 nshkrdotcom.

Temporal developer environment

Temporal CLI is expected to be available as temporal on this developer workstation for local durable-workflow development. Current provisioning is machine-level dotfiles setup, not a repo-local dependency.

TODO: make Temporal ergonomics explicit for developers by adding repo-local setup scripts, version expectations, and fallback instructions so the tool is not silently assumed from the workstation.

Native Temporal development substrate

Temporal runtime development is managed from /home/home/p/g/n/mezzanine through the repo-owned just workflow, not by manually starting ad hoc Temporal processes.

Use:

cd /home/home/p/g/n/mezzanine
just dev-up
just dev-status
just dev-logs
just temporal-ui

Expected local contract: 127.0.0.1:7233, UI http://127.0.0.1:8233, namespace default, native service mezzanine-temporal-dev.service, persistent state ~/.local/share/temporal/dev-server.db.