26 lines
1.2 KiB
Markdown
26 lines
1.2 KiB
Markdown
# GuardRail.Space AGENTS.md
|
|
|
|
Architectural guidelines and contribution rules for GuardRail.Space MVP.
|
|
|
|
- Architecture overview
|
|
- Tech stack and interfaces
|
|
- Testing commands and CI hints
|
|
- Contribution and code style rules
|
|
- MVP scope for safety contracts, policy engine, guard module, and adapters
|
|
|
|
The goal is to provide a production-ready scaffold that can be progressively extended:
|
|
- MVP: DSL for SafetyContracts, runtime policy engine, guard module, shadow planner, and adapters.
|
|
- The MVP will also include a minimal Python package, unit tests, and a test runner script (test.sh).
|
|
- Additional adapters for Gazebo/ROS integration and offline reconciliation scaffolding will be implemented progressively.
|
|
|
|
If you add features, update this document to reflect schema changes and testing commands.
|
|
|
|
New modules added in this iteration:
|
|
- src/guardrail_space/belief.py: a compact particle-filter sketch that emits
|
|
probability-of-violation (PoV) and an entropy summary. Includes serialize()
|
|
for compact fingerprints. Unit tests in tests/test_belief.py exercise
|
|
deterministic behavior and compact serialization.
|
|
|
|
Testing
|
|
- Run `./test.sh` to execute unit tests and build a sdist/wheel with `python3 -m build`.
|