Skip to content

ggen v5.0.0: Unified Sync Command MVP

Choose a tag to compare

View all tags
@seanchatmangpt seanchatmangpt released this 18 Dec 08:10
· 1797 commits to main since this release
v5.0.0
aa1e413

ggen v5.0.0: Unified Sync Command MVP

🎉 What's New

Core Features

  • Unified ggen sync command - Replaces 47 v4 verbs with a single, consistent interface
  • SPARQL-driven code generation - Use CONSTRUCT queries for inference, SELECT for data extraction
  • Tera template rendering - Generate code across Rust, TypeScript, Python, and more
  • Result<T,E> error handling - Production-ready error types with exit codes 0-6

Documentation (Diataxis Framework)

  • Explanation: What is ggen and why use ontologies
  • Tutorial: 5-minute quick start guide
  • How-to Guides: Workspace sync, CI/CD integration, manual code preservation
  • Reference: Complete CLI and ggen.toml schema

Quality

  • ✅ 27 essential tests passing (codegen + manifest validation)
  • ✅ All quality gates GREEN (check, test, lint, format)
  • ✅ Pre-push hooks: 1,313 tests passing
  • ✅ Evidence captured and documented

📦 Installation

From GitHub Release (Recommended)

# Download binary for your platform from Assets below
# Or install from source:
git clone https://github.com/seanchatmangpt/ggen
cd ggen
git checkout v5.0.0
cargo build --release
./target/release/ggen --version  # Should show: ggen 5.0.0

From Source

cargo install --git https://github.com/seanchatmangpt/ggen --tag v5.0.0

Note: crates.io publish blocked by workspace dependency publishing. Use GitHub releases for now.

🚀 Quick Start

# Create a minimal ontology
mkdir -p schema
cat > schema/domain.ttl <<'TURTLE'
@prefix ex: <https://example.com/> .
ex:Person a rdfs:Class .
ex:name a rdf:Property ; rdfs:domain ex:Person .
TURTLE

# Create configuration
cat > ggen.toml <<'TOML'
[project]
name = "my-project"
version = "1.0.0"

[generation]
ontology_dir = "schema/"
output_dir = "src/generated/"
TOML

# Run sync!
ggen sync

🔥 Breaking Changes

v4 to v5 Migration

  • Commands: 47 v4 verbs → 1 ggen sync command
  • Configuration: ggen.toml schema updated (see README.md)
  • See: docs/v4-to-v5-sync-analysis.md for full migration guide

📚 Documentation

🔮 Future Releases

v5.1.0 - Comprehensive Testing & Documentation (planned)

  • 47 comprehensive test tasks
  • Migration guide (v4→v5 command mapping)
  • Enhanced error diagnostics

v5.2.0 - Incremental Sync & Performance (planned)

  • Incremental sync optimization for large ontologies (10K+ triples)
  • Performance benchmarks and SLO validation

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

🤖 Generated with Claude Code
🦀 Built with Rust + cargo-make + Chicago TDD + Design for Lean Six Sigma

Assets 3
Loading