jankurai-core

Rust package and binary source for the jankurai auditor and merge control plane. This repository is one member of the Jankurai split family; read SPLIT.md for the family contract and AGENTS.md for agent routing rules.

Stack

Rust core + TypeScript/React/Vite product surface + PostgreSQL truth + generated contracts + exception-only Python AI/data service. New implementation is Rust-first; see docs/architecture.md.

Quick start

# One-command setup (toolchain + locked dependencies).
just setup

# Deterministic fast lane (check + tests).
just fast

# Full local check: format, lint, fast, security, and self-audit.
just check

The full command surface lives in the root Justfile. Continuous integration runs the same lanes under .github/workflows/ci.yml.

Layout

Path	Role
crates/jankurai	Rust auditor crate (binary + library)
agent/	machine-readable owner, test, boundary, and proof maps
docs/	architecture, testing, boundaries, release, and exception docs
ops/	pinned CI script entrypoints
scripts/	local CI and fusion helpers
schemas/	JSON Schemas for the auditor's artifacts

Documentation

• Architecture
• Testing
• Boundaries
• Release process
• Agent exceptions and overrides

Versioning

The current version is recorded in VERSION and the change history in CHANGELOG.md. Release mechanics are documented in docs/release.md.

License

See LICENSE.