32 lines
2.0 KiB
Markdown
32 lines
2.0 KiB
Markdown
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.
|