idea157-openfederatedcompiler-privacy-preserving/AGENTS.md

OpenFederatedCompiler: Architecture and Contribution Guide

Overview

• A multi-agent, privacy-preserving policy compiler MVP intended to federate policy across edge devices.
• Core primitives: LocalPolicy, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, PolicyBlock, Graph-of-Contracts.
• Delta-sync via CRDT-like merge to support offline islanding and deterministic replay on reconnect.
• Adapter registry (Graph-of-Contracts) to manage protocol contracts and compatibility.

Tech Stack (Python-based MVP)

• Language: Python 3.8+ for rapid prototyping and strong typing with dataclasses.
• Core modules: idea157_openfederatedcompiler_privacy_preserving (core library).
• Tests: pytest-based unit tests.
• Packaging: pyproject.toml with setuptools.

Testing and Commands

• Run unit tests: bash test.sh
• Build package: python3 -m build (requires build package)
• Lint: Not included yet; extend later with flake8/ruff if needed.

Repository Structure (high-level)

• pyproject.toml: Packaging metadata and build-system config.
• README.md: Project overview.
• AGENTS.md: This document.
• READY_TO_PUBLISH: Marker file once the MVP is complete and ready for publishing.
• idea157_openfederatedcompiler_privacy_preserving/: Core library package (Python).
• tests/: Test-suite root.

Contribution Rules

• Do not modify core architecture without signaling intent and updating tests.
• Keep changes minimal and well-scoped.
• Ensure tests pass before proposing further changes.