ace-support-core 0.29.11 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f2b35cb1f2ed86e4c9f20fcb025c11f9497a795e7125482d103679d661de12
-  data.tar.gz: ceeab35abee59c794fea8dc256b71d0d1537f15f45e240fc8b38626c62d5e6b2
+  metadata.gz: 24d4b0dce143ebd6e3a05238ffa19ba782ccebf08c7a9027db568d641f1a07e3
+  data.tar.gz: 2ea4aa3a99418d953d05a4622760d3142fcf2593fce656f9c95da5dc0c3d3227
 SHA512:
-  metadata.gz: 37de1f18daa80ab302776cae0e19751efd2c766b5e9d0cf5f393727b091a8e1afd9c5a2d9e7bc6a7d4d1ba07de667071758a42db81c777432dd1b6c39438f023
-  data.tar.gz: b679b1bf4fa42a6b0c5e461e619217449dacb0c28f9d759a2a98c1e37aade84fefa352bf932506a01d602663b330381ef47928d02b3f5a3c384a9be0b69a03d8
+  metadata.gz: 16fb57a03877b9e0602606aa6869613a823d09553fd477921d4827ab2d485c1cdb2620a6ce133d55c9aa00fe2931772aa8ded2354ed12b02d2016cc5c8d0e1a9
+  data.tar.gz: c5dc7f819ca8bd17eac6b24b1c802befbcda08b320a317c2f3b7ad1527b8f2cb08f64866964aadda87f5036908bd2dc6d2502c43e0f77b3ce26de29d9b6c4405

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

@@ -3,20 +3,24 @@
 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.
 
-## ACE CLI Command Integrity
+**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.
 
-Run `ace-*` commands directly. Do not pipe, redirect, or post-process `ace-*` output.
+## Principles
 
-- Run `ace-*` commands directly.
-- When an `ace-*` command prints a file path, read that file directly.
-- Use `.ace-local/` for project-local ACE artifacts and `/tmp/` for disposable temporary files.
+- Do not preserve backward compatibility. Remove obsolete paths instead of adding compatibility layers, fallbacks, or migrations.
+- Choose the simplest implementation that fully meets current requirements. Avoid speculative abstractions, configuration, and indirection.
+- Grow the system in layers from a working end-to-end core. Never trade a working product for unfinished complexity.
+- Keep components modular and concerns clearly separated.
+- Prefer established, well-maintained libraries; lean on dependencies already in the project before inventing or adding packages.
+- Make architectural decisions for the long term. Do not accept intentional stopgaps meant to be replaced later.
+- Study how established products solve the problem before designing. Adopt proven patterns rather than inventing from scratch.
 
-## Working Rules
+## Hard rules
 
-- Keep repository-specific guidance in this file.
-- Do not overwrite unrelated user-owned content when refreshing generated bootstrap files.
-- Use `ace-test` for tests when ACE packages provide test targets.
+- Run `ace-*` commands directly. Do not pipe, redirect, or post-process their output; when they print a path, read that file.
+- Use `.ace-local/` for project-local ACE artifacts and `/tmp/` for disposable temps.
+- Prefer `ace-test` / `ace-test-suite` over raw `bundle exec` tests when those targets exist.

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

@@ -3,26 +3,9 @@
 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.
+Read `AGENTS.md` first.
+See `docs/tools.md#agent-engineering-practices` for expanded day-to-day agent practices.
 
-## Command Types
-
-- Slash commands such as `/as-task-work` run inside the chat tool.
-- `ace-*` commands run in the terminal.
-
-## ACE CLI Output Handling
-
-- Run `ace-*` commands directly.
-- 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
-
-- 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.
+**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.

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

@@ -0,0 +1,40 @@
+# 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.
+Add a rule to `AGENTS.md` only after an agent repeatedly gets something wrong; keep the root file under ~30–50 lines.
+
+**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,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.31.0] - 2026-08-12
+
+### Changed
+- Replaced bootstrap `AGENTS.md` with principles-first starter guidance and made generated `CLAUDE.md` a thin pointer to `AGENTS.md`.
+- Documented when to expand root `AGENTS.md` in generated `docs/tools.md` agent engineering practices.
+## [0.30.2] - 2026-08-12
+
+### Technical
+- Aligned gemspec dependency floors with current ACE package minor release lines and safe external minor dependency bumps (no major version jumps).
+
+## [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.31.0"
   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.31.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.17'
 - !ruby/object:Gem::Dependency
   name: ace-support-fs
   requirement: !ruby/object:Gem::Requirement
@@ -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