ace-handbook 0.21.4 → 0.23.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b12292188dac723637dc85a45df83a26da78bd03ef36cad43f24ec48affe2489
-  data.tar.gz: 3812c35dfa02adeccc88c379d4a338f7ab212c40082169b10aebb85dd96e479d
+  metadata.gz: 9ac7df9cd7a6a223a639a7cbc54f3669b81d33ce2e2a84ab6958117b7bf79041
+  data.tar.gz: 51256569bc2f4a4121a1aba33778e701e81a48e750c6887b2467e5bf21408dc2
 SHA512:
-  metadata.gz: ccc672ee0b2e6a39c645693d090122dd31049790e64365db7ea0df7270e562de6106eef081242b615240f7d594e3bdef456b7f2e38a321e4e7c2269843ef19be
-  data.tar.gz: a35964688e4ee60c58428ecba1cad7b15ae8e7291f05e3bc1106ff935e2382399ff4e24c6251d4e7fffe1b09968a5ae7ed19e83edf31b58266be141cc2e6ba5d
+  metadata.gz: a89bfa62563268247139b31d05fbc48fc508b0af6e18f249c82f9b3f5f8cf2486128bb013f711f718610fc4dd68d8ae8d0883ce9a417a2b299c55be8a5c7de15
+  data.tar.gz: 8879cb6414ae62d3648ac27cb91f2500e23799cf163a529bdb32b595b633c1791556cf883b5731769bc3a67e7e2aa4680412efc2aa9bb82edc7e7d26e531bd7f

data/CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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`.
+
+## [0.23.4] - 2026-03-31
+
+### Changed
+- Shipped default sync config with no providers pre-enabled so users choose their own agent integrations.
+- Reorganized install instructions across README, quick-start, and DEVELOPMENT docs by toolkit building blocks (Plan, Build, Context, QA, Git) with all gems in `development, test` group.
+
+## [0.23.3] - 2026-03-31
+
+### Changed
+- Extracted RubyGems installation verification into standalone `wfi://release/rubygems-verify-install` workflow with mise-based sandbox isolation.
+- Updated `as-release-rubygems-publish` skill to recommend the standalone verification workflow instead of requiring inline proof classification.
+
+## [0.23.2] - 2026-03-30
+
+### Technical
+- Added edge-case regression coverage for `ProviderSyncer#summarize_sources`, including empty inventory handling and nil/blank source normalization.
+
+## [0.23.1] - 2026-03-30
+
+### Fixed
+- Restored `Bash(gem:*)` permissions in the canonical `as-release-rubygems-publish` skill so release workflows can invoke gem commands directly.
+
+### Technical
+- Added regression coverage for projected release skill permissions to prevent permission drift.
+
+## [0.23.0] - 2026-03-30
+
+### Changed
+- Clarified `ace-handbook sync` output by adding inventory source counts and explicit rerun guidance when only one source is discovered.
+- Expanded `ace-handbook` docs to define `.ace-handbook/` as the canonical project-level handbook root for workflows, guides, templates, and skills in normal projects.
+
+### Technical
+- Added CLI sync command regression coverage for inventory-source summary and single-source guidance output.
+
+## [0.22.0] - 2026-03-29
+
+### Changed
+- Added a deterministic RubyGems propagation proof gate to coordinated release workflows with explicit `SAFE`, `LAG_DETECTED`, and `METADATA_BROKEN` classification outcomes.
+
+### Technical
+- Added operator-facing proof contract documentation and synchronized `as-release-rubygems-publish` skill guidance with the updated release workflow expectations.
+
 ## [0.21.4] - 2026-03-29
 
 ### Technical

data/README.md

@@ -38,5 +38,7 @@
 
 **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.
 
+**Extend handbook content in normal projects** - put project-specific workflows, guides, templates, and skills under `.ace-handbook/` and discover them with protocol URLs (`wfi://`, `guide://`, `tmpl://`, `skill://`). See [Usage Guide](docs/usage.md) for path conventions.
+
 ---
 [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/skills/as-release-rubygems-publish/SKILL.md

@@ -5,11 +5,12 @@ description: Publish ACE gems to RubyGems.org in dependency order
 # agent: general-purpose
 user-invocable: true
 allowed-tools:
+  - Bash(bundle:*)
   - Bash(gem:*)
   - Bash(ace-bundle:*)
   - Read
 argument-hint: "[gem-name...] [--dry-run]"
-last_modified: 2026-03-21
+last_modified: 2026-03-29
 source: ace-handbook
 integration:
   targets:
@@ -23,17 +24,6 @@ integration:
       frontmatter:
         context: fork
         model: haiku
-assign:
-  source: wfi://release/rubygems-publish
-  steps:
-    - name: publish-gems
-      description: Publish ACE gems to RubyGems.org in dependency order
-      intent:
-        phrases:
-          - "publish gems"
-          - "push to rubygems"
-          - "publish to rubygems"
-      tags: [release, rubygems, publishing]
 skill:
   kind: workflow
   execution:
@@ -56,3 +46,5 @@ None
 - Follow the workflow as the source of truth.
 - 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.

data/lib/ace/handbook/cli/commands/sync.rb

@@ -26,9 +26,27 @@ module Ace
                    "(#{result[:projected_skills]} skills, #{result[:updated_files]} updated, " \
                    "#{result[:removed_entries]} removed)"
             end
+            print_inventory_summary(results)
           rescue => e
             raise Ace::Support::Cli::Error.new(e.message)
           end
+
+          private
+
+          def print_inventory_summary(results)
+            source_breakdown = results.first&.fetch(:source_breakdown, {})
+            return if source_breakdown.nil? || source_breakdown.empty?
+
+            puts "inventory sources: #{format_source_breakdown(source_breakdown)}"
+            return unless source_breakdown.length == 1
+
+            source = source_breakdown.keys.first
+            puts "note: only '#{source}' skills were discovered. if you installed additional ace-* packages recently, rerun `ace-handbook sync` after installation."
+          end
+
+          def format_source_breakdown(source_breakdown)
+            source_breakdown.map { |source, count| "#{source}:#{count}" }.join(", ")
+          end
         end
       end
     end

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

@@ -21,19 +21,23 @@ module Ace
         end
 
         def sync(provider: nil)
-          providers_to_sync(provider).map { |provider_id| sync_provider(provider_id) }
+          skills = inventory.all
+          source_breakdown = summarize_sources(skills)
+          providers_to_sync(provider).map do |provider_id|
+            sync_provider(provider_id, skills: skills, source_breakdown: source_breakdown)
+          end
         end
 
         private
 
-        def sync_provider(provider)
+        def sync_provider(provider, skills:, source_breakdown:)
           output_dir = File.join(project_root, registry.output_dir(provider))
           prepare_output_dir(output_dir)
 
           expected = {}
           updated_files = 0
 
-          inventory.all.each do |skill|
+          skills.each do |skill|
             next unless Molecules::SkillProjection.projection_targets(skill.frontmatter, registry: registry).include?(provider)
 
             frontmatter = Molecules::SkillProjection.projected_frontmatter(skill.frontmatter, provider: provider)
@@ -55,10 +59,19 @@ module Ace
             relative_output_dir: registry.output_dir(provider),
             projected_skills: expected.size,
             updated_files: updated_files,
-            removed_entries: removed_entries
+            removed_entries: removed_entries,
+            source_breakdown: source_breakdown
           }
         end
 
+        def summarize_sources(skills)
+          skills.each_with_object(Hash.new(0)) do |skill, memo|
+            source = skill.source.to_s
+            key = source.empty? ? "unknown" : source
+            memo[key] += 1
+          end.sort.to_h
+        end
+
         def providers_to_sync(requested_provider)
           providers = if requested_provider
             [requested_provider.to_s]

data/lib/ace/handbook/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Handbook
-  VERSION = '0.21.4'
+  VERSION = '0.23.5'
   end
 end

metadata

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