gitstore-cli

A Zig 0.16 project scaffolded from zig-qm-toolkit, with a TS/Bun-first four-tier quality gate.

Prerequisites

• Zig 0.16.0 and ZLS 0.16.0 (resolved through mise).
• Bun >= 1.1.0 — every quality gate (scripts/verify-*.ts) runs under Bun. Install via your runtime manager (e.g. mise install bun) and confirm bun --version.

Quick start

# Pinned toolchain (chezmoi-managed mise.toml)
mise install zig@0.16.0 zls@0.16.0

# Bun (one-time; pin a version in your runtime manager)
mise install bun

# Build
mise x zig@0.16.0 -- zig build

# Test
mise x zig@0.16.0 -- zig build test

# Quality gates (TS under Bun)
bun scripts/verify-fast.ts        # tier 1 (<2s) — fmt + ast-check
bun scripts/verify-commit.ts      # tier 2 (~30s) — fast + tests + API drift
bun scripts/verify-pr.ts          # tier 3 (~10min) — commit + cross-target + safety + fuzz

Quality gates

Tier	Trigger	Entrypoint	Budget
1 — per-turn	PostToolUse hook on .zig Write/Edit	bun scripts/verify-fast.ts	<2s
2 — per-commit	Stop hook + pre-commit	bun scripts/verify-commit.ts	~30s
3 — per-PR	Forgejo verify-pr.yaml	bun scripts/verify-pr.ts	~10min
4 — per-release	Manual /release	bun scripts/verify-release.ts	hours

Each tier runs every check from the tier below it first, then adds its own. First failure halts the chain.

References

• doc/ARCHITECTURE.md — full system shape
• doc/TIGER_STYLE_ZIG.md — Zig style spine
• doc/adr/ — binding decisions (Zig 0.16 pinning, Darwin fuzz degradation, plan deviations, DORA tracking)
• CLAUDE.md — Claude Code instructions
• AGENTS.md — agents.md spec entry point

License

See LICENSE.

---

Scaffolded from ~/.local/share/chezmoi/.chezmoitemplates/zig-qm-toolkit/. Toolkit version recorded in .zig-qm/.toolkit-version.