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, GraphOfContractsSeed, RegistryEntry.
- 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 deterministic delta-sync simulator.
- Governance: DID-based identities and governance ledger integration.
- Delta-sync: deterministic replay pipeline for islanding and cross-domain updates.
Current implementation focus
- Skeleton adapters for 2 domains over TLS with generated OpenAPI and protobuf specs.
- Deterministic delta-sync simulator and conformance harness.
- GoC registry entry persistence with DID binding and governance anchor metadata.
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 generation and replay determinism)
- 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, OpenAPI specs, and protobuf stubs.
- Run tests locally with
./test.sh. The script installs the package in editable mode, runs pytest, and builds the Python package. - Keep generated artifacts deterministic so registry and conformance tests remain stable.
Important notes
- This is still a scaffold, but the generated artifacts are now derived from the DSL and registry metadata rather than fixed placeholders.