​

Contributing

​

Building

git clone https://github.com/tomiwa-amole/graft.git
cd graft
go build -o graft ./cmd/graft

​

Project Structure

graft/
├── cmd/
│   ├── graft/              ← Main binary entry point
│   └── debug/              ← Debug/verification binary
├── internal/
│   ├── cli/                ← CLI commands (Cobra)
│   ├── dag/                ← DAG store, Merkle tree, object pool, verify
│   ├── docker/             ← Docker Engine SDK wrapper
│   ├── state/              ← State file management
│   └── volume/             ← Volume bridge + rsync engine
├── features.md             ← Implementation roadmap
├── project_deep_dive.md    ← Technical deep-dive
└── scope.md                ← MSc project scope

​

Running Tests

​

Unit Tests

go test ./...

• dag/ — Merkle tree construction, object pool CRUD, store CRUD, verification
• state/ — State file round-trip, path resolution, schema versioning
• volume/ — rsync clone, hardlinks, excludes, permissions
• docker/ — Client validation (skipped if Docker unavailable)
• cli/ — Formatter functions

​

End-to-End Tests

GRAFT_E2E=1 go test -tags=e2e -v -count=1 ./internal/cli/

1. Start a real Postgres 16 container with a named volume
2. Run the graft CLI binary against it
3. Assert state.json, graft.db, and objects/ are correctly populated
4. Test branch creation, commit, verify, checkout, rollback, and delete

​

E2E Test Smoke Test

• graft init with volume selection
• graft commit with sync hashing
• graft verify on clean and dirty trees
• graft checkout for new and existing branches
• graft rollback to rewind state
• graft delete to clean up
• graft list to verify output formats