ace-support-config 0.16.3 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 292cd8b30cde0ff6e42674342eec91c5ced9ac82e54721c41889e2efce28c0b2
-  data.tar.gz: bc74b84b53654b33d26b737236066c9d4699cda31dce60a4950f68116cccf4b9
+  metadata.gz: 1f7f5cddbf50a8da6f9f42cc644f193cd9a2898757a3417849fc4104546c8ba2
+  data.tar.gz: 54c887961b4c3473a7a4be0bc5383b2ab4975d2d779c86e98c02e180a298c082
 SHA512:
-  metadata.gz: a0f53f807d5dd5660e9e66b429975a52f3b03d8aa3ff50a5bfe2bbfc064d268873affdd9e6c046942e93aaec4f6805803507d78083aea8ab9a8cd60a35b88181
-  data.tar.gz: 955386f488b292bd9eaadb0c0e30324628c0d7022f1bc86a1ac680296a067d720977262d194b5d5963b4098525c094e6c915361bb0abf7a43432b214f4e07c6f
+  metadata.gz: 5a3291da675776cd51aa9f5d888bc8f001c3f0221206c684551ec0bfaa3cbdfe94361ed3c8a56826bce3cd838a172873cdf31afa95202a4ea0dc6278afce111d
+  data.tar.gz: 570b40415d3a4b63b3762d09fea0b43c74628dd91f286818215aaa388371d26dc586f4ab00316b6c781ae38e1555477cf07a03d0340fa2e4f8d1b9ec7b0463a9

data/CHANGELOG.md

@@ -7,9 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.1] - 2026-06-30
+
+### Changed
+- Updated `ace-config doctor` skill projection health to ignore disabled provider projections reported by `ace-handbook status`.
+
+## [0.17.0] - 2026-06-30
+
+### Added
+- Added `ace-config doctor` warnings for projects whose root agent guidance or `docs/tools.md` are missing generated agent-engineering guidance markers.
+
 ### Fixed
 - Corrected `ace-config-bootstrap-root-files` to sync `ace-support-core` and record from the sandbox root layout where the bootstrap files are actually created.
 
+### Technical
+- Expanded bootstrap sync coverage for generated `docs/tools.md`, cost-bias markers, preservation without `--force`, force refresh, and subdirectory root targeting.
+
 ## [0.16.2] - 2026-04-24
 
 ### Technical

data/lib/ace/support/config/organisms/setup_doctor.rb

@@ -28,6 +28,12 @@ module Ace
           CORE_ROLES = %w[commit doctor].freeze
           UTILITY_ROLE_GROUPS = %w[_utility _utility-lite].freeze
           ROLE_REFERENCE_PATTERN = /\brole:([A-Za-z0-9_-]+)\b/
+          COST_BIAS_MARKER = "Cost Bias Override"
+          AGENT_ENGINEERING_ANCHOR = "docs/tools.md#agent-engineering-practices"
+          AGENT_ENGINEERING_HEADING = "## Agent Engineering Practices"
+          AGENT_ENGINEERING_NEXT_ACTION = "Run ace-config sync ace-support-core --force in generated projects, " \
+            "or manually add the Cost Bias Override line and docs/tools.md Agent Engineering Practices section " \
+            "in customized projects."
 
           def run(json: false, no_probe: false, probe: false, hygiene: false, verbose: false, colors: true, quiet: false, io: $stdout)
             started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
@@ -43,6 +49,7 @@ module Ace
             append_check(checks, discovery_check, stream: stream, io: io)
 
             append_check(checks, check_config_defaults, stream: stream, io: io)
+            append_check(checks, check_agent_engineering_guidance, stream: stream, io: io)
 
             provider_context = load_provider_context if package_check[:status] != BLOCKER
 
@@ -173,6 +180,68 @@ module Ace
             )
           end
 
+          def check_agent_engineering_guidance
+            root = project_root
+            root_guidance_paths = %w[AGENTS.md CLAUDE.md].map { |name| File.join(root, name) }
+            docs_path = File.join(root, "docs", "tools.md")
+            existing_root_guidance = root_guidance_paths.select { |path| File.exist?(path) }
+            docs_content = File.exist?(docs_path) ? File.read(docs_path) : nil
+            guidance_contents = existing_root_guidance.to_h { |path| [path, File.read(path)] }
+
+            unless existing_root_guidance.any? || docs_content
+              return check(
+                id: "agent-engineering-guidance",
+                kind: "health",
+                status: PASS,
+                message: "Agent engineering guidance not installed"
+              )
+            end
+
+            findings = []
+            guidance_contents.each do |path, content|
+              next if content.include?(COST_BIAS_MARKER)
+
+              findings << "#{File.basename(path)} lacks #{COST_BIAS_MARKER}"
+            end
+
+            if docs_content.nil?
+              findings << "docs/tools.md is missing"
+            elsif !docs_content.include?(AGENT_ENGINEERING_HEADING)
+              findings << "docs/tools.md lacks #{AGENT_ENGINEERING_HEADING}"
+            end
+
+            if guidance_contents.values.any? { |content| content.include?(AGENT_ENGINEERING_ANCHOR) } &&
+                (!docs_content || !docs_content.include?(AGENT_ENGINEERING_HEADING))
+              findings << "root guidance links #{AGENT_ENGINEERING_ANCHOR} but the anchor target is absent"
+            end
+
+            if findings.empty?
+              return check(
+                id: "agent-engineering-guidance",
+                kind: "health",
+                status: PASS,
+                message: "Agent engineering guidance is present"
+              )
+            end
+
+            check(
+              id: "agent-engineering-guidance",
+              kind: "health",
+              status: WARN,
+              message: "Agent engineering guidance is incomplete",
+              next_action: AGENT_ENGINEERING_NEXT_ACTION,
+              details: findings.uniq
+            )
+          rescue => e
+            check(
+              id: "agent-engineering-guidance",
+              kind: "health",
+              status: WARN,
+              message: "Agent engineering guidance check failed: #{e.message}",
+              next_action: AGENT_ENGINEERING_NEXT_ACTION
+            )
+          end
+
           def check_skill_sync
             out, err, status = Open3.capture3("ace-handbook", "status", "--format", "json")
             unless status.success?
@@ -188,7 +257,8 @@ module Ace
 
             snapshot = JSON.parse(out)
             providers = Array(snapshot["providers"])
-            drifted = providers.select do |entry|
+            checked_providers = providers.select { |entry| entry.fetch("enabled", true) }
+            drifted = checked_providers.select do |entry|
               entry.fetch("missing", 0).to_i.positive? ||
                 entry.fetch("outdated", 0).to_i.positive? ||
                 entry.fetch("extra", 0).to_i.positive?
@@ -200,8 +270,8 @@ module Ace
                 id: "skill-sync",
                 kind: "health",
                 status: PASS,
-                message: "Provider skills are in sync (#{providers.length} providers, #{total_skills} skills)",
-                skill_sync: {providers: providers, canonical_total: total_skills}
+                message: "Provider skills are in sync (#{checked_providers.length} providers, #{total_skills} skills)",
+                skill_sync: {providers: checked_providers, canonical_total: total_skills}
               )
             end
 
@@ -209,10 +279,10 @@ module Ace
               id: "skill-sync",
               kind: "health",
               status: WARN,
-              message: "Provider skill sync drift detected (#{drifted.length}/#{providers.length} providers)",
+              message: "Provider skill sync drift detected (#{drifted.length}/#{checked_providers.length} providers)",
               next_action: "Run ace-handbook sync to refresh provider-native skills.",
               details: drifted.map { |entry| skill_sync_detail(entry) },
-              skill_sync: {providers: providers, drifted: drifted}
+              skill_sync: {providers: checked_providers, drifted: drifted}
             )
           rescue Errno::ENOENT
             check(

data/lib/ace/support/config/version.rb

@@ -3,7 +3,7 @@
 module Ace
   module Support
     module Config
-      VERSION = '0.16.3'
+      VERSION = '0.17.1'
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-support-config
 version: !ruby/object:Gem::Version
-  version: 0.16.3
+  version: 0.17.1
 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-fs