Fork me on GitHub

Changes Report

Release History

Version Date Description
1.0.0 2026-03-09  
1.0.1 2026-03-14  
1.0.2 2026-03-23  
1.0.3 2026-03-30  

Release 1.0.0 – 2026-03-09

Type Changes By
Add

Features

  • Initial release of Machai: a modular toolkit for GenAI-enabled developer automation (Java libraries, CLI, and Maven plugins).
  • Provider-agnostic GenAI client with pluggable providers (OpenAI, Gemini, Claude, CodeMie, None) and function-tool support (file/web/command), including safety denylist checks.
  • Bindex metadata tooling to generate/consume library discovery indexes (schema + repository + builders) with Maven plugin and CLI integration.
  • Ghostwriter automation for repo-scale documentation updates driven by embedded @guidance, with file processors and language reviewers (Java/Markdown/HTML/Python/TypeScript/PUML).
  • Act system for reusable automation templates (TOML-based), including built-in acts such as commit, prompt, unit-tests, release-notes, sonar-fix, and grype-fix; supports custom act directories and non-interactive execution.
  • Maven plugins for Ghostwriter/Acts (including reactor goals) and assembly support, plus project-layout detection for Maven/JS/Gradle-style projects.
  • Project documentation site with module guides, Javadoc overviews, and generated diagrams/resources.

Fixes

  • Improved OpenAI provider robustness (follow-up tool-call handling, timeout handling, BadRequest recovery, and corrected token/tool limit constants).
  • Hardened command execution tools (denylist configuration/init fixes, improved checks, and clearer errors).
  • Fixed act processing and defaults (scanDir/rootDir handling, act template loading/parsing, inheritance/placeholders, and CLI/maven non-interactive configuration).
  • Addressed Grype-reported security issues (CVE-2025-48924 / GHSA-j288-q9x7-2f5v and CVE-2021-26291 / GHSA-2f88-5hg8-9x2x).

Refactoring

  • Refined Ghostwriter processing pipeline (shared module processing in an abstract processor, deterministic template application, and normalized prompt/tool output line endings).
  • Streamlined Bindex prompt/build flows and updated APIs for clarity and maintainability.

Documentation

  • Expanded and refreshed CLI, Maven plugin, Act, and Ghostwriter documentation (usage examples, troubleshooting, configuration semantics, and site navigation).
  • Added/updated Javadoc overview pages across modules and improved generated site assets (icons, manifests, links).

Chores

  • Project setup and packaging updates across modules, including configurator/version alignment and assembly descriptor improvements.
dev

Release 1.0.1 – 2026-03-14

Type Changes By
Add

Features

  • Improved CLI help output and Act listing (including returning Act description).
  • Added URL-based Acts location support.
  • Added command-line properties replacement support in CommandFunctionTools.
  • Added sonar-tests and project-specific sonar-fix Acts, plus unit-test creation guidance tags.

Fixes

  • Fixed callRestApi handling for error responses.
  • Corrected command denylist checking to validate the entire command line.
  • Fixed non-recursive mode processing.
  • Fixed Act/template edge cases (properties inheritance, input formatting/double formatting, %%. escaping, NPEs, log path).

Refactoring

  • Improved Act prompt parsing, scanDir resolution, and concurrency/CLI option handling across Ghostwriter and Acts.
  • Refactored production code to improve testability; adopted ToolFunction interface and adjusted visibility where needed.
  • General cleanup: optimized imports, removed unused code/rules.

Documentation

  • Updated Javadocs and prompts/instructions (including OS name in project information and guidance on running Sonar before fetching reports).
  • Updated Act templates (commit/help/release-notes/sonar*).

Chores

  • Added jacoco-maven-plugin and junit-jupiter-params; expanded automated test coverage.
  • Iterated on Sonar fixes generated by automation (including a revert and merge sync).
dev

Release 1.0.2 – 2026-03-23

Type Changes By
Add

Features

  • Improved Bindex/assembly flows: updated picker selection and repository/register behavior; enhanced assembly prompting (including OS info in instructions) and response logging.
  • Extended unit test coverage across modules (bindex-core builder/tool happy-path tests, project layout tests, OpenAI tool invocation tests, gw-maven-plugin tests, and additional CLI/assembly coverage).

Fixes

  • Fixed Act loader robustness (null-safe formatting fallback; handling missing custom act directory; correct absolute-path and URL handling).
  • Fixed reactor build scanning behavior for gw-maven-plugin.
  • Fixed assembly command logging and inputs log wiring.
  • Fixed PlantUML Maven plugin definition/configuration and corrected site configuration (site.toml).
  • Improved Bindex registry connection handling and updated CLI defaults for model/dir and logging.
  • Updated dependency versions (including Grype-reported vulnerable dependencies).

Refactoring

  • Standardized on project.dir usage across CLI, Bindex, Assembly, and Ghostwriter processors.
  • Removed effective POM model building/requirements and cleaned up unused Maven-related dependencies.
  • Refined variable naming in Ghostwriter models and removed internal helper types (e.g., ToolHandlingResult).

Documentation

  • Updated documentation for bindex-core, bindex-maven-plugin, assembly-maven-plugin, and guidance defaults/scanDir configuration.
  • Improved and expanded project site content and Act templates (help/commit/site).

Chores

  • Updated plugin management defaults, logback rollover configuration, and various generated bindex.json metadata refreshes.
dev

Release 1.0.3 – 2026-03-30

Type Changes By
Add

Features

  • Added support for partial replacements in the write_file_to_file_system tool.

Fixes

  • Fixed logInputs property constant/name usage across CLI, Maven plugins, providers, and assembly (including inputs log propagation and setter naming).
  • Fixed Ghostwriter property constants and scan exclusion handling; corrected GW command instruction property usage.

Documentation

  • Updated documentation.

Chores

  • Added/expanded automated tests (CLI property loading, ProjectProcessor module processing, assembly and builder coverage).
  • Refreshed bindex.json metadata files.
dev