ace-git-commit 0.25.4 → 0.26.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe255d22880f11d134ff36c7f85ea857d9ee4b4ab17fe6ae418b10bca5c9d379
-  data.tar.gz: d3a95b0901bde739ed17122d7d6d4073c513ec12f642d10bf57d939e583df1f8
+  metadata.gz: 2599fd8c9470d524bf85ca5eb8b50e612a62936dbda4a5d75b0b2576361d8c2f
+  data.tar.gz: b1b83adf72a08ff94c13fdeecb70be43574431255fab3a144d01fb3c92afd1cd
 SHA512:
-  metadata.gz: 7e40e443492428deaa6e565ae015cc06f0c0b40395525ad96760d88f50ab831abc2a61e547aabc277f8912e68c021c33996a4c9bd13309441502b28ba7d92f0b
-  data.tar.gz: c192c1309e9b95cf887ec24f69bca59af088f943aa4fb31dcc1ac36165888a1b524648ba218bb7fa84f7cc2386e56ef46b918326018fe75d031f1838c4f873ca
+  metadata.gz: 61cf4c04784c908d0f5257db3021fe1f3aa34b24212b6b7af8c950190fd23aa5c6f64b841ce8aa300dc00d416821f0b4863cc21c9956c813cd94fa4a067ae4a8
+  data.tar.gz: 5853eef8a0bd648f524254e3081f997f4d54ecfd9270150e090476601c5c5a460c7eec520462becd0fec3dcd518121480d27545ec10de05f1384500a9eae9bc2

data/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.26.3] - 2026-04-24
+
+### Changed
+- Clarified first-setup commit recovery across quick-start, package docs, and workflow guidance so users can inspect staged setup files, use the deterministic `--only-staged --no-split -m` path, and treat LLM-backed generation as optional after readiness checks.
+
+## [0.26.2] - 2026-04-23
+
+
+### Changed
+- Clarified staged-only and setup-failure commit workflows, including explicit path-scoped command contracts for single-package commits and recovery guidance.
+- Added commit contract coverage for staged-first and fallback paths so split/no-split behavior is deterministic before automatic path-scoped commit flow.
+
+
+## [0.26.1] - 2026-04-22
+
+### Technical
+- Tightened `TS-COMMIT-001` Goal 7/8 staging contracts to require explicit-path staging and prove `results/` artifacts are excluded from the cached staged set before `--only-staged` execution.
+
+## [0.26.0] - 2026-04-22
+
+### Changed
+- Improved setup-time LLM failure diagnostics to include failed role/model context, provider/setup remediation commands, and a deterministic `--only-staged --no-split -m` fallback commit path.
+
+### Technical
+- Extended `TS-COMMIT-001` with goal 8 setup-failure guidance coverage and added fast tests for role/model failure guidance and explicit CLI error routing.
+
 ## [0.25.4] - 2026-04-16
 
 ### Technical

data/handbook/workflow-instructions/git/commit.wf.md

@@ -59,6 +59,7 @@ ace-git-commit automatically:
    - Specific files: `ace-git-commit file1 file2`
    - Only staged: `ace-git-commit --only-staged`
    - Dry run first: `ace-git-commit --dry-run -i "$intention"`
+   - First setup snapshot after provider-readiness issues: `ace-git-commit --only-staged --no-split -m "chore: set up ace tooling"`
 
 3. **Verify result**:
    ```bash
@@ -71,6 +72,7 @@ ace-git-commit automatically:
 - `-m, --message`: Use direct message (bypass LLM)
 - `--model MODEL`: Override LLM model (e.g., gflash)
 - `-s, --only-staged`: Commit only staged changes
+- `--no-split`: Force one commit across detected scopes
 - `-n, --dry-run`: Preview without committing
 - `-d, --debug`: Enable debug output
 

data/lib/ace/git_commit/cli/commands/commit.rb

@@ -83,6 +83,8 @@ module Ace
             raise Ace::Support::Cli::Error.new("Commit failed") unless success
           rescue GitError => e
             raise Ace::Support::Cli::Error.new(e.message)
+          rescue Ace::GitCommit::Error => e
+            raise Ace::Support::Cli::Error.new(e.message)
           rescue Interrupt
             raise Ace::Support::Cli::Error.new("Commit cancelled", exit_code: 130)
           end

data/lib/ace/git_commit/molecules/message_generator.rb

@@ -29,10 +29,11 @@ module Ace
         def generate(diff, intention: nil, files: [], config: nil)
           system_prompt = load_system_prompt
           user_prompt = build_user_prompt(diff, intention, files)
+          model = resolve_model(config)
 
           # Use QueryInterface with named parameters matching CLI
           response = Ace::LLM::QueryInterface.query(
-            resolve_model(config),
+            model,
             user_prompt,
             system: system_prompt,
             temperature: 0.7,
@@ -42,7 +43,7 @@ module Ace
 
           clean_commit_message(response[:text])
         rescue Ace::LLM::Error => e
-          raise Error, "Failed to generate commit message: #{e.message}"
+          raise Error, llm_failure_message("Failed to generate commit message", model, e)
         end
 
         # Generate commit messages for multiple groups in one LLM call
@@ -60,9 +61,10 @@ module Ace
 
           system_prompt = load_batch_system_prompt
           user_prompt = build_batch_user_prompt(groups_context, intention)
+          model = resolve_model(config)
 
           response = Ace::LLM::QueryInterface.query(
-            resolve_model(config),
+            model,
             user_prompt,
             system: system_prompt,
             temperature: 0.7,
@@ -77,7 +79,7 @@ module Ace
 
           raise Error, "Failed to generate batch commit messages: #{e.message}"
         rescue Ace::LLM::Error => e
-          raise Error, "Failed to generate batch commit messages: #{e.message}"
+          raise Error, llm_failure_message("Failed to generate batch commit messages", model, e)
         end
 
         private
@@ -260,10 +262,11 @@ module Ace
 
         def retry_batch_parse(groups_context, intention, previous_response, reason, config)
           warn "[ace-git-commit] Batch parse failed, retrying with strict JSON repair: #{reason}"
+          model = resolve_model(config)
 
           repair_prompt = build_batch_repair_user_prompt(groups_context, intention, previous_response, reason)
           repair_response = Ace::LLM::QueryInterface.query(
-            resolve_model(config),
+            model,
             repair_prompt,
             system: load_batch_system_prompt,
             temperature: 0.2,
@@ -275,6 +278,8 @@ module Ace
         rescue BatchParseError => e
           warn "[ace-git-commit] Batch parse retry failed: #{e.message}"
           nil
+        rescue Ace::LLM::Error => e
+          raise Error, llm_failure_message("Failed to generate batch commit messages", model, e)
         end
 
         def build_batch_repair_user_prompt(groups_context, intention, bad_response, reason)
@@ -299,6 +304,25 @@ module Ace
           config_override.fetch("model", @model)
         end
 
+        def llm_failure_message(prefix, model, error)
+          effective_model = model.to_s.empty? ? DEFAULT_MODEL : model
+          surface = setup_surface_label(effective_model)
+          lines = []
+          lines << "#{prefix} with #{surface} '#{effective_model}': #{error.message}"
+          lines << ""
+          lines << "LLM setup checks:"
+          lines << "  ace-llm --list-providers"
+          lines << "  ace-config doctor"
+          lines << ""
+          lines << "Fallback commit command:"
+          lines << '  ace-git-commit --only-staged --no-split -m "chore: set up ace tooling"'
+          lines.join("\n")
+        end
+
+        def setup_surface_label(model)
+          model.start_with?("role:") ? "ACE role" : "LLM model"
+        end
+
         # Load system prompt from template
         # @return [String] System prompt content
         def load_system_prompt

data/lib/ace/git_commit/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module GitCommit
-    VERSION = '0.25.4'
+    VERSION = '0.26.3'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-git-commit
 version: !ruby/object:Gem::Version
-  version: 0.25.4
+  version: 0.26.3
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli