2.0 KiB
2.0 KiB
Overview
- This repository implements an MVP of GoC Synth: an automated DSL-to-Adapter synthesis pipeline that targets a Graph-of-Contracts (GoC) style interoperability layer across domains.
Architecture (high level)
- DSL: LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, PolicyBlock definitions.
- IR: EnergiBridge-like vendor-agnostic intermediate representation.
- GoC Registry: central registry of cross-domain contracts and adapters.
- Synthesis Engine: template-driven skeleton adapters in Python/Rust/C++ with a conformance harness and toy simulator.
- Governance: DID-based identities and governance ledger integration.
- Delta-sync: deterministic replay pipeline for islanding and cross-domain updates.
Current MVP Focus (Phase 0)
- Skeleton adapters for 2 domains over TLS (template-driven generation).
- Toy local solver and basic delta-sync flow.
- GoC registry scaffolding and a simple conformance harness.
Codebase layout (key parts)
- idea176_goc_synth_automated/ (Python package with DSL primitives, generator, and registry)
- adapters/ (Generated skeleton adapters; created by the generator)
- registry/ (GoC registry placeholder data)
- tests/ (Basic tests for MVP generation)
- test.sh (Test launcher that also builds packaging artefacts)
- AGENTS.md (This document)
How to work with this repository
- To add more domains, extend the generator to emit additional domain adapters and domain-specific templates.
- Run tests locally with ./test.sh. The script will run pytest and build the Python package to verify packaging metadata and compilation.
- Review the AGENTS.md for contribution guidelines and architectural decisions.
Important notes
- This is an MVP and intentionally minimal in runtime behavior. The focus is on correct scaffolding, reproducible code generation, and testability, with a clear path to expansion in subsequent phases.