# Latticra Real-System Contract

Status: initial contract
Scope: project identity, implementation boundary, evidence rules, and non-claims.

## Purpose

Latticra is a contract-first real-system implementation track for lattice-oriented computing architecture and the Latticra Programming Language.

It exists to separate formal implementation from exploratory research, informal prototypes, and premature real-system claims.

Latticra may learn from precursor work, but public Latticra capability must be proven inside this repository through contracts, tests, evidence, and explicit boundaries.

## Identity

Latticra means a lattice-oriented real-system architecture: a computing environment built from explicit state spaces, grids, matrices, transition rules, safety gates, and evidence-backed promotion.

The name should communicate:

- structured state;
- software universes;
- embedded real-system direction;
- formal implementation;
- evidence-bound promotion;
- professional computer-science grounding.

## Project boundary

Latticra is its own public project identity.

Public documentation should describe Latticra by its own architecture, contracts, language direction, tests, and implementation evidence.

Precursor research and prototypes may inform private design decisions or documented promotion packets, but they are not public dependencies and are not public capability claims.

## Required rule

No capability may enter Latticra as a real-system feature unless it has:

1. a written contract;
2. a non-claims section;
3. tests or validation evidence;
4. a direct Latticra purpose or documented precursor-promotion packet;
5. a failure model;
6. a rollback or recovery boundary when mutation is involved;
7. an operator-visible status surface.

## Current non-execution boundary

This contract does not authorize:

- kernel implementation;
- boot image generation;
- installer behavior;
- disk mutation;
- recovery execution;
- network mutation;
- hardware mutation;
- production runtime claims;
- sandbox claims;
- security boundary claims.

## Development mode

Latticra starts in contract-first mode.

The first implementation work should be models, fixtures, tests, validation reports, and promotion rules. Live or mutating work comes later.