Hackage :: [Package]

gachi-cli: Unified command-line interface for the gachi ecosystem engine

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

Turnkey command-line interface providing declarative project initialization ('gachi init'), harmonic configuration propagation ('gachi sync'), non-destructive codebase retrofitting ('gachi retrofit'), ecosystem roadmap governance ('gachi plan'), and repository diagnostics ('gachi doctor').

[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), directory (>=1.3 && <1.4), filepath (>=1.4 && <1.6), gachi-cli, gachi-core (>=0.1 && <0.2), gachi-retrofit (>=0.1 && <0.2), gachi-scaffold (>=0.1 && <0.2), gachi-schema (>=0.1 && <0.2), gachi-sync (>=0.1 && <0.2), optparse-applicative (>=0.17 && <0.20), process (>=1.6 && <1.7), text (>=2.0 && <2.2) [details]
Tested with 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:42Z
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-cli)
Distributions
Executables gachi
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-cli-0.1.0.1

[back to package description]

gachi-cli

Unified command-line interface and ecosystem automation binary for gachi.

Architectural Overview

gachi-cli provides the turnkey CLI executable gachi, delivering:

  • gachi init: Declarative multi-package workspace generation from Dhall schemas or interactive prompts (Note [CLI Ergonomics and Non-Destructive Initialization]).
  • gachi sync: Cross-repository harmonic synchronization (Phase 3).
  • gachi retrofit: Non-destructive codebase retrofitting and overlay (Phase 4).
  • gachi plan: Detached Git governance and snapshot ledger rollback (Phase 5).

Installation & Quick Start

# Build the CLI executable
cabal build gachi-cli

# Run gachi init to scaffold a new project
cabal run gachi -- init my-project --desc "High-performance substrate"

# Or initialize from a declarative Dhall schema
cabal run gachi -- init --config packages/gachi-schema/dhall/example-project.dhall --target-dir ./tmp-proj

CLI Commands & Subcommand Hierarchy

Subcommand Flag Options Description Status
gachi init [NAME] [-c FILE] [-d DIR] [-m MODE] [--no-git] [--dry-run] Scaffolds turn-key standardized repository workspace ACTIVE
gachi sync [--target DIR] [--dry-run] Harmonically syncs formatting, linters, and hooks Phase 3
gachi retrofit [--target DIR] [--dry-run] Non-destructively overlays canonical hierarchy Phase 4
gachi plan [checkpoint|diff|log|rollback] Detached Git plan store and snapshot rollback Phase 5
gachi version Displays toolchain metadata and version stanzas ACTIVE

Invariants & Guarantees

  1. Non-Destructive Safety: By default, files are written under FailOnExisting mode to prevent overwriting existing assets. Dry-run mode (--dry-run) previews actions without touching disk.
  2. Turnkey Git Governance: Automatically executes git init and pins core.hooksPath to .githooks and commit.template to .gitmessage.
  3. Five-Gate Physical Verification: Skeletons immediately pass all 5 verification gates (./bin/<project>-verify).

Documentation

License

EUPL-1.2 OR Apache-2.0. Author: Nadia Yvette Chambers nadia.yvette.chambers@ik.me.