ace-handbook 0.28.1 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5cbc07b0baed92baa1f2a9e74c58312d24c12a6f320af4585ca4c3bcd7a1638
-  data.tar.gz: 92e6f8b56f9276c87aa28f72797544c4b0d48efcbbff3b97e91cccf3ac86ee86
+  metadata.gz: 72ea6d4981e8c7686fa38ae9f12c868bb0d910b148ee8150d4de55b7d5ccc07e
+  data.tar.gz: aa19a72eb4faca05a8ddc78bfdff8dd1a19c7e5875ffae32da1d59097aec8630
 SHA512:
-  metadata.gz: e1738d08525b525968422776b5cf8357a321cec573d1807da28d3f0c6c3db8f0fd7366255cb1ee13a7f728e2dd27d315113489b6e6c3e558e1af6c51852237d3
-  data.tar.gz: 50539492a46b43bc0da61ec4e6434a4521dfd3fd0fb402c02aa05aff2e01a838336f80fc7e83303d40158eb24295948e8ac3ce053caec36debb328e57426d580
+  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,18 @@ 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

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/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.28.1'
+    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.28.1
+  version: 0.29.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-26 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"