ace-support-core 0.29.3 → 0.29.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7092d5a5a2a6ba1607ece9d4276864f1c2120487e86fc122c4417e1f63d5c464
-  data.tar.gz: b09155f148f14f5d542d1aaa55b2b5e6476ad1e3eee52ed221bd998284c1e641
+  metadata.gz: a6b708c53652bcab306f9ac32f767818083c2ec3d8d08c250765d333b27f7eee
+  data.tar.gz: 1761a2ed810b94d59636b52455ca38bef56eceb58b7b752ebeb4199fd7db35fd
 SHA512:
-  metadata.gz: 37b188395cac1372478d0928bfbf5f7d8777c0f7da372f592636afc88cee8933591ca23e41c08a27f6f85d7601ea09c7215c8bc681d4ad5ed1929d64f24c9a7c
-  data.tar.gz: 9b114626bd4b8394b85315bc09d6a3b77af5b6e606cc882ac212835a7137892931c8742fb8b89170544e0fdc147c399cb86247e546e40a08ea70ccfff4b05ac9
+  metadata.gz: 7ad2edbaca8fae8c51cfd934608b6e5b7c087764626515ddb1c0a4913d436a4b63f41d5ed07b6670f7c4d6f4d70eecbc01e5ccf0bd47f9ea3a3c8a9c582c8894
+  data.tar.gz: 2e968110a915140fb18dd5dc8de8044e19c80c6a1b71bc774b146f0b7dc23657873952fd748334906ceb7a188769e8379f441e5359ae79157bc16892b84049dd

data/.ace-defaults/README.md

@@ -0,0 +1,16 @@
+# .ace Configuration
+
+This directory contains local ACE configuration for your project.
+These starter files are intentionally generic so you can tailor them to your own codebase.
+
+## First Steps
+
+1. Review `.ace/bundle/presets/project.md` and replace TODO placeholders.
+2. Optionally use `.ace/bundle/presets/project-base.md` for lightweight context loading.
+3. Run `ace-bundle project` to verify the preset loads successfully.
+4. Use `ace-task status` to inspect and manage your project task queue.
+
+## Notes
+
+- Re-run `ace-config init --force` to refresh files from gem defaults.
+- Keep project-specific guidance in your local `.ace/` files.

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.29.5] - 2026-03-31
+
+### Changed
+- Migrated config CLI ownership to `ace-support-config` by removing `ace-framework` packaging/runtime surfaces from `ace-support-core` and updating package docs/default guidance to reference `ace-config`.
+
+## [0.29.4] - 2026-03-29
+
+### Changed
+- Added a shipped `.ace-defaults/README.md` scaffold so `ace-framework init` generates `.ace/README.md` for newly initialized projects.
+- Updated bootstrap configuration guidance and examples to current `ace-task` CLI usage and documented generated `project`/`project-base` presets.
+
 ## [0.29.3] - 2026-03-29
 
 ### Technical

data/README.md

@@ -14,13 +14,13 @@
 
 > Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.
 
-`ace-support-core` centralizes configuration loading, environment handling, and shared runtime behavior used by support libraries. It delegates config resolution through [ace-support-config](../ace-support-config) and exposes stable orchestration points that other `ace-support-*` gems build on. The `ace-framework` CLI manages per-package configuration setup.
+`ace-support-core` centralizes configuration loading, environment handling, and shared runtime behavior used by support libraries. It delegates config resolution through [ace-support-config](../ace-support-config) and exposes stable orchestration points that other `ace-support-*` gems build on.
 
 ## How It Works
 
 1. Provide a shared bootstrap path for config, env, and runtime context so every `ace-support-*` gem starts from the same foundation.
 2. Delegate cascaded configuration resolution through [ace-support-config](../ace-support-config) so packages inherit project, user, and gem-level defaults automatically.
-3. Expose the `ace-framework` CLI for initializing, diffing, and listing gem configurations across the workspace.
+3. Provide shared runtime/config primitives consumed by `ace-support-config`, which owns the `ace-config` CLI.
 
 ## Use Cases
 
@@ -31,4 +31,4 @@
 **Keep support libraries composable** - build package-specific features on top of stable core contracts that provide predictable runtime behavior.
 
 ---
-[Configuration overview](docs/config.md) | [`ace-framework` CLI reference](docs/config.md) | Part of [ACE](https://github.com/cs3b/ace)
+[Configuration overview](docs/config.md) | [`ace-config` usage](../ace-support-config/docs/usage.md) | Part of [ACE](https://github.com/cs3b/ace)

data/lib/ace/core/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Core
-    VERSION = '0.29.3'
+    VERSION = '0.29.5'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-support-core
 version: !ruby/object:Gem::Version
-  version: 0.29.3
+  version: 0.29.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
@@ -56,17 +56,16 @@ description: Foundational infrastructure gem providing configuration cascade res
   gem following ace-support-* pattern for infrastructure components.
 email:
 - mc@cs3b.com
-executables:
-- ace-framework
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".ace-defaults/README.md"
 - ".ace-defaults/core/settings.yml"
 - CHANGELOG.md
 - LICENSE
 - README.md
 - Rakefile
-- exe/ace-framework
 - lib/ace/core.rb
 - lib/ace/core/atoms/command_executor.rb
 - lib/ace/core/atoms/config_summary.rb
@@ -75,18 +74,14 @@ files:
 - lib/ace/core/atoms/glob_expander.rb
 - lib/ace/core/atoms/process_terminator.rb
 - lib/ace/core/atoms/template_parser.rb
-- lib/ace/core/cli.rb
 - lib/ace/core/cli/config_summary_mixin.rb
 - lib/ace/core/config_discovery.rb
 - lib/ace/core/errors.rb
-- lib/ace/core/models/config_templates.rb
 - lib/ace/core/molecules/env_loader.rb
 - lib/ace/core/molecules/file_aggregator.rb
 - lib/ace/core/molecules/frontmatter_free_policy.rb
 - lib/ace/core/molecules/output_formatter.rb
 - lib/ace/core/molecules/prompt_cache_manager.rb
-- lib/ace/core/organisms/config_diff.rb
-- lib/ace/core/organisms/config_initializer.rb
 - lib/ace/core/organisms/environment_manager.rb
 - lib/ace/core/version.rb
 homepage: https://github.com/cs3b/ace

data/exe/ace-framework

@@ -1,13 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "ace/core"
-require "ace/core/cli"
-
-# Start FrameworkCLI (separate from Ace::Core::CLI module which is ace-support-cli infrastructure)
-begin
-  Ace::Core::FrameworkCLI.start(ARGV)
-rescue Ace::Support::Cli::Error => e
-  warn e.message
-  exit(e.exit_code)
-end

data/lib/ace/core/cli.rb

@@ -1,192 +0,0 @@
-# frozen_string_literal: true
-
-require "optparse"
-require_relative "organisms/config_initializer"
-require_relative "organisms/config_diff"
-require_relative "models/config_templates"
-
-module Ace
-  module Core
-    # Framework CLI for ace-framework binary.
-    # Uses a separate class name to avoid collision with Ace::Core::CLI module
-    # (which provides shared CLI infrastructure).
-    class FrameworkCLI
-      def self.start(argv)
-        new.run(argv)
-      end
-
-      def run(argv)
-        return show_help if argv.empty?
-
-        command = argv.shift
-
-        case command
-        when "init"
-          run_init(argv)
-        when "diff"
-          run_diff(argv)
-        when "list"
-          run_list(argv)
-        when "version", "--version"
-          show_version
-        when "help", "--help", "-h"
-          show_help
-        else
-          puts "Unknown command: #{command}"
-          puts ""
-          show_help
-          exit 1
-        end
-      end
-
-      private
-
-      def run_init(argv)
-        options = {}
-
-        parser = OptionParser.new do |opts|
-          opts.banner = <<~BANNER.chomp
-            NAME
-              ace-framework init - Initialize configuration for ace-* gems
-
-            USAGE
-              ace-framework init [GEM] [OPTIONS]
-
-            OPTIONS
-          BANNER
-          opts.on("--force", "Overwrite existing files") { options[:force] = true }
-          opts.on("--dry-run", "Show what would be done") { options[:dry_run] = true }
-          opts.on("--global", "Use ~/.ace instead of ./.ace") { options[:global] = true }
-          opts.on("--verbose", "Show verbose output") { options[:verbose] = true }
-          opts.on("-h", "--help", "Show this help") {
-            puts opts
-            exit
-          }
-        end
-
-        parser.parse!(argv)
-        gem_name = argv.shift
-
-        initializer = ConfigInitializer.new(**options)
-
-        if gem_name
-          initializer.init_gem(gem_name)
-        else
-          initializer.init_all
-        end
-      end
-
-      def run_diff(argv)
-        options = {}
-
-        parser = OptionParser.new do |opts|
-          opts.banner = <<~BANNER.chomp
-            NAME
-              ace-framework diff - Compare configs with examples
-
-            USAGE
-              ace-framework diff [GEM] [OPTIONS]
-
-            OPTIONS
-          BANNER
-          opts.on("--global", "Compare global configs") { options[:global] = true }
-          opts.on("--local", "Compare local configs (default)") { options[:local] = true }
-          opts.on("--file PATH", "Compare specific file") { |f| options[:file] = f }
-          opts.on("--one-line", "One-line summary per file") { options[:one_line] = true }
-          opts.on("-h", "--help", "Show this help") {
-            puts opts
-            exit
-          }
-        end
-
-        parser.parse!(argv)
-        gem_name = argv.shift
-
-        differ = ConfigDiff.new(**options)
-
-        if gem_name
-          differ.diff_gem(gem_name)
-        else
-          differ.run
-        end
-      end
-
-      def run_list(argv)
-        verbose = false
-
-        parser = OptionParser.new do |opts|
-          opts.banner = <<~BANNER.chomp
-            NAME
-              ace-framework list - List available ace-* gems with example configs
-
-            USAGE
-              ace-framework list [OPTIONS]
-
-            OPTIONS
-          BANNER
-          opts.on("--verbose", "Show detailed information") { verbose = true }
-          opts.on("-h", "--help", "Show this help") {
-            puts opts
-            exit
-          }
-        end
-
-        parser.parse!(argv)
-
-        puts "Available ace-* gems with example configurations:\n\n"
-
-        if ConfigTemplates.all_gems.empty?
-          puts "No ace-* gems with example configurations found."
-          return
-        end
-
-        ConfigTemplates.all_gems.each do |gem_name|
-          info = ConfigTemplates.gem_info[gem_name]
-          source_label = case info[:source]
-          when :local then "[local]"
-          when :gem then "[gem]"
-          when :both then "[local+gem]"
-          end
-
-          puts "  #{gem_name} #{source_label}"
-
-          if verbose
-            puts "    Path: #{info[:path]}"
-            puts "    Gem: #{info[:gem_path]}" if info[:gem_path]
-            example_dir = ConfigTemplates.example_dir_for(gem_name)
-            if example_dir && File.exist?(example_dir)
-              example_files = Dir.glob("#{example_dir}/**/*").reject { |f| File.directory?(f) }
-              puts "    Example files: #{example_files.size}"
-            end
-          end
-        end
-
-        puts "\nUse 'ace-framework init [GEM]' to initialize a specific gem's configuration"
-        puts "Use 'ace-framework init' to initialize all configurations"
-      end
-
-      def show_version
-        puts "ace-framework #{Ace::Core::VERSION}"
-      end
-
-      def show_help
-        puts <<~HELP
-          NAME
-            ace-framework - Configuration management for ace-* gems
-
-          USAGE
-            ace-framework COMMAND [OPTIONS]
-
-          COMMANDS
-            init [GEM]                        Initialize configuration for specific gem or all
-            diff [GEM]                        Compare configs with examples
-            list                              List available ace-* gems with example configs
-            version                           Show version
-            help                              Show this help
-
-          Run 'ace-framework COMMAND --help' for more information on a command.
-        HELP
-      end
-    end
-  end
-end

data/lib/ace/core/models/config_templates.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-require "rubygems"
-
-module Ace
-  module Core
-    class ConfigTemplates
-      class << self
-        def all_gems
-          gem_info.keys.sort
-        end
-
-        def gem_exists?(gem_name)
-          gem_info.key?(gem_name)
-        end
-
-        def example_dir_for(gem_name)
-          info = gem_info[gem_name]
-          return nil unless info
-
-          # Prefer local path for development
-          path = (info[:source] == :gem) ? info[:path] : (info[:path] || info[:gem_path])
-          resolve_defaults_dir(path)
-        end
-
-        def gem_info
-          @gem_info ||= build_gem_info
-        end
-
-        def build_gem_info
-          gems = {}
-
-          # 1. Look in the parent directory (monorepo/development)
-          parent_dir = File.expand_path("../../../../../../", __FILE__)
-          Dir.glob("#{parent_dir}/ace-*").each do |dir|
-            next unless File.directory?(dir)
-            gem_name = File.basename(dir)
-            if has_example_dir?(dir)
-              gems[gem_name] = {source: :local, path: dir}
-            end
-          end
-
-          # 2. Look for installed RubyGems
-          begin
-            Gem::Specification.each do |spec|
-              next unless spec.name.start_with?("ace-")
-
-              gem_path = spec.gem_dir
-              if has_example_dir?(gem_path)
-                if gems.key?(spec.name)
-                  gems[spec.name][:source] = :both
-                  gems[spec.name][:gem_path] = gem_path
-                else
-                  gems[spec.name] = {source: :gem, path: gem_path}
-                end
-              end
-            end
-          rescue
-            # If we can't access installed gems, just use local ones
-          end
-
-          gems
-        end
-
-        def docs_file_for(gem_name)
-          info = gem_info[gem_name]
-          return nil unless info
-
-          # Prefer local path for development
-          path = (info[:source] == :gem) ? info[:path] : (info[:path] || info[:gem_path])
-          File.join(path, "docs", "config.md")
-        end
-
-        private
-
-        def resolve_defaults_dir(gem_path)
-          File.join(gem_path, ".ace-defaults")
-        end
-
-        def has_example_dir?(gem_dir)
-          Dir.exist?(File.join(gem_dir, ".ace-defaults"))
-        end
-      end
-    end
-  end
-end

data/lib/ace/core/organisms/config_diff.rb

@@ -1,187 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-require "pathname"
-require_relative "../models/config_templates"
-
-module Ace
-  module Core
-    class ConfigDiff
-      def initialize(global: false, file: nil, one_line: false)
-        @global = global
-        @file = file
-        @one_line = one_line
-        @diffs = []
-      end
-
-      def run
-        if @file
-          diff_file(@file)
-        else
-          diff_all_configs
-        end
-
-        print_results
-      end
-
-      def diff_gem(gem_name)
-        # Normalize gem name (support both "ace-bundle" and "bundle")
-        gem_name = gem_name.start_with?("ace-") ? gem_name : "ace-#{gem_name}"
-
-        unless ConfigTemplates.gem_exists?(gem_name)
-          puts "Error: Gem '#{gem_name}' not found or has no example configurations"
-          exit 1
-        end
-
-        diff_gem_configs(gem_name)
-        print_results
-      end
-
-      private
-
-      def config_directory
-        @global ? File.expand_path("~/.ace") : ".ace"
-      end
-
-      def diff_all_configs
-        ConfigTemplates.all_gems.each do |gem_name|
-          diff_gem_configs(gem_name)
-        end
-      end
-
-      def diff_gem_configs(gem_name)
-        source_dir = ConfigTemplates.example_dir_for(gem_name)
-
-        return unless source_dir && File.exist?(source_dir)
-
-        Dir.glob("#{source_dir}/**/*").each do |source_file|
-          next if File.directory?(source_file)
-
-          relative_path = Pathname.new(source_file).relative_path_from(Pathname.new(source_dir))
-          target_file = File.join(config_directory, relative_path.to_s)
-
-          compare_files(source_file, target_file, gem_name)
-        end
-      end
-
-      def diff_file(file_path)
-        # Determine which gem this file belongs to
-        if file_path.start_with?(config_directory)
-          relative_path = Pathname.new(file_path).relative_path_from(Pathname.new(config_directory))
-          parts = relative_path.to_s.split(File::SEPARATOR)
-
-          if parts.any?
-            config_subdir = parts.first
-            gem_name = "ace-#{config_subdir}"
-
-            if ConfigTemplates.gem_exists?(gem_name)
-              source_dir = ConfigTemplates.example_dir_for(gem_name)
-              relative_file = parts[1..-1].join(File::SEPARATOR)
-              source_file = File.join(source_dir, relative_file)
-
-              if File.exist?(source_file)
-                compare_files(source_file, file_path, gem_name)
-              else
-                puts "No example file found for #{file_path}"
-              end
-            end
-          end
-        else
-          puts "File #{file_path} is not in a configuration directory"
-        end
-      end
-
-      def compare_files(source_file, target_file, gem_name)
-        @diffs << if !File.exist?(target_file)
-          {
-            gem: gem_name,
-            file: target_file,
-            status: :missing,
-            source: source_file
-          }
-        elsif files_differ?(source_file, target_file)
-          {
-            gem: gem_name,
-            file: target_file,
-            status: :different,
-            source: source_file,
-            diff_output: get_diff_output(source_file, target_file)
-          }
-        else
-          {
-            gem: gem_name,
-            file: target_file,
-            status: :same,
-            source: source_file
-          }
-        end
-      end
-
-      def files_differ?(file1, file2)
-        File.read(file1) != File.read(file2)
-      rescue
-        true
-      end
-
-      def get_diff_output(source_file, target_file)
-        # Use system diff command
-        output, _status = Open3.capture2("diff", "-u", target_file, source_file)
-        output
-      rescue
-        "Unable to generate diff"
-      end
-
-      def print_results
-        if @one_line
-          print_one_line_summary
-        else
-          print_detailed_diffs
-        end
-      end
-
-      def print_one_line_summary
-        @diffs.each do |diff|
-          case diff[:status]
-          when :missing
-            puts "MISSING: #{diff[:file]}"
-          when :different
-            puts "CHANGED: #{diff[:file]}"
-          when :same
-            puts "SAME:    #{diff[:file]}" if @verbose
-          end
-        end
-
-        puts "\nSummary:"
-        puts "  Missing: #{@diffs.count { |d| d[:status] == :missing }}"
-        puts "  Changed: #{@diffs.count { |d| d[:status] == :different }}"
-        puts "  Same: #{@diffs.count { |d| d[:status] == :same }}"
-      end
-
-      def print_detailed_diffs
-        missing = @diffs.select { |d| d[:status] == :missing }
-        changed = @diffs.select { |d| d[:status] == :different }
-
-        if missing.any?
-          puts "Missing configuration files:"
-          missing.each do |diff|
-            puts "  #{diff[:file]}"
-            puts "  -> Example: #{diff[:source]}"
-          end
-          puts
-        end
-
-        if changed.any?
-          puts "Changed configuration files:"
-          changed.each do |diff|
-            puts "\n#{diff[:file]}:"
-            puts diff[:diff_output]
-          end
-        end
-
-        if missing.empty? && changed.empty?
-          puts "All configuration files match the examples."
-        end
-      end
-    end
-  end
-end

data/lib/ace/core/organisms/config_initializer.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-require "fileutils"
-require "pathname"
-require_relative "../models/config_templates"
-
-module Ace
-  module Core
-    class ConfigInitializer
-      def initialize(force: false, dry_run: false, global: false, verbose: false)
-        @force = force
-        @dry_run = dry_run
-        @global = global
-        @verbose = verbose
-        @copied_files = []
-        @skipped_files = []
-      end
-
-      def init_all
-        puts "Initializing all ace-* gem configurations..." if @verbose
-
-        ConfigTemplates.all_gems.each do |gem_name|
-          init_gem(gem_name)
-        end
-
-        print_summary
-      end
-
-      def init_gem(gem_name)
-        gem_name = normalize_gem_name(gem_name)
-
-        unless ConfigTemplates.gem_exists?(gem_name)
-          puts "Warning: No configuration found for #{gem_name}"
-          return
-        end
-
-        puts "\nInitializing #{gem_name}..." if @verbose
-
-        source_dir = ConfigTemplates.example_dir_for(gem_name)
-        target_dir = target_directory
-
-        unless File.exist?(source_dir)
-          puts "Warning: No .ace-defaults directory found for #{gem_name}"
-          return
-        end
-
-        # Show config docs on first run if config is missing
-        show_config_docs_if_needed(gem_name, target_dir)
-
-        # Copy files from .ace-defaults to .ace
-        copy_config_files(source_dir, target_dir, gem_name)
-      end
-
-      private
-
-      def normalize_gem_name(name)
-        # Handle both "ace-core" and "core" formats
-        name.start_with?("ace-") ? name : "ace-#{name}"
-      end
-
-      def target_directory
-        @global ? File.expand_path("~/.ace") : ".ace"
-      end
-
-      def show_config_docs_if_needed(gem_name, target_dir)
-        # Check if any config files exist for this gem
-        config_subdir = gem_name.sub("ace-", "")
-
-        # Look for any existing config files in the expected location
-        existing_configs = Dir.glob("#{target_dir}/#{config_subdir}/**/*").reject { |f| File.directory?(f) }
-
-        # Only show docs if this is the first time (no existing config)
-        if existing_configs.empty? && !@dry_run
-          docs_file = ConfigTemplates.docs_file_for(gem_name)
-          if File.exist?(docs_file)
-            puts "\n#{File.read(docs_file)}\n"
-          end
-        end
-      end
-
-      def copy_config_files(source_dir, target_dir, gem_name)
-        Dir.glob("#{source_dir}/**/*").each do |source_file|
-          next if File.directory?(source_file)
-
-          # Calculate relative path from source_dir
-          relative_path = Pathname.new(source_file).relative_path_from(Pathname.new(source_dir))
-
-          # Build target path - files already include their subdirectory
-          target_file = File.join(target_dir, relative_path.to_s)
-
-          copy_file(source_file, target_file)
-        end
-      end
-
-      def copy_file(source, target)
-        if File.exist?(target) && !@force
-          @skipped_files << target
-          puts "  Skipped: #{target} (already exists)" if @verbose
-          return
-        end
-
-        if @dry_run
-          puts "  Would copy: #{source} -> #{target}"
-        else
-          FileUtils.mkdir_p(File.dirname(target))
-          FileUtils.cp(source, target)
-          @copied_files << target
-          puts "  Copied: #{target}" if @verbose
-        end
-      end
-
-      def print_summary
-        return if @dry_run
-
-        puts "\nConfiguration initialization complete:"
-        puts "  Files copied: #{@copied_files.size}"
-        puts "  Files skipped: #{@skipped_files.size}"
-
-        if @skipped_files.any? && !@force
-          puts "\nUse --force to overwrite existing files"
-        end
-      end
-    end
-  end
-end