ace-handbook 0.27.4 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de6c88b47a7fafffa19ef76352db0569c3fa5b3139a661b925616d1cbc7b0774
-  data.tar.gz: d6e990ead6a32aebb44a20a630d422dd704d88c2ab6bebb17d6a1e32a593476d
+  metadata.gz: 72ea6d4981e8c7686fa38ae9f12c868bb0d910b148ee8150d4de55b7d5ccc07e
+  data.tar.gz: aa19a72eb4faca05a8ddc78bfdff8dd1a19c7e5875ffae32da1d59097aec8630
 SHA512:
-  metadata.gz: bd5418f90557c7666854e07450cabc08a572a6a8b73129a100f17be8e2154b6bf4ed7414aa8986cfff0163ab9367566e388478728093f8e91ef715991438b7e1
-  data.tar.gz: 2f15096be8f24d52ea63116ad6e380130a924f823283732941ff3bed8581c0d3e3cf8c86a23455a1f9e516621d9e08db71fe20be340826e21cc6b828502f8825
+  metadata.gz: 1c0ba11fdb8f55c87ce15642d34746c994b38480e920f98f2c3bfb447092fdaba2e9e69efac60d4a13e588242326db28c99d2b9b130093d9e331f05fd7862233
+  data.tar.gz: 82ccfe66ee207de57e86524684a28ba4f518a1c8ca252c49cc89dab3706ac7f305ddf56532883ffe64cc26ff8a7d8a0b618f22a48d247553387182414bd9e59f

data/.ace-defaults/handbook/config.yml

@@ -1,4 +1,5 @@
 sync:
   providers:
-    enabled: []
+    enabled:
+      - agents
     disabled: []

data/.ace-defaults/handbook/providers/agents.yml

@@ -0,0 +1,2 @@
+provider: agents
+output_dir: .agents/skills

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.29.0] - 2026-06-30
+
+### Added
+- Added the built-in `agents` skill projection target, generating `.agents/skills/` for default handbook sync.
+
+### Changed
+- Changed plain `ace-handbook sync` and `ace-handbook status` to use the default/enabled projection set, with `agents` as the default when no providers are configured.
+- Allowed explicit provider sync, such as `ace-handbook sync --provider codex`, even when the provider is not part of the default enabled set unless it is explicitly disabled.
+
+### Technical
+- Added regression coverage for default `.agents/skills` projection, explicit Codex projection, disabled-provider blocking, and default status filtering.
+
+## [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

data/README.md

@@ -34,9 +34,9 @@
 
 **Coordinate larger handbook deliveries** - use `/as-handbook-update-docs` to plan, execute, and synthesize multi-step documentation changes across package handbook assets.
 
-**Integrate with resource discovery and context loading** - pair with [ace-nav](../ace-support-nav) for workflow and resource discovery, [ace-bundle](../ace-bundle) for loading complete workflow instructions, and provider integrations (`ace-handbook-integration-*`) that project canonical handbook skills into provider-native folders.
+**Integrate with resource discovery and context loading** - pair with [ace-nav](../ace-support-nav) for workflow and resource discovery, [ace-bundle](../ace-bundle) for loading complete workflow instructions, and provider integrations (`ace-handbook-integration-*`) that can project canonical handbook skills into harness-native folders on request.
 
-**Sync and inspect provider integrations** - run `ace-handbook sync` to project canonical skills into provider-native folders and `ace-handbook status` to check integration health across all configured providers.
+**Sync and inspect skill projections** - run `ace-handbook sync` to project canonical skills into `.agents/skills/` by default, or use `ace-handbook sync --provider PROVIDER` for harness-native folders such as `.codex/skills/`.
 
 **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.
 

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

@@ -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
 ```
 
@@ -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/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/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,7 +109,7 @@ 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:**

data/lib/ace/handbook/atoms/provider_registry.rb

@@ -7,13 +7,10 @@ module Ace
   module Handbook
     module Atoms
       class ProviderRegistry
-        LOCAL_MANIFEST_GLOB = File.join(
-          "ace-handbook-integration-*",
-          ".ace-defaults",
-          "handbook",
-          "providers",
-          "*.yml"
-        ).freeze
+        LOCAL_MANIFEST_GLOBS = [
+          File.join("ace-handbook", ".ace-defaults", "handbook", "providers", "*.yml"),
+          File.join("ace-handbook-integration-*", ".ace-defaults", "handbook", "providers", "*.yml")
+        ].freeze
 
         attr_reader :project_root
 
@@ -54,12 +51,14 @@ module Ace
         private
 
         def local_manifest_paths
-          Dir.glob(File.join(project_root, LOCAL_MANIFEST_GLOB)).sort
+          LOCAL_MANIFEST_GLOBS.flat_map do |glob|
+            Dir.glob(File.join(project_root, glob))
+          end.sort
         end
 
         def installed_manifest_paths
           Gem::Specification.find_all.filter_map do |spec|
-            next unless spec.name.start_with?("ace-handbook-integration-")
+            next unless spec.name == "ace-handbook" || spec.name.start_with?("ace-handbook-integration-")
 
             Dir.glob(File.join(spec.full_gem_path, ".ace-defaults", "handbook", "providers", "*.yml"))
           end.flatten.sort

data/lib/ace/handbook/organisms/provider_syncer.rb

@@ -73,30 +73,45 @@ module Ace
         end
 
         def providers_to_sync(requested_provider)
-          providers = if requested_provider
-            [requested_provider.to_s]
-          else
-            registry.providers
+          if requested_provider
+            provider = requested_provider.to_s
+            raise ArgumentError, "Unknown provider: #{provider}" unless registry.known?(provider)
+            if provider_disabled?(provider)
+              raise ArgumentError, "Provider '#{provider}' is disabled in handbook sync config"
+            end
+
+            return [provider]
           end
 
+          providers = default_sync_providers
           unknown = providers.reject { |provider| registry.known?(provider) }
           raise ArgumentError, "Unknown provider: #{unknown.join(", ")}" if unknown.any?
 
-          enabled = providers.select { |provider| provider_enabled?(provider) }
-          return enabled if requested_provider.nil? || enabled.any?
+          providers.reject { |provider| provider_disabled?(provider) }
+        end
+
+        def default_sync_providers
+          enabled = enabled_providers
+          return enabled unless enabled.empty?
+
+          return ["agents"] if registry.known?("agents") && !provider_disabled?("agents")
 
-          raise ArgumentError, "Provider '#{requested_provider}' is disabled in handbook sync config"
+          registry.providers
         end
 
-        def provider_enabled?(provider)
+        def enabled_providers
           sync_config = config.fetch("sync", {})
           providers = sync_config.fetch("providers", {})
-          enabled = Array(providers["enabled"]).map(&:to_s)
-          disabled = Array(providers["disabled"]).map(&:to_s)
 
-          return enabled.include?(provider) unless enabled.empty?
+          Array(providers["enabled"]).map(&:to_s)
+        end
+
+        def provider_disabled?(provider)
+          sync_config = config.fetch("sync", {})
+          providers = sync_config.fetch("providers", {})
+          disabled = Array(providers["disabled"]).map(&:to_s)
 
-          !disabled.include?(provider)
+          disabled.include?(provider.to_s)
         end
 
         def prepare_output_dir(output_dir)

data/lib/ace/handbook/organisms/status_collector.rb

@@ -150,22 +150,49 @@ module Ace
         end
 
         def selected_providers(provider)
-          selected = provider ? [provider.to_s] : registry.providers
+          selected = if provider
+            [provider.to_s]
+          else
+            default_status_providers
+          end
           unknown = selected.reject { |provider_id| registry.known?(provider_id) }
           raise ArgumentError, "Unknown provider: #{unknown.join(", ")}" if unknown.any?
 
           selected
         end
 
-        def provider_enabled?(provider)
+        def default_status_providers
+          enabled = enabled_providers
+          return enabled unless enabled.empty?
+
+          return ["agents"] if registry.known?("agents") && !provider_disabled?("agents")
+
+          registry.providers.reject { |provider| provider_disabled?(provider) }
+        end
+
+        def enabled_providers
+          sync_config = config.fetch("sync", {})
+          providers = sync_config.fetch("providers", {})
+
+          Array(providers["enabled"]).map(&:to_s)
+        end
+
+        def provider_disabled?(provider)
           sync_config = config.fetch("sync", {})
           providers = sync_config.fetch("providers", {})
-          enabled = Array(providers["enabled"]).map(&:to_s)
           disabled = Array(providers["disabled"]).map(&:to_s)
 
+          disabled.include?(provider.to_s)
+        end
+
+        def provider_enabled?(provider)
+          enabled = enabled_providers
+
           return enabled.include?(provider) unless enabled.empty?
 
-          !disabled.include?(provider)
+          return provider.to_s == "agents" if registry.known?("agents")
+
+          !provider_disabled?(provider)
         end
 
         def path_type(path)

data/lib/ace/handbook/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-handbook
 version: !ruby/object:Gem::Version
-  version: 0.27.4
+  version: 0.29.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config
@@ -117,6 +117,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".ace-defaults/handbook/config.yml"
+- ".ace-defaults/handbook/providers/agents.yml"
 - ".ace-defaults/nav/protocols/cookbook-sources/ace-handbook.yml"
 - ".ace-defaults/nav/protocols/guide-sources/ace-handbook.yml"
 - ".ace-defaults/nav/protocols/skill-sources/ace-handbook.yml"