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_ai_run_fencing
• ground_plane_persistence_policy
• ground_plane_persistence_policy_ai_extension
• ground_plane_postgres
• ground_plane_projection

ground_plane_persistence_policy owns the pure profile contract for persistence tier selection, debug capture level selection, store capability descriptors, partition dimensions, and bounded debug taps. Its built-in default profile is :mickey_mouse: memory-only, no restart durability claim, no Postgres, no Temporal, no object storage, no external network dependency, no live provider credential dependency, and no debug sidecar dependency.

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 runtime development is managed from /home/home/p/g/n/mezzanine through the repo-owned just workflow. Do not start ad hoc Temporal processes or rely on the temporal CLI as the implementation runbook.

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.

Persistence Documentation

See docs/persistence.md for tiers, defaults, adapters, unsupported selections, config examples, restart claims, durability claims, debug sidecar behavior, redaction guarantees, migration or preflight behavior, and no-bypass scope when applicable.