Hackage :: [Package]

gachi-sync: Cross-repo standardization matrix and configuration sync for Gachi

[ development, library, tools ] [ Propose Tags ] [ Report a vulnerability ]

Implements the 9-dimensional ecosystem standardization matrix, canonical shared asset catalog, repository audit engine, and harmonic configuration propagation across ecosystem checkouts ('gachi sync').

[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.1.0.1
Change log CHANGELOG.md
Dependencies base (>=4.14 && <5), bytestring (>=0.10 && <0.13), containers (>=0.6 && <0.9), directory (>=1.3 && <1.4), filepath (>=1.4 && <1.6), gachi-core (>=0.1 && <0.2), gachi-scaffold (>=0.1 && <0.2), gachi-schema (>=0.1 && <0.2), process (>=1.6 && <1.7), text (>=2.0 && <2.2) [details]
Tested with ghc ==9.10.3, ghc ==9.12.4, ghc ==9.14.1
License EUPL-1.2
Author Nadia Yvette Chambers
Maintainer nadia.yvette.chambers@ik.me
Uploaded by nyc at 2026-11-03T16:16:47Z
Category Development
Home page https://github.com/NadiaYvette/gachi
Bug tracker https://github.com/NadiaYvette/gachi/issues
Source repo head: git clone https://github.com/NadiaYvette/gachi(packages/gachi-sync)
Distributions
Reverse Dependencies 3 direct, 0 indirect [details]
Downloads 0 total (0 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for gachi-sync-0.1.0.1

[back to package description]

gachi-sync — Cross-Repository Standardization Matrix & Harmonic Configuration Synchronization

License: EUPL-1.2 GHC: 9.14.1 Verification: 5 Gates

gachi-sync is the core standardization and propagation engine of the Gachi ecosystem framework. It establishes the canonical 9-dimensional Standardization Matrix (~/src/PLAN.md §1.A), canonical asset catalog, repository audit engine, and differential configuration propagation mechanisms (gachi sync).

The 9 Standardization Dimensions

In accordance with Note [Ecosystem Standardization Invariants] (ref:note-ecosystem-standardization) and Note [Cross-Repository Standardization Matrix and Audit Semantics] (ref:note-standardization-matrix), every repository in the ecosystem conforms to nine non-negotiable dimensions:

Dimension Description Canonical Assets
1. Layout Workspace hierarchy & documentation packages/*/, docs/INDEX.md, PLAN.md, STATE.md
2. Formatters Declarative style profiles fourmolu.yaml, rustfmt.toml, .clang-format
3. Linters Zero-hint static analysis rules .hlint.yaml
4. Build System Pinning GHC 9.14 / Cabal 3.18 cabal.project, cabal.project.local.example
5. Git Governance RFC 2822 trailer & pre-commit hooks .gitmessage, .githooks/commit-msg, .githooks/pre-commit
6. Remote Topology Multi-forge replication remotes rad (Radicle p2p), github, gitcode, framagit, disroot
7. Tiered CI Asymmetric resource allocation .github/workflows/ci.yml, .gitlab-ci.yml
8. Polyglot Multi-language FFI & boundaries FFI ABI stability, polyglot test runners
9. Agent Context AI pair programming & token budget AGENTS.md (~4 KB), CLAUDE.md, .agents/rules/

Architectural Principles

  1. Non-Destructive Safety: Audit operations are strictly read-only and pure. Synchronization operations inspect differential changes and report discrepancies before mutating files.
  2. Deterministic Catalog: All shared configurations derive from pure Haskell generators with zero ambient filesystem or network side-effects.
  3. Five-Gate Readiness: Any repository conforming to the standardization matrix immediately satisfies all five physical verification gates (./bin/<project>-verify).

Module Overview

  • Gachi.Sync.Types: Structural data types for asset categories, standard assets, standardization matrices, audit statuses, and diagnostic reports.
  • Gachi.Sync.Matrix: Canonical 9-dimensional Standardization Matrix definition and category lookup.
  • Gachi.Sync.Catalog: Pure content generators for shared formatters, linters, Git hooks, CI workflows, and agent rules.
  • Gachi.Sync.Audit: Non-destructive audit engine inspecting physical workspaces against matrix contracts and formatting diagnostic reports.
  • Gachi.Sync.CI: Forge-tiered CI matrix synthesizer and asymmetric runner allocation engine.
  • Gachi.Sync.Hash: Pure FIPS 180-2 SHA-256 differential cryptographic hashing engine.
  • Gachi.Sync.Engine: Harmonic chattering synchronization engine enforcing mathematical idempotency (f(f(x)) = f(x)).
  • Gachi.Sync: Root umbrella module re-exporting the complete synchronization API.

Quick Example

import Gachi.Schema.Project (defaultProject, Author(..))
import Gachi.Sync

-- Audit a target repository against the canonical matrix
main :: IO ()
main = do
  let auth = Author "Nadia Yvette Chambers" "nadia.yvette.chambers@ik.me"
      proj = defaultProject "gongju" auth
  report <- auditRepository "/home/nyc/src/gongju" proj canonicalMatrix
  putStrLn (formatAuditReport report)