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.