Release Notes v0.1.0

Initial release of Structyl - a multi-language project orchestrator that provides unified task execution across polyglot codebases using mise as the underlying task runner.

Features

  • Multi-language project support: Unified task execution for Go, Rust, Python, TypeScript, C#, Kotlin, PHP, and Deno projects
  • Toolchain management: Automatic detection and configuration of language toolchains with customizable toolchains.json
  • Standard command set: Consistent build, test, check, clean, restore, and ci commands across all supported languages
  • Docker integration: Built-in Docker and Docker Compose support with per-target Dockerfiles and multi-service configurations
  • Version management: Centralized VERSION file with automatic propagation to language-specific manifests (Cargo.toml, pyproject.toml, package.json, etc.)
  • Test output parsing: Unified test result parsing for Go, Cargo, pytest, dotnet, Deno, and Bun with summary output
  • CI pipeline orchestration: Configurable CI steps with dependency ordering and parallel execution
  • Shell completions: Tab completion support for Bash, Zsh, and Fish shells
  • Upgrade command: Self-update capability with nightly build support
  • JSON Schema validation: Configuration validation with published schemas at structyl.akinshin.dev

Improvements

  • mise integration: Direct task delegation to mise for reliable cross-platform execution
  • Verbosity control: -q/--quiet and -v/--verbose flags for output control
  • Command availability checking: Graceful handling of missing npm/pnpm/yarn/bun scripts
  • Parallel execution: Configurable worker pool for parallel target execution
  • Test helper library: Public pkg/testhelper package for cross-language test data comparison with float tolerance support

Documentation

  • Comprehensive VitePress documentation site with guides, specifications, and reference material
  • Formal specifications using RFC 2119 terminology
  • JSON schemas for configuration and toolchain files
  • Installation scripts for Unix and Windows platforms

Internal

  • Extensive test coverage with parallel test execution
  • Structured error handling with semantic exit codes (0: success, 1: runtime error, 2: configuration error, 3: environment error)
  • Topological sorting for dependency resolution
  • Mock infrastructure for testable command execution