gwz-core

gwz-core serves as the foundational Rust engine for the Git Workspace Zone (GWZ) system, designed to coordinate multiple ordinary Git repositories into a single, reproducible, and inspectable workspace. Unlike command-line tools, this crate is an embeddable library that handles the complex logic of cross-repository policy and workspace management behind a typed service message boundary. The core architecture is transport-neutral, meaning it does not start a server or daemon itself. Instead, it supports flexible integration patterns: local adapters can call the engine directly in-process, while remote adapters can transmit the same typed operations using deterministic CBOR or schema-driven JSON. This design allows the workspace behavior to be consistent whether embedded in a CLI, a UI, an agent, or a backend service. Key features include a typed message boundary that carries structured errors, operation metadata, and streaming events. The system manages workspace artifacts such as manifests, locks, snapshots, and markers through a unified policy boundary, while keeping tags as real Git references. Git interactions are isolated behind a `GitBackend` abstraction, with the default implementation supporting local, SSH, and HTTPS repositories. This separation enables clients to share the same operation model regardless of whether the core is linked locally or hosted remotely. Developers can use gwz-core to build tools that require workspace operations without reimplementing complex cross-repository logic. The library is designed to be CLI-ready and UI-ready, allowing higher-level clients to utilize the same handlers directly. Documentation covers the product model, embedding guides, protocol details, and a generated message catalog.