ace-handbook 0.25.3 → 0.28.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b30341cfc562a2ce2a4d1a41f4a8d2034e3b06d326493caf011b3bd14fbd04ba
-  data.tar.gz: 688554595c528ec149573e821bb9f9241b789ca220e3ab619c8948b0bbe1ad4d
+  metadata.gz: b5cbc07b0baed92baa1f2a9e74c58312d24c12a6f320af4585ca4c3bcd7a1638
+  data.tar.gz: 92e6f8b56f9276c87aa28f72797544c4b0d48efcbbff3b97e91cccf3ac86ee86
 SHA512:
-  metadata.gz: 44053a25c753be9c3c62353e5b1bdda32bb98eeba4b839fe8167021b8d11a17f03db0af7c36983125559eb37d9ed361d314140bb30b5b76661e5161b6fda1f52
-  data.tar.gz: f02655c8eeac3a7306ee1f4bb59474ce8e4551164c85c81e28b99d294cb441468111ada7098fb9c73644ddd4e6aa5d1219cd1678ff7192c21660aa0930a57545
+  metadata.gz: e1738d08525b525968422776b5cf8357a321cec573d1807da28d3f0c6c3db8f0fd7366255cb1ee13a7f728e2dd27d315113489b6e6c3e558e1af6c51852237d3
+  data.tar.gz: 50539492a46b43bc0da61ec4e6434a4521dfd3fd0fb402c02aa05aff2e01a838336f80fc7e83303d40158eb24295948e8ac3ce053caec36debb328e57426d580

data/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.28.1] - 2026-04-23
+
+### Changed
+- Updated the monorepo setup cookbook to use `ace-config sync ace-llm-providers-cli` before handbook sync.
+
+## [0.28.0] - 2026-04-22
+
+### Changed
+- **ace-handbook v0.28.0**: Added the local release workflow (`release/local`) and switched the package release workflow to a local-only preparation flow.
+
+### Technical
+- **ace-handbook v0.28.0**: Kept `as-release` behavior focused on local release prep without publishing to RubyGems.
+
+## [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 +103,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
 
@@ -32,7 +32,7 @@ This cookbook distills monorepo setup patterns from ACE package conventions and
   - Add one monorepo quickstart page that covers prerequisites, workspace bootstrap, and E2E smoke checks.
   - Add a short troubleshooting section for permission and timeout pitfalls during E2E runs.
 - Agent guidance updates to apply:
-  - Add concise rules only: "use `ace-test` (not bundle exec)", "run `ace-config init` + `ace-handbook sync` before nav/bundle checks", and "scope E2E scenarios to monorepo-level concerns".
+  - Add concise rules only: "use `ace-test` (not bundle exec)", "run `ace-config sync ace-llm-providers-cli` + `ace-handbook sync` before nav/bundle checks", and "scope E2E scenarios to monorepo-level concerns".
 - Summary-only propagation target notes (do not copy full cookbook body):
   - `README.md`
   - `docs/quick-start.md`
@@ -64,7 +64,7 @@ rg --files | rg "handbook/"
 **Commands/Actions:**
 
 ```bash
-ace-config init
+ace-config sync ace-llm-providers-cli
 ace-handbook sync
 ```
 
@@ -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.
@@ -125,7 +125,7 @@ Document these defaults in repo docs and concise agent guidance:
 **Validation:**
 
 ```bash
-rg -n "ace-config init|ace-handbook sync|ace-test-e2e" README.md docs AGENTS.md
+rg -n "ace-config sync|ace-handbook sync|ace-test-e2e" README.md docs AGENTS.md
 ```
 
 ## Validation & Testing

data/handbook/guides/changelog.g.md

@@ -328,6 +328,6 @@ For projects without public repositories, use internal tracking systems or omit
 
 - [Version Control Message Guide](./version-control-system-message.g.md) (Commit message standards)
 - [Project Management Guide](./project-management.g.md) (Release workflow integration)
-- [Publish Release Workflow](wfi://release/publish) (Release process overview and step-by-step actions)
+- [Release Workflow (Local)](wfi://release/local) (Release process overview and step-by-step actions)
 - [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) (External reference)
 - [Semantic Versioning](https://semver.org/) (Versioning standards)

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/guides/meta/workflow-instructions-definition.g.md

@@ -236,11 +236,12 @@ Review these refactored workflow instructions that demonstrate self-containment
 
 ### Command Reference Example
 
-`wfi://release/publish`:
+`wfi://release/local`:
 
 - Embeds package registry commands for all major platforms
 - Includes changelog format specification
-- Contains complete release process without external references
+- Contains complete multi-package release preparation process without external references
+- `wfi://release/publish` remains a compatibility alias that forwards to this workflow.
 
 ## Key Refactoring Principles
 

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

@@ -1,7 +1,7 @@
 ---
 name: as-release
 description: Release modified ACE packages with coordinated package and root changelog updates
-# bundle: wfi://release/publish
+# bundle: wfi://release/local
 # agent: general-purpose
 user-invocable: true
 allowed-tools:
@@ -29,7 +29,7 @@ integration:
 skill:
   kind: workflow
   execution:
-    workflow: wfi://release/publish
+    workflow: wfi://release/local
 ---
 
 ## Arguments
@@ -43,7 +43,8 @@ None
 ## Execution
 
 - You are working in the current project.
-- Run `ace-bundle wfi://release/publish` in the current project to load the workflow instructions.
+- This is a local release-preparation workflow and does **not** publish to RubyGems.
+- Run `ace-bundle wfi://release/local` in the current project to load the workflow instructions.
 - Read the loaded workflow and execute it end-to-end in this project.
 - Follow the workflow as the source of truth.
 - Do the work described by the workflow instead of only summarizing it.

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

@@ -39,7 +39,7 @@ Execute complete delivery workflow for a task with automatic step tracking, ensu
 * [ ] Enter plan mode if implementation required
 * [ ] Execute implementation via `ace-bundle wfi://task/work` or inline instructions
 * [ ] Commit all changes (`ace-git-commit`)
-* [ ] Release modified packages (`ace-bundle wfi://release/publish` if applicable)
+* [ ] Release modified packages (`ace-bundle wfi://release/local` if applicable)
 * [ ] Mark task done and push to remote
 
 ### Phase 2: PR & Initial Review
@@ -76,7 +76,7 @@ Execute complete delivery workflow for a task with automatic step tracking, ensu
    ```
    1. Implement task (via `ace-bundle wfi://task/work` or inline)
    2. Commit all changes (`ace-git-commit`)
-   3. Release modified packages (`ace-bundle wfi://release/publish`)
+   3. Release modified packages (`ace-bundle wfi://release/local`)
    4. Mark task done and push to remote
    5. Create/update PR (`ace-bundle wfi://github/pr/create`)
    6. Initial review (`ace-bundle wfi://review/pr`)
@@ -109,11 +109,11 @@ Execute complete delivery workflow for a task with automatic step tracking, ensu
    * Use descriptive commit message
 
 5. **Release Packages (if applicable):**
-   * Load `ace-bundle wfi://release/publish` when a release is required
+   * Load `ace-bundle wfi://release/local` when a release is required
    * 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.28.1'
   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.28.1
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config