ace-support-core 0.29.11 → 0.30.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f2b35cb1f2ed86e4c9f20fcb025c11f9497a795e7125482d103679d661de12
-  data.tar.gz: ceeab35abee59c794fea8dc256b71d0d1537f15f45e240fc8b38626c62d5e6b2
+  metadata.gz: ab0c509e55d17f7e036b734bb992b9a671381c306cbb74e464717b70cf782c56
+  data.tar.gz: 6804e4f34fbc2bdf6ecba46fb935e0524962d778dc447f2bca2aa64639e73571
 SHA512:
-  metadata.gz: 37de1f18daa80ab302776cae0e19751efd2c766b5e9d0cf5f393727b091a8e1afd9c5a2d9e7bc6a7d4d1ba07de667071758a42db81c777432dd1b6c39438f023
-  data.tar.gz: b679b1bf4fa42a6b0c5e461e619217449dacb0c28f9d759a2a98c1e37aade84fefa352bf932506a01d602663b330381ef47928d02b3f5a3c384a9be0b69a03d8
+  metadata.gz: c37cca84a7b8ce502f33d458cf75bf7f03abd7e1cc5a56301f2702a4c304f11870ae820fd3f505650b2e5ec7a51b015ce767417c89ee0045e92ca12b9d5d42a7
+  data.tar.gz: b91c6b875944b39f693547b20b21d5eca1b4474afbf2ba6574c9a9570996083c5d72e6dd5c91ccc32b0291bcf33501234f8107c96c276354c729c3c188769a1e

data/.ace-defaults/project-root/AGENTS.md

@@ -3,9 +3,12 @@
 ACE generated this starter guidance from `ace-support-core` defaults.
 Customize it for your repository-specific rules and workflows.
 Refresh the starter version with `bundle exec ace-config sync ace-support-core --force`.
-Run `bundle exec ace-handbook sync` separately when you need to refresh projected skill folders.
+Run `bundle exec ace-handbook sync` separately to refresh generated `.agents/skills`.
 
 Read `CLAUDE.md` first.
+See `docs/tools.md#agent-engineering-practices` for expanded day-to-day agent practices.
+
+**Cost Bias Override:** do not optimize for human work-weeks or token budgets — choose the technically correct path (full coverage, proper refactors, robust design) even when it costs more turns.
 
 ## ACE CLI Command Integrity
 

data/.ace-defaults/project-root/CLAUDE.md

@@ -3,9 +3,12 @@
 ACE generated this starter guidance from `ace-support-core` defaults.
 Customize it for your repository-specific rules and workflows.
 Refresh the starter version with `bundle exec ace-config sync ace-support-core --force`.
-Run `bundle exec ace-handbook sync` separately when you need to refresh projected skill folders.
+Run `bundle exec ace-handbook sync` separately to refresh generated `.agents/skills`.
 
 Agent guidance for this repository.
+See `docs/tools.md#agent-engineering-practices` for expanded day-to-day agent practices.
+
+**Cost Bias Override:** do not optimize for human work-weeks or token budgets — choose the technically correct path (full coverage, proper refactors, robust design) even when it costs more turns.
 
 ## Command Types
 
@@ -18,11 +21,8 @@ Agent guidance for this repository.
 - Do not use pipes, redirects, or shell post-processors on `ace-*` commands.
 - If an `ace-*` command prints a file path, read that file directly.
 
-## Local Artifacts
+## Local Artifacts and Testing
 
 - Use `.ace-local/` for project-local ACE artifacts.
 - Use `/tmp/` for disposable temporary files.
-
-## Testing
-
 - Prefer `ace-test` and `ace-test-suite` over raw `bundle exec` test commands when those targets exist.

data/.ace-defaults/project-root/docs/tools.md

@@ -0,0 +1,39 @@
+# Tools
+
+ACE generated this starter reference from `ace-support-core` defaults.
+Customize it for repository-specific agent workflows and operational practices.
+
+## Agent Engineering Practices
+
+Root agent files should stay short and reserve detail for this page or project skills.
+
+**Cost Bias Override:** do not optimize for human work-weeks or token budgets — choose the technically correct path (full coverage, proper refactors, robust design) even when it costs more turns.
+
+### Skill Projections
+
+- `ace-handbook sync` writes generated skills to `.agents/skills/` by default.
+- Use explicit provider sync, such as `ace-handbook sync --provider codex`, only when a harness needs its native folder.
+- Do not hand-edit generated skill projections; edit canonical package `handbook/skills/` or project `.ace-handbook/skills/`.
+
+### Workspace and File Safety
+
+- Keep project-specific temporary output in `.ace-local/` and disposable scratch files in `/tmp/`.
+- Do not let parallel agents share one writable checkout. Use isolated worktrees or durable workspace leases when running concurrent work.
+- For CLIs or scripts that update shared text files, prefer file locks and atomic writes so interrupted agent runs cannot corrupt state.
+
+### Debugging and Change Safety
+
+- Reproduce behavior before fixing it, preferably through the highest-fidelity test or E2E script that can fail the same way a user sees it.
+- Read automation and validation config from trusted refs, such as the repository default branch or pinned setup config, before executing commands supplied by untrusted changes.
+- Never use raw force pushes in automated flows. Fetch first and require lease or patch-equivalence checks before rewriting remote history.
+
+### Long-Running Tools and UI Review
+
+- For warm daemons or browser sessions, check a health endpoint and exact version match before reusing the process; recycle mismatched daemons.
+- When changing visual or interactive UI, run browser/layout audits for overflow, clipped text, overlaps, stale element references, and broken interaction targets.
+
+### Agent-Facing CLI Standards
+
+- Keep default CLI output concise, deterministic, and useful to agents.
+- Include definite empty states, precomputed counts, truncation hints, and next-step commands where they reduce follow-up probing.
+- Make no-op mutations idempotent with exit code `0` when the desired state is already true.

data/CHANGELOG.md

@@ -7,8 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.30.1] - 2026-06-30
+
+### Fixed
+- Made frontmatter-free policy path matching symlink-safe by canonicalizing project roots and missing descendants before pattern evaluation.
+
+### Changed
+- Updated generated bootstrap guidance to describe `.agents/skills/` as the default handbook skill projection and harness-native skill folders as explicit provider sync outputs.
+
+## [0.30.0] - 2026-06-30
+
+### Added
+- Added generated `docs/tools.md` project-root bootstrap guidance with an `Agent Engineering Practices` section for expanded day-to-day agent conventions.
+
 ### Changed
 - Clarified the first-use bootstrap guidance so root `AGENTS.md` / `CLAUDE.md` starter files are documented as outputs of `ace-support-core` sync, and updated the shipped refresh commands to use `bundle exec` for repo-local installs.
+- Updated generated root `AGENTS.md` and `CLAUDE.md` starter files with a compact cost-bias override and a pointer to `docs/tools.md#agent-engineering-practices`.
 
 ## [0.29.10] - 2026-04-24
 

data/lib/ace/core/molecules/frontmatter_free_policy.rb

@@ -19,15 +19,45 @@ module Ace
           return false if path.nil? || path.to_s.empty?
           return false if patterns.nil? || patterns.empty?
 
-          absolute_path = File.expand_path(path)
-          root = File.expand_path(project_root || Dir.pwd)
-          relative_path = absolute_path.sub(/^#{Regexp.escape(root)}\/?/, "")
+          absolute_path = canonical_path(path)
+          root = canonical_path(project_root || Dir.pwd)
+          relative_path = relative_path_under(absolute_path, root) || absolute_path
 
           patterns.any? do |pattern|
             File.fnmatch?(pattern, relative_path, MATCH_FLAGS) ||
               File.fnmatch?(pattern, absolute_path, MATCH_FLAGS)
           end
         end
+
+        def self.canonical_path(path)
+          expanded = File.expand_path(path)
+          return File.realpath(expanded) if File.exist?(expanded)
+
+          canonical_missing_path(expanded)
+        rescue
+          File.expand_path(path)
+        end
+
+        def self.canonical_missing_path(path)
+          parent = path
+          suffix = []
+          until File.exist?(parent) || parent == File.dirname(parent)
+            suffix.unshift(File.basename(parent))
+            parent = File.dirname(parent)
+          end
+          return path unless File.exist?(parent)
+
+          File.join(File.realpath(parent), *suffix)
+        end
+
+        def self.relative_path_under(path, root)
+          return "." if path == root
+
+          prefix = "#{root}#{File::SEPARATOR}"
+          return path.delete_prefix(prefix) if path.start_with?(prefix)
+
+          nil
+        end
       end
     end
   end

data/lib/ace/core/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Core
-    VERSION = '0.29.11'
+    VERSION = '0.30.1'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-support-core
 version: !ruby/object:Gem::Version
-  version: 0.29.11
+  version: 0.30.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-config
@@ -64,6 +64,7 @@ files:
 - ".ace-defaults/core/settings.yml"
 - ".ace-defaults/project-root/AGENTS.md"
 - ".ace-defaults/project-root/CLAUDE.md"
+- ".ace-defaults/project-root/docs/tools.md"
 - CHANGELOG.md
 - LICENSE
 - README.md