AlignTrue

Open-source reference architecture for auditable, replayable AI operations.

AlignTrue is an open-source reference architecture for supervised AI systems that need durable receipts, replayable state, governed actions, and fenced side effects.

Open sourceMITExperimental beta

Operational shape

How the project supports decisions, context, and execution.

AlignTrue logo
Primary use
Auditable AI operations
AI role
Governed agent execution
Best fit
Supervised, side-effecting workflows

What it is

Most AI apps treat safety as a UX problem: approvals, undo buttons, or better prompts. AlignTrue treats safety as an operability problem.

Before an agent can handle consequential work, the system needs to know what it saw, which policy or tool version shaped the behavior, what it attempted, what completed, and whether the action path can be replayed.

The project is intentionally experimental. Its value is as a working reference architecture for supervised AI execution, not as a claim that every interface is final.

Why it exists

Agent systems need to answer operational questions before they can safely do more than produce suggestions.

  • What did the agent see before it acted?
  • Which evidence, policy, and tool path led to that action?
  • Which policy, prompt, tool, and artifact versions shaped the behavior?
  • What did it do, and what was only attempted?
  • Can the system replay the action path from durable records?
  • Can external side effects be fenced, approved, and deduplicated?

Architecture diagram

The system separates command intent, event facts, derived artifacts, action traces, and fenced external writes.

A practical architecture for AI systems where agents can act while actions remain auditable, replayable, and governable.

Architecture primitives

AlignTrue decomposes operational confidence into system primitives that can be inspected, tested, and reused selectively.

Receipts

Capture what happened, what was attempted, and what evidence was used.

Replayability

Rebuild state from append-only events and deterministic projections.

Versioned behavior

Track policies, prompts, tools, artifacts, and lineage.

Governance

Model actors, capabilities, approvals, holds, and outcomes.

Idempotent side effects

Route external writes through safety classes, approvals, outbox handling, idempotency keys, and receipts.

Drift control

Compare decision paths, inputs, policy versions, and outcomes instead of relying on subjective review.

Trajectories

Capture a decision clock with structured, hash-chained steps showing inputs, tool calls, policy checks, and outcomes.

Simulation

Preview behavior with evidence-backed precedents before promoting policies or allowing more autonomy.

Source and repository

Public code, docs, architecture notes, examples, and project status are linked directly when they can be shared responsibly.

Reference implementation

The accompanying architecture essay lays out the deeper argument: agent-native software is hard to operate unless it can be audited, reproduced, rolled back, and safely run at scale. AlignTrue is the concrete reference implementation behind that argument.

Working repository

The repository exposes the architecture as code rather than a slide-only concept: kernel contracts, host runtime, connectors, packs, UI blocks, docs, and repeatable local development paths.

Open sourceMITTypeScript / Node 20+Experimental beta
  • Monorepo structure
  • Kernel and host runtime
  • Local-first and offline fixtures
  • Connectors and packs
  • CI and repeatable development
  • Security policy
  • UI blocks

Architecture reused in later systems

AlignTrue became a reference point for later public and private applied AI systems. Rather than copying the whole platform, later implementations reused the primitives that mattered for the operational context: safety classes, actor identity, deterministic hashing, intent lifecycles, approval rules, dry runs, and provenance tracking.

Safety classes

AlignTrue origin
READ / WRITE_INTERNAL / WRITE_EXTERNAL_SIDE_EFFECT
Later reuse
Maintenance Control and Main Character workflowsMaintenance Control

Actor model

AlignTrue origin
Human, agent, and system identity with authorization
Later reuse
Human approval and agent action attribution

Deterministic hashing

AlignTrue origin
Stable JSON canonicalization and content hashes
Later reuse
Idempotency keys, replayable actions, and audit trails

Intent lifecycle

AlignTrue origin
Pending, approved or rejected, executing, executed
Later reuse
Governed action flows

Approval rules

AlignTrue origin
Explicit approve and execute authorization
Later reuse
Human-in-the-loop operational workflows

Dry runs

AlignTrue origin
Preview commands and tool calls before execution
Later reuse
Safer autonomous actions

Provenance tracking

AlignTrue origin
AI run steps, correlation IDs, and actor attribution
Later reuse
Debugging, review, and operational confidence

How it's used

These are the practical workflows and constraints the project is built around.

Policy-aware execution

Designed for workflows where source material, rules, approvals, and exceptions matter as much as the final output.

Human review by design

Keeps people close to important decisions while using AI to reduce searching, summarization, triage, and administrative drag.

Reusable operating layer

Useful for casework, review queues, intake processes, research operations, and internal tools that need persistent context.

Why this matters for operational AI

Operational AI needs more than a chat interface. Governed agent execution depends on replayable action paths, approval flows, egress fencing, provenance, and drift control. AlignTrue shows those concerns as architecture, not decoration.

Status

AlignTrue is experimental beta software. Its value is not that every interface is final. Its value is as a working reference architecture for supervised AI execution: receipts, replayability, governed action flows, and deterministic operational patterns.

More public projects

Different surfaces, same focus on context, coordination, review, and execution. This is a selected public view, not a complete project history.

Back to portfolio
GlassAlpha logo

GlassAlpha

GlassAlpha is an open-source toolkit for deterministic audit reports for tabular ML models, with fairness, explainability, calibration, robustness, and reproducibility metadata in one local workflow.

Maintenance Control logo

Maintenance Control

A private MVP build for approved-publication retrieval, voice query, and source-cited maintenance guidance on phone, web, and wearable surfaces.

Ready to build something real?

Main Character helps turn complex product, workflow, and architecture problems into systems that work under real constraints.

Talk to us