Skip to content

Bryforge/Latticra

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

277 Commits
.github
.github
 
 
assets
assets
 
 
docs
docs
 
 
examples/l-ui
examples/l-ui
 
 
fixtures/lat
fixtures/lat
 
 
include/latticra
include/latticra
 
 
scripts
scripts
 
 
src
src
 
 
tests
tests
 
 
tools
tools
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
STATUS.md
STATUS.md
 
 

Repository files navigation

Latticra

Status: early-stage systems architecture implementation seed.

Latticra is a contract-first systems architecture project for high-assurance infrastructure engineering. The project focuses on explicit state models, deterministic validation, constrained authority, bounded intermediate representations, disabled-by-default effects, and operator-visible reports.

The current repository is foundational engineering work, not a deployed platform or certified product.

Motto

“The simulacrum is never what hides the truth.” — Jean Baudrillard

Mission

Latticra is being built as a defensive, auditable, open systems architecture. The project is intended to mature toward infrastructure settings where behavior must be inspectable, explicit, bounded, and governed before it becomes operational.

Direction checkpoint

C is the metal.
C++ is the disciplined structure.
Latticra is the contract.

This does not mean unrestricted C++.

Current roles:

C: substrate, ABI boundaries, bounded records, implementation surfaces
Constrained C++: policy, validation, gate, and audit logic
Lat / Latticra Language: declaration, semantic validation, lowering metadata, and contract layer
LIR: bounded intermediate representation
L-UI: operator-visible declaration and reporting surface
Nucleus: coordination, classification, and report boundary
Runtime boundary: disabled-by-default line before operational behavior

Current implementation posture

The repository contains guarded documents, tests, and no-effect implementation slices for constrained C/C++ foundation direction, constrained C++ authority-layer contract, constrained authority reporting, authority implementation review, Nucleus task execution contract, Nucleus task execution implementation plan, Nucleus task execution implementation, Nucleus task report refinement, Nucleus task no-effect report alignment, Nucleus task report-only execution refinement, Nucleus report-only announcement review, Runtime boundary contract, Runtime boundary refinement plan, Runtime boundary refinement implementation, Runtime boundary report refinement, Runtime boundary policy matrix refinement, Runtime boundary domain matrix refinement, Runtime boundary domain matrix report integration, L-UI rendering implementation, L-UI rendering detailed report refinement, literal source-buffer NUL rejection policy enforcement, semantic validation implementation, Lat semantic diagnostics refinement, LIR shape implementation, LIR report refinement, Lat language grammar implementation, Lat semantic validation foundation, Lat-to-LIR lowering implementation, Lat pipeline implementation, Lat pipeline report refinement, Lat pipeline diagnostic integration refinement, Lat pipeline diagnostic main test audit, Lat-specific LIR refinement implementation, status announcement review, public entry-point consistency scan, and state-lattice models.

Lat now has a bounded no-effect path from grammar parsing to semantic validation to LIR metadata lowering. The Lat pipeline composes source parsing, semantic validation, Lat-to-LIR lowering, LIR metadata, deterministic pipeline reporting, and companion diagnostic reporting into a no-effect integration boundary.

The Lat pipeline diagnostic integration refinement adds a companion diagnostic surface that combines pipeline error/stage state with Lat semantic diagnostic class, semantic error, diagnostic count, and first-diagnostic indices while preserving no-execution behavior.

The Lat pipeline diagnostic main test audit verifies that the diagnostic integration is covered by both the focused guard and the main Lat pipeline test runner.

The constrained C++ authority implementation review confirms the authority layer remains no-effect, metadata-only, fixed-capacity, and denied-by-default.

The L-UI rendering detailed report refinement adds explicit report classification, detail level, detailed-report availability, detailed section count, deterministic section sequence, no-effect-chain status, and evidence level to the no-effect renderer report surface.

The Nucleus task no-effect report alignment adds explicit report-alignment, no-effect-policy, and representation-gate labels to Nucleus task records and deterministic reports while preserving non-execution behavior.

The Nucleus task report-only execution refinement adds explicit execution-status, effect-status, and runtime-status labels to Nucleus task records and deterministic reports while preserving report-only, non-executing behavior.

The Nucleus report-only announcement review confirms that no separate public announcement is needed because the recent Nucleus report-only and project-notes slices were documentation/status alignment only and did not change capability posture.

The Runtime boundary domain matrix report integration adds deterministic report rendering for domain-matrix cell, domain label, domain flags, effect-allowed state, authority-available state, and evidence level.

Current implementation remains report/classification oriented. It is not active runtime behavior.

Boundary

Latticra does not currently provide a kernel, bootable image, installer, production runtime, runtime behavior, command execution, unrestricted C++ authority, effect-performing implemented C++ authority layer, effect-performing task execution, interactive L-UI rendering, terminal-control L-UI rendering, LIR execution, Lat execution, Lat compiler, Lat interpreter, accreditation, certification, or operating-system replacement.

Initial documentation

Start with docs/FOUNDATION_INDEX.md.

Important records:

Status and strategy

Status and strategy records are maintained in STATUS.md, docs/status/CURRENT_STATUS.md, docs/status/ANNOUNCEMENTS.md, docs/status/AUTHORITY_STATUS_ANNOUNCEMENT_REVIEW.md, docs/status/COMPLETION_PERCENTAGE_REVIEW.md, docs/status/L_UI_RENDERING_DETAILED_REPORT_REFINEMENT_STATUS.md, docs/status/L_UI_RENDERING_README_STATUS_ALIGNMENT.md, docs/status/NUCLEUS_REPORT_ONLY_ANNOUNCEMENT_REVIEW.md, docs/status/NUCLEUS_REPORT_ONLY_ANNOUNCEMENT_README_ALIGNMENT.md, docs/status/NUCLEUS_TASK_NO_EFFECT_REPORT_ALIGNMENT_STATUS.md, docs/status/NUCLEUS_TASK_README_STATUS_ALIGNMENT.md, docs/status/NUCLEUS_TASK_REPORT_ONLY_EXECUTION_REFINEMENT_STATUS.md, docs/status/NUCLEUS_TASK_REPORT_ONLY_EXECUTION_README_STATUS_ALIGNMENT.md, docs/status/PROJECT_NOTES_FOLLOWUP_STATUS_INDEX_CHECK.md, docs/status/PROJECT_NOTES_NUCLEUS_ANNOUNCEMENT_README_ALIGNMENT_STATUS_CHECK.md, docs/status/PROJECT_NOTES_NUCLEUS_REPORT_ONLY_ALIGNMENT_STATUS_INDEX_CHECK.md, docs/status/STATUS_ANNOUNCEMENT_REVIEW.md, docs/status/STATUS_ANNOUNCEMENT_CONSISTENCY_REVIEW.md, docs/status/PUBLIC_ENTRY_POINT_CONSISTENCY_SCAN.md, docs/status/CPP_AUTHORITY_IMPLEMENTATION_REVIEW_STATUS.md, docs/status/LAT_PIPELINE_DIAGNOSTIC_INTEGRATION_STATUS.md, docs/status/LAT_PIPELINE_DIAGNOSTIC_MAIN_TEST_AUDIT_STATUS.md, docs/status/RBDM_REPORT_INTEGRATION_STATUS.md, docs/strategy/README.md, and docs/project_notes/README.md.

Validation

The repository uses shell guards and C invariant tests through the C workflow.

Lat pipeline diagnostic integration refinement is covered by:

sh scripts/test-lat-pipeline-diagnostic-integration-refinement.sh
sh scripts/test-lat-pipeline.sh

Lat pipeline diagnostic main test audit is covered by:

sh scripts/test-lat-pipeline-diagnostic-main-test-integration-audit.sh
sh scripts/test-lat-pipeline.sh

Lat-specific LIR refinement is covered by:

sh scripts/test-lat-specific-lir-refinement.sh

L-UI rendering detailed report refinement is covered by:

sh scripts/test-l-ui-rendering-detailed-report-refinement.sh
sh scripts/test-l-ui-rendering.sh

Nucleus task no-effect report alignment is covered by:

sh scripts/test-nucleus-task-no-effect-report-alignment.sh
sh scripts/test-nucleus-task-execution.sh

Nucleus task report-only execution refinement is covered by:

sh scripts/test-nucleus-task-report-only-execution-refinement.sh
sh scripts/test-nucleus-task-execution.sh

Runtime boundary domain matrix report integration is covered by:

sh scripts/test-runtime-boundary-domain-matrix-report-integration.sh
sh scripts/test-runtime-boundary.sh

Support

Support Bryforge:

https://buymeacoffee.com/Bryforge

Security

See SECURITY.md for vulnerability reporting, supported branch status, safe testing rules, and security non-claims.

License

Latticra uses Apache-2.0. See LICENSE and docs/LICENSE_POLICY.md.

About

Contract-first systems architecture for explicit state models, deterministic L-UI parsing, source-aware diagnostics, effect boundaries, and the Latticra Programming Language.

github.com/Bryforge/Latticra

Topics

programming-language parser state-machine ast diagnostics security-research systems-architecture effect-systems open-systems latticra

Resources

Readme

License

Apache-2.0 license

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors

Languages