ace-handbook 0.25.3 → 0.27.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b30341cfc562a2ce2a4d1a41f4a8d2034e3b06d326493caf011b3bd14fbd04ba
-  data.tar.gz: 688554595c528ec149573e821bb9f9241b789ca220e3ab619c8948b0bbe1ad4d
+  metadata.gz: de6c88b47a7fafffa19ef76352db0569c3fa5b3139a661b925616d1cbc7b0774
+  data.tar.gz: d6e990ead6a32aebb44a20a630d422dd704d88c2ab6bebb17d6a1e32a593476d
 SHA512:
-  metadata.gz: 44053a25c753be9c3c62353e5b1bdda32bb98eeba4b839fe8167021b8d11a17f03db0af7c36983125559eb37d9ed361d314140bb30b5b76661e5161b6fda1f52
-  data.tar.gz: f02655c8eeac3a7306ee1f4bb59474ce8e4551164c85c81e28b99d294cb441468111ada7098fb9c73644ddd4e6aa5d1219cd1678ff7192c21660aa0930a57545
+  metadata.gz: bd5418f90557c7666854e07450cabc08a572a6a8b73129a100f17be8e2154b6bf4ed7414aa8986cfff0163ab9367566e388478728093f8e91ef715991438b7e1
+  data.tar.gz: 2f15096be8f24d52ea63116ad6e380130a924f823283732941ff3bed8581c0d3e3cf8c86a23455a1f9e516621d9e08db71fe20be340826e21cc6b828502f8825

data/CHANGELOG.md

@@ -7,6 +7,58 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.27.4] - 2026-04-16
+
+### Technical
+- Updated `TS-HANDBOOK-001` sandbox setup to source `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}` so handbook smoke flows stay aligned with the shared read-only source-root contract.
+
+## [0.27.3] - 2026-04-15
+
+### Fixed
+- Corrected `TS-HANDBOOK-002` setup to copy `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}` so sandboxed E2E runs load source-root tooling consistently.
+
+### Changed
+- Corrected release-proof command references to use positional `ace-test-e2e ace-monorepo-e2e TS-MONO-001` invocation.
+
+## [0.27.2] - 2026-04-15
+
+### Changed
+- Updated RubyGems propagation proof docs to use the supported positional `ace-test-e2e ace-monorepo-e2e TS-MONO-001` invocation and current scenario path.
+
+## [0.27.0] - 2026-04-14
+
+### Changed
+- Rewrote `ace-handbook` E2E coverage to public-surface goal style by retaining the CLI smoke flow and adding `TS-HANDBOOK-002` sync/provider-error behavior scenarios.
+- Tightened `TS-HANDBOOK-001` verifier contracts to prioritize user-visible output and enforce stronger status JSON shape expectations.
+
+### Technical
+- Updated usage guidance with explicit `sync --provider` and unknown-provider error-path examples aligned to the E2E public contract.
+
+## [0.26.2] - 2026-04-13
+
+### Changed
+- Documented `cookbook://` wildcard deduplication semantics in usage guidance, including canonical-path behavior and priority-preserving source selection notes.
+
+## [0.26.1] - 2026-04-13
+
+### Changed
+- Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
+
+### Technical
+- Included in the coordinated assignment-driven patch release for batch i05 package updates.
+
+
+## [0.26.0] - 2026-04-12
+
+### Changed
+- Migrated `ace-handbook` package tests to the `fast` / `feat` / `e2e` contract by moving deterministic suites under `test/fast`, retaining workflow-value CLI smoke E2E coverage, and aligning scenario metadata with the new deterministic paths.
+- Updated package docs (`README`, getting-started, usage) to teach the `ace-test ace-handbook`, optional `ace-test ace-handbook feat`, `ace-test ace-handbook all`, and `ace-test-e2e ace-handbook` verification contract.
+
+## [0.25.4] - 2026-04-10
+
+### Technical
+- Updated handbook docs and cookbook guidance to point at the restarted E2E testing flows and current release-proof references.
+
 ## [0.25.3] - 2026-04-05
 
 ### Fixed
@@ -38,7 +90,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.23.5] - 2026-03-31
 
 ### Changed
-- Replaced `wfi://release/rubygems-verify-install` workflow with E2E scenario `TS-MONO-001-rubygems-install` in `ace-monorepo-e2e/`. Updated all skill and doc references to use `ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-001`.
+- Replaced `wfi://release/rubygems-verify-install` workflow with E2E scenario `TS-MONO-001-rubygems-install` in `ace-monorepo-e2e/`. Updated all skill and doc references to use `ace-test-e2e ace-monorepo-e2e TS-MONO-001`.
 
 ## [0.23.4] - 2026-03-31
 

data/README.md

@@ -40,5 +40,12 @@
 
 **Extend handbook content in normal projects** - put project-specific workflows, guides, cookbooks, templates, and skills under `.ace-handbook/` and discover them with protocol URLs (`wfi://`, `guide://`, `cookbook://`, `tmpl://`, `skill://`). See [Usage Guide](docs/usage.md) for path conventions.
 
+## Testing
+
+- `ace-test ace-handbook` runs the deterministic fast suite (`test/fast`).
+- `ace-test ace-handbook feat` runs deterministic feature tests (`test/feat`) when present.
+- `ace-test ace-handbook all` runs all deterministic layers for the package.
+- `ace-test-e2e ace-handbook` runs retained workflow scenarios under `test/e2e`.
+
 ---
 [Getting Started](docs/getting-started.md) | [Usage Guide](docs/usage.md) | [Handbook - Skills, Agents, Templates](docs/handbook.md) | Part of [ACE](https://github.com/cs3b/ace)

data/handbook/cookbooks/setup-starting-a-multi-ruby-gem-monorepo-with-ace.cookbook.md

@@ -1,7 +1,7 @@
 # Setup Cookbook: Starting a Multi Ruby Gem Monorepo with ACE
 
 **Created**: 2026-04-01
-**Last Updated**: 2026-04-01
+**Last Updated**: 2026-04-10
 **Category**: setup
 **Audience**: intermediate
 **Estimated Time**: 2-4 hours
@@ -21,8 +21,8 @@ This cookbook distills monorepo setup patterns from ACE package conventions and
   - `ace-monorepo-e2e/README.md`
   - `.ace-retros/8quwjc-monorepo-e2e-quickstart-verification/8quwjc-monorepo-e2e-quickstart-verification.retro.md`
 - Validation evidence (commands, reports, or artifacts):
-  - `ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-001`
-  - `ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-002`
+  - `ace-test-e2e ace-monorepo-e2e TS-MONO-001`
+  - `ace-test-e2e ace-monorepo-e2e TS-MONO-002`
   - `ace-nav resolve cookbook://setup-starting-a-multi-ruby-gem-monorepo-with-ace`
 - Last source verification date: 2026-04-01
 
@@ -81,7 +81,7 @@ ace-bundle project
 
 **Commands/Actions:**
 
-1. Create `ace-monorepo-e2e/test/e2e/TS-*/scenario.yml` entries for repository-wide behaviors.
+1. Create `ace-monorepo-e2e/test-e2e/scenarios/TS-*/scenario.yml` entries for repository-wide behaviors.
 2. Use one scenario for install verification and one for quickstart/docs validation.
 3. Keep per-package scenarios in their package folders; keep only cross-cutting cases here.
 
@@ -98,8 +98,8 @@ ace-test-e2e ace-monorepo-e2e
 **Commands/Actions:**
 
 ```bash
-ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-001
-ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-002
+ace-test-e2e ace-monorepo-e2e TS-MONO-001
+ace-test-e2e ace-monorepo-e2e TS-MONO-002
 ```
 
 If runs are network-heavy, raise timeout budgets deliberately and record the reason in scenario docs.

data/handbook/guides/cli-dry-cli.g.md

@@ -17,7 +17,7 @@ All ACE CLI gems use dry-cli. See [ADR-023](../../../docs/decisions/ADR-023-dry-
 
 **Two patterns:**
 
-- **Multi-command**: Subcommand tools (ace-bundle, ace-taskflow)
+- **Multi-command**: Subcommand tools (ace-bundle, ace-task)
 - **Single-command**: One-action tools (ace-git-commit, ace-search)
 
 ## Multi-Command Pattern
@@ -162,7 +162,7 @@ end
 
 ## Nested Commands
 
-For hierarchical commands (ace-taskflow, ace-git-worktree):
+For hierarchical commands (ace-task, ace-git-worktree):
 
 ```ruby
 # lib/ace/taskflow/cli.rb

data/handbook/guides/cli-support-cli.g.md

@@ -17,7 +17,7 @@ All ACE CLI gems use ace-support-cli. See [ADR-023](../../../docs/decisions/ADR-
 
 **Two patterns:**
 
-- **Multi-command**: Subcommand tools (ace-bundle, ace-taskflow)
+- **Multi-command**: Subcommand tools (ace-bundle, ace-task)
 - **Single-command**: One-action tools (ace-git-commit, ace-search)
 
 ## Multi-Command Pattern
@@ -162,7 +162,7 @@ end
 
 ## Nested Commands
 
-For hierarchical commands (ace-taskflow, ace-git-worktree):
+For hierarchical commands (ace-task, ace-git-worktree):
 
 ```ruby
 # lib/ace/taskflow/cli.rb

data/handbook/skills/as-release-rubygems-publish/SKILL.md

@@ -10,7 +10,7 @@ allowed-tools:
   - Bash(ace-bundle:*)
   - Read
 argument-hint: "[gem-name...] [--dry-run]"
-last_modified: 2026-03-29
+last_modified: 2026-04-10
 source: ace-handbook
 integration:
   targets:
@@ -47,4 +47,4 @@ None
 - Do the work described by the workflow instead of only summarizing it.
 - When the workflow requires edits, tests, or commits, perform them in this project.
 
-- After live publishing, recommend running `ace-test-e2e ace-monorepo-e2e --test-id TS-MONO-001` for installation verification.
+- After live publishing, recommend running `ace-test-e2e ace-monorepo-e2e TS-MONO-001` for installation verification.

data/handbook/workflow-instructions/handbook/perform-delivery.wf.md

@@ -113,7 +113,7 @@ Execute complete delivery workflow for a task with automatic step tracking, ensu
    * Follow versioning conventions
 
 6. **Complete Task:**
-   * Mark task as done: `ace-taskflow done <ref>`
+   * Mark task as done: `ace-task done <ref>`
    * Push to remote: `git push`
 
 ### Phase 2: PR & Initial Review

data/lib/ace/handbook/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Handbook
-  VERSION = '0.25.3'
+    VERSION = '0.27.4'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-handbook
 version: !ruby/object:Gem::Version
-  version: 0.25.3
+  version: 0.27.4
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config