Elixir / OTP / BEAM  ·  governed write path  ·  open source

Governed write-path infrastructure
for enterprise AI execution.

NSHKR is the substrate where AI proposals become authorized operations: commands enter through typed product boundaries, resolve authority and workflow state, execute lower effects through governed connectors, and return receipts, evidence, projections, reviews, and replayable proof.

intent authority workflow effect receipt evidence projection review replay

Execution Contract

The stack is built around the questions an enterprise has to answer after an AI-mediated action. The important artifact is not a prompt transcript. It is a durable chain from request to authorized operation to external effect to receipt-backed replay.

01Who asked?

Actor, tenant, installation, request context.

02What authority?

Capability, policy, scope, review gate.

03Which workflow?

Operation context, causation, idempotency.

04Which effect?

Operation class, manifest, lower instruction.

05What happened?

Effect receipt, status, failure class.

06What evidence?

Evidence refs, attached artifacts, proof tokens.

07Who reviewed?

Review case, decision, override, escalation.

08Can it replay?

AITrace DAG, predecessor refs, merge semantics.

Command OperationContext ResolvedOperationPlan AuthorityPacket GovernedInvocationEnvelope ExecutionInstruction EffectReceipt EvidenceRecord Projection ReviewDecision AITrace DAG
AppKit boundary product-facing commands, reads, reviews, leases, traces

app_kit is the northbound surface product code is allowed to touch for governed platform behavior. It accepts product-level commands and stable DTOs, exposes operator reads and review controls, and keeps products from stitching lower execution paths together by hand.

Mezzanine substrate workflow truth, ledgers, receipts, evidence, projections

mezzanine owns reusable operational truth: binding registry, compiled run snapshots, workflow handoff, execution ledgers, operation receipts, evidence, projections, review state, audit, and operator actions. It records the facts that make the write path replayable.

Semantic and authority chain context, normalized outcomes, capability and policy compile

outer_brain owns semantic context, recall, normalized AI outcomes, and semantic failure carriers. citadel authorizes after resolution, when the operation class, manifest, side-effect class, required scope, and credential constraints are known.

Connector spine manifests, operation descriptors, leases, governed invocation

jido_integration resolves connector manifests, operation descriptors, and credential leases into governed lower invocation. It lets provider mechanics be specific without leaking provider-shaped control flow into reusable platform surfaces.

Execution plane HTTP, process, CLI, sandbox, filesystem, raw effects

execution_plane performs raw mechanics across HTTP, CLI, process, JSON-RPC, sandbox, terminal, filesystem, and future execution lanes. It emits receipts and raw facts. Product meaning, review state, and operational projections stay above it.

Trace and proof causal DAGs, replay, redaction, lineage, failure drills

AITrace records causal execution events with predecessor references so replay is not just emission order. stack_lab adds scanners, acceptance gates, negative controls, failure drills, and second-product validation so generality is tested instead of assumed.

Products own meaning. Platform owns invariants. Connectors own vendor mechanics. Execution owns raw effects. Trace owns proof. switchyard ElixirScope
149
Repository nodes
525
GitHub stars
9
Write-path stages
8
Audit questions

Authority follows resolution

A broad product request is not enough. Citadel authorizes the resolved operation plan after Mezzanine knows the operation class, manifest ref, binding ref, side-effect class, credential scope, and review constraints.

Provider specificity is data

A pack can bind issue tracking to Linear, code hosting to GitHub, or runtime work to Codex. Reusable surfaces still speak product roles, manifests, operation classes, receipts, and projections.

Proof is executable

stack_lab scenarios, AITrace DAGs, schema registries, release manifests, no-bypass scans, projection hashes, and proof tokens are not documentation after the fact. They are acceptance gates.

Repository Atlas

Generated from live repository metadata across the NSHKR and North Shore AI ecosystem.

View on GitHub →
AI Infrastructure 30
json_remedy A practical, multi-layered JSON repair library for … ★ 32 snakepit High-performance, generalized process pooler and … ★ 11 rag_ex Elixir RAG library with multi-LLM routing (Gemini, … ★ 9 snakebridge Compile-time Elixir code generator for Python library … ★ 8 gepa_ex Elixir implementation of GEPA: LLM-driven evolutionary … ★ 4 tinkex_cookbook Elixir port of tinker-cookbook: training and evaluation … ★ 3 nsai_gateway Unified API gateway for the NSAI … ★ 2 portfolio_core Hexagonal architecture core for Elixir RAG systems. … ★ 2 slither Lightweight Elixir runtime for composing and executing … ★ 2 tinkex Elixir SDK for the Tinker ML platform—LoRA training, … ★ 2 command Core Elixir library for AI agent orchestration - … ★ 1 execution_plane Execution Plane is an Elixir/OTP runtime substrate for … ★ 1 nsai_registry Service discovery and registry for the NSAI … ★ 1 nsai_work NSAI.Work - Unified job scheduler for North-Shore-AI … ★ 1 pilot Interactive CLI and REPL for the NSAI ecosystem—unified … ★ 1 skill_ex Claude Skill Aggregator ★ 1 tiktoken_ex Pure Elixir TikToken-style byte-level BPE tokenizer … ★ 1 app_kit Shared app-facing surface monorepo for the nshkr … gepa_buildout Deterministic GEPA buildout examples and domain task … gepa_framework Reusable GEPA optimizer framework for typed candidate … ground_plane Shared lower infrastructure monorepo for the nshkr … hf_hub_ex Elixir client for HuggingFace Hub—dataset/model … hf_peft_ex Elixir port of HuggingFace's PEFT (Parameter-Efficient … inference Reusable Elixir semantic inference contracts, adapters, … outer_brain Semantic runtime above Citadel for raw language intake, … portfolio_index Production adapters and pipelines for PortfolioCore. … portfolio_manager AI-native personal project intelligence system - … stack_lab Local distributed-development harness and proving … tinkerer Chiral Narrative Synthesis workspace for Thinker/Tinker … trinity_framework Reusable TRINITY router and coordination framework for …
Crucible Stack 27
LlmGuard AI Firewall and guardrails for LLM-based Elixir … ★ 9 ExFairness Fairness and bias detection library for Elixir AI/ML … ★ 1 crucible_examples Interactive Phoenix LiveView demonstrations of the … ★ 1 crucible_harness Experimental research framework for running AI … ★ 1 crucible_xai Explainable AI (XAI) tools for the Crucible framework ★ 1 ExDataCheck Data validation and quality library for ML pipelines in … cns_crucible crucible_adversary Adversarial testing and robustness evaluation for the … crucible_bench Statistical testing and analysis framework for AI … crucible_datasets Dataset management and caching for AI research … crucible_deployment ML model deployment for the Crucible ecosystem. vLLM … crucible_ensemble Multi-model ensemble voting strategies for LLM … crucible_feedback ML feedback loop management for the Crucible ecosystem. … crucible_framework CrucibleFramework: A scientific platform for LLM … crucible_hedging Request hedging for tail latency reduction in … crucible_ir Intermediate Representation for the Crucible ML … crucible_kitchen Industrial ML training orchestration - backend-agnostic … crucible_model_registry ML model registry for the Crucible ecosystem. Artifact … crucible_telemetry Advanced telemetry collection and analysis for AI … crucible_trace Structured causal reasoning chain logging for LLM … crucible_train ML training orchestration for the Crucible ecosystem. … crucible_ui Phoenix LiveView dashboard for the Crucible ML … datasets_ex Dataset management library for ML experiments—loaders … eval_ex Model evaluation harness for standardized … hf_datasets_ex HuggingFace Datasets for Elixir - A native Elixir port … metrics_ex Metrics aggregation and alerting for ML … training_ir Training IR for reproducible ML jobs across Crucible …