Hackage :: [Package]

gachi-plan: Isolated detached Git store and ledger for ecosystem plan governance

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

Implements Milestone 5.1 of Phase 5 (Ecosystem Plan Governance & Rollback per ~srcPLAN.md §1.A). Establishes an isolated, detached Git store tracking ecosystem-wide governance documents (PLAN.md, STATE.md, INDEX.md, and docsINDEX.md) across ~src/ without interfering with child git checkouts.

[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-sync (>=0.1 && <0.2), process (>=1.6 && <1.7), text (>=2.0 && <2.2), time (>=1.9 && <1.16) [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:44Z
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-plan)
Distributions
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-plan-0.1.0.1

[back to package description]

gachi-plan — Detached Git Store Architecture & Ecosystem Plan Governance

gachi-plan provides isolated version-control and snapshot ledger infrastructure for ecosystem-wide planning documents (~/src/PLAN.md §1.A, Phase 5). It manages a detached Git repository tracking strategic governance documents without creating or writing nested .git directories in child repository workspaces.

1. Architectural Overview

Per Note [Plan Governance and Rollback Mechanics] [ref:note-plan-governance-rollback], the detached Git store operates under three strict invariants:

  1. Non-Interference Invariant: The store is maintained in an external bare repository (~/.plan.git or ~/src/.plan.git), completely avoiding nested .git directory collisions inside child repository checkouts (~/src/gachi/.git, ~/src/polytropos/.git, etc.).
  2. Governed Documents Invariant: Exclusively tracks top-level planning documents (PLAN.md, STATE.md, INDEX.md, and docs/INDEX.md), ignoring child repository source files through explicit pathspec scoping.
  3. Hermetic Store Execution: All git invocations pass explicit --git-dir and --work-tree arguments, guaranteeing total independence from ambient working directory state or parent discovery. 
~/src/ (Work Tree Root)
  ├── PLAN.md          ◄── Tracked by detached store
  ├── STATE.md         ◄── Tracked by detached store
  ├── INDEX.md         ◄── Tracked by detached store
  ├── docs/INDEX.md    ◄── Tracked by detached store
  │
  ├── gachi/           ─── Child Repo (.git intact, untouched)
  ├── polytropos/      ─── Child Repo (.git intact, untouched)
  └── ...
        ▲
        │ git --git-dir=~/.plan.git --work-tree=~/src
        ▼
~/.plan.git/ (Bare Detached Git Store)
  ├── HEAD
  ├── config (core.bare = true)
  ├── objects/
  └── refs/

2. Core Modules

  • Gachi.Plan: Unified library facade re-exporting store and type abstractions.
  • Gachi.Plan.Types: Algebraic data models (PlanStore, PlanError, PlanStoreStatus, defaultGovernedFiles).
  • Gachi.Plan.Store: Detached bare Git repository initialization, status querying, file tracking, and commit operations.