ace-search 0.24.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bf2ed45b6a6a54ac87cdf1d8ec9b5b77d0ae4f2b53a83e99604e333ec5fe70c0
+  data.tar.gz: aea55381411e2520242d54004ee3ffa26e57a485f06a7392f0d9912c46cd3971
+SHA512:
+  metadata.gz: 6e9f478bec1f722643ff1ec6ae62bec2ebb32d0b2d683c4c7d47c4b99306561ebc780ae4f117176a27829a0df21365eeb70520d90e2ca4ae2c73db659e162ced
+  data.tar.gz: 83c749cfcf37340fc96d24125f8033a5e682db193c0b8f6e2341b0cbff6948b4e93846eb52f685a68039f13db0ed94e471c100fa6fc4eaaef3d06d77892c1102

data/.ace-defaults/nav/protocols/wfi-sources/ace-search.yml

@@ -0,0 +1,19 @@
+---
+# WFI Sources Protocol Configuration for ace-search gem
+# This enables workflow discovery from the installed ace-search gem
+
+name: ace-search
+type: gem
+description: Search workflow instructions from ace-search gem
+priority: 10
+
+# Configuration for workflow discovery within the gem
+config:
+  # Relative path within the gem (default: handbook/workflow-instructions)
+  relative_path: handbook/workflow-instructions
+
+  # Pattern for finding workflow files (default: *.wf.md)
+  pattern: "*.wf.md"
+
+  # Enable discovery
+  enabled: true

data/.ace-defaults/search/config.yml

@@ -0,0 +1,45 @@
+# ACE Search Configuration
+#
+# Any CLI flag can be set as a default here (use underscore for dashes)
+# Configuration cascade: defaults → ~/.ace/search/config.yml → ./.ace/search/config.yml → CLI flags
+
+ace:
+  search:
+    # Execution defaults
+    timeout: 120                # seconds - timeout for ripgrep/fd commands
+
+    # Pattern matching defaults
+    case_insensitive: false     # -i, --case-insensitive
+    whole_word: false           # -w, --whole-word
+    multiline: false            # -U, --multiline
+
+    # Output defaults
+    max_results: null           # --max-results NUM
+    context: 0                  # -C, --context NUM (or -A/-B for before/after)
+    files_with_matches: false   # -l, --files-with-matches
+    hidden: false               # --hidden
+
+    # Search type
+    type: auto                  # -t, --type (file/content/hybrid/auto)
+
+    # Exclusions (default excludes for done/archived tasks)
+    exclude:
+      - ".ace-tasks/done/**/*"
+      - "dev-taskflow/done/**/*"
+      - "dev-taskflow/current/*/tasks/x/*"
+      - "vendor/**/*"
+      - "node_modules/**/*"
+      - "coverage/**/*"
+      - "tmp/**/*"
+
+    # Inclusions (optional, empty by default)
+    include: []
+
+    # Git scope (optional: staged, tracked, changed)
+    # scope: null
+
+    # Glob patterns (optional)
+    # glob: "*.rb"
+
+    # Preset directory (relative to .ace/search/)
+    preset_dir: "presets"

data/.ace-defaults/search/presets/code.yml

@@ -0,0 +1,22 @@
+# Code Search Preset
+#
+# Search only in code files, excluding common non-code directories
+
+name: code
+description: Search code files only
+
+# File patterns
+glob: "*.{rb,js,ts,py,go,java,c,cpp,h,hpp,rs,swift,kt}"
+
+# Exclusions
+exclude:
+  - "vendor/**/*"
+  - "node_modules/**/*"
+  - "coverage/**/*"
+  - "tmp/**/*"
+  - "dist/**/*"
+  - "build/**/*"
+  - ".git/**/*"
+
+# Case sensitivity for code
+case_insensitive: false

data/CHANGELOG.md

@@ -0,0 +1,404 @@
+# Changelog
+
+All notable changes to ace-search will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.24.0] - 2026-03-24
+
+### Fixed
+- Expanded "DWIM" acronym to "Do What I Mean" on first use in README for clarity.
+- Corrected preset path in getting-started guide from `.ace/search/config.yml` to `.ace/search/presets/<name>.yml`.
+
+### Changed
+- Updated demo tape to use shipped `code` preset instead of non-existent `my-preset`; re-recorded getting-started GIF.
+
+## [0.23.2] - 2026-03-23
+
+### Changed
+- Refreshed README overview and navigation to align with the current package layout pattern.
+
+## [0.23.1] - 2026-03-22
+
+### Changed
+- Replaced placeholder commands in `docs/demo/ace-search-getting-started.tape.yml` with real `ace-search` getting-started command flow.
+
+## [0.23.0] - 2026-03-22
+
+### Changed
+- Rewrote README as a landing page, added getting-started/usage/handbook docs, added demo tape and GIF, and refreshed gemspec metadata messaging.
+
+## [0.22.0] - 2026-03-20
+
+### Changed
+- Expanded `TS-SEARCH-001` E2E coverage with a new JSON-output goal and tightened runner/verifier artifact-evidence contracts across existing goals.
+
+## [0.21.8] - 2026-03-18
+
+### Changed
+- Migrated CLI namespace from `Ace::Core::CLI::*` to `Ace::Support::Cli::*` (ace-support-cli is now the canonical home for CLI infrastructure).
+
+
+## [0.21.7] - 2026-03-15
+
+### Fixed
+- Updated E2E content-search test to use unambiguous search pattern avoiding false substring match failures
+
+## [0.21.6] - 2026-03-15
+
+### Changed
+- Migrated CLI framework from dry-cli to ace-support-cli
+
+## [0.21.5] - 2026-03-13
+
+### Technical
+- Updated canonical search workflow skill metadata for bundled workflow execution.
+
+## [0.21.4] - 2026-03-13
+
+### Changed
+- Updated canonical search research skills to explicitly run bundled workflows in the current project and execute them end-to-end.
+
+## [0.21.3] - 2026-03-13
+
+### Changed
+- Replaced provider-specific Codex execution metadata on the canonical `as-search-run` skill with a unified canonical skill body that declares arguments, variables, and explicit workflow-execution guidance.
+- Limited provider-specific forking for `as-search-run` to Claude frontmatter only.
+
+## [0.21.2] - 2026-03-12
+
+### Added
+- Added a public `--count` CLI flag and threaded it through search option building so count-oriented ripgrep execution is available through `ace-search`.
+
+### Changed
+- Updated search E2E runner guidance to use deterministic project-root paths for file and count mode coverage.
+
+### Technical
+- Added CLI and option-builder regression coverage for the new count flag.
+
+## [0.21.1] - 2026-03-12
+
+### Changed
+- Updated handbook search-agent examples to use current `ace-*/handbook/**/*` paths instead of legacy shared handbook locations.
+
+## [0.21.0] - 2026-03-12
+
+### Added
+- Added Codex-specific delegated execution metadata to the canonical `as-search-run` skill so the generated Codex skill runs in fork context on `gpt-5.3-codex-spark`.
+
+## [0.20.0] - 2026-03-10
+
+### Added
+- Added canonical handbook-owned search and research skills for feature research, multi-search analysis, and direct search execution.
+
+
+## [0.19.8] - 2026-03-05
+
+### Changed
+- Search result parsing now selects file-only mode when `files_with_matches` is requested, avoiding text-parse assumptions.
+
+## [0.19.7] - 2026-02-23
+
+### Technical
+- Updated internal dependency version constraints to current releases
+
+## [0.19.6] - 2026-02-22
+
+### Changed
+- Migrate CLI from registry/default-routing to single-command entrypoint (`Dry::CLI.new(Ace::Search::CLI::Commands::Search).call`).
+- Treat no-argument invocation as help (`--help`) in `exe/ace-search`.
+
+### Fixed
+- Handle `--version` directly in the search command path, ensuring version output works in single-command mode.
+
+### Technical
+- Update workflow/guide references to use `ace-search "pattern"` (no `search` subcommand).
+- Align CLI routing and integration tests with single-command behavior.
+
+## [0.19.4] - 2026-02-22
+
+### Changed
+- Migrate skill naming and invocation references to hyphenated `ace-*` format (no underscores).
+
+## [0.19.3] - 2026-02-19
+
+### Technical
+- Namespace workflow instructions into search/ subdirectory with updated wfi:// URIs
+
+## [0.19.2] - 2026-01-31
+
+### Fixed
+- Reset config in test setup to prevent test isolation issues
+
+## [0.19.1] - 2026-01-16
+
+### Changed
+- Rename context: to bundle: keys in configuration files
+
+## [0.19.0] - 2025-01-14
+
+### Added
+- Migrate CLI to Hanami pattern (task 213)
+  - Move command implementation from `commands/` to `cli/commands/` directory
+  - Update module namespace to `CLI::Commands::Search` following Hanami/dry-cli standard
+  - Clean up model requires by moving them from `cli.rb` into the command file
+
+### Fixed
+- Fix critical search_path bug where local variable was used instead of instance variable
+  - Changed `search_path = options[:search_path]` to `@search_path = options[:search_path]`
+  - This ensures resolve_search_path receives the correct search path value
+
+### Technical
+- Update CLI pattern documentation to reflect Hanami standard
+- Remove obsolete `commands/` directory structure
+
+
+## [0.18.1] - 2026-01-09
+
+### Changed
+- **BREAKING**: Eliminate wrapper pattern in dry-cli command
+  - Merged business logic directly into `Search` dry-cli command class
+  - Deleted `search_command.rb` wrapper file
+  - Simplified architecture by removing unnecessary delegation layer
+
+## [0.18.0] - 2026-01-07
+
+### Changed
+- **BREAKING**: Migrated CLI framework from Thor to dry-cli (task 179.02)
+  - Replaced `thor` dependency with `dry-cli ~> 1.0`
+  - Added `ace-support-core ~> 0.19` dependency for dry-cli infrastructure
+  - All user-facing commands, options, and behavior remain identical
+  - Single-command usage supported (`ace-search pattern`)
+  - Numeric option type-conversion handled for parity with Thor implementation
+  - Standardized `KNOWN_COMMANDS` pattern across dry-cli gems
+
+## [0.17.0] - 2026-01-05
+
+### Added
+- Thor CLI migration with standardized command structure
+- ConfigSummary display for effective configuration with sensitive key filtering
+- Comprehensive CLI help documentation across all commands
+- self.help overrides for custom command descriptions
+
+### Changed
+- Adopted Ace::Core::CLI::Base for standardized options (--quiet, --verbose, --debug)
+- Migrated from OptionParser to Thor framework
+- Added method_missing for default subcommand support
+
+### Fixed
+- CLI routing and dependency management for feature parity
+- --help dispatch for all ACE commands
+- Resolved -v flag conflict and search interactive mode bug
+- Add handle_no_command_error for command name patterns
+- Addressed PR #123 review findings for Medium and higher priority issues
+
+## [0.16.0] - 2026-01-03
+
+### Changed
+- **BREAKING**: Minimum Ruby version raised to 3.3.0 (was 3.1.0)
+- Standardized gemspec file patterns with deterministic Dir.glob
+- Added MIT LICENSE file
+
+## [0.15.2] - 2026-01-01
+
+### Changed
+
+* Add configurable timeout in `.ace-defaults/search/config.yml`
+* Centralize fd executor timeout from config instead of hardcoded value
+
+## [0.15.1] - 2025-12-30
+
+### Changed
+
+- Replace ace-support-core dependency with ace-config for configuration cascade
+- Migrate from Ace::Core to Ace::Config.create() API
+- Migrate from `resolve_for` to `resolve_namespace` for cleaner config loading
+
+## [0.15.0] - 2025-12-30
+
+### Changed
+
+* Rename `.ace.example/` to `.ace-defaults/` for gem defaults directory
+
+
+## [0.14.0] - 2025-12-29
+
+### Changed
+- Migrate ProjectRootFinder dependency from `Ace::Core::Molecules` to `Ace::Support::Fs::Molecules` for direct ace-support-fs usage
+
+## [0.13.0] - 2025-12-28
+
+### Added
+- **ADR-022 Configuration Pattern**: Migrate to gem defaults from `.ace.example/` with user override support
+  - Load defaults from `.ace.example/search/config.yml` at runtime
+  - Deep merge with user config via ace-core cascade
+  - Follows "gem defaults < user config" priority
+
+### Fixed
+- **Debug Check Consistency**: Standardized `debug?` method to use `== "1"` pattern across all gems
+
+## [0.12.0] - 2025-12-27
+
+### Changed
+
+- **Dependency Migration**: Migrated GitScopeFilter to ace-git package
+  - Now uses `Ace::Git::Atoms::GitScopeFilter` from ace-git (~> 0.3)
+  - Removed local `Ace::Search::Molecules::GitScopeFilter` implementation
+  - Centralizes Git file scope operations across ACE ecosystem
+
+## [0.11.4] - 2025-11-16
+
+### Changed
+
+- **Dependency Update**: Updated ace-support-core dependency from `~> 0.9` to `~> 0.11`
+  - Provides access to latest PromptCacheManager and infrastructure improvements
+  - Maintains compatibility with standardized ACE ecosystem patterns
+
+## [0.11.3] - 2025-11-01
+
+### Changed
+
+- **Dependency Migration**: Updated to use renamed infrastructure gems
+  - Changed dependency from `ace-core` to `ace-support-core`
+  - Part of ecosystem-wide naming convention alignment for infrastructure gems
+
+
+## [0.11.2] - 2025-10-25
+
+### Changed
+- Implement code review suggestions for clarity and documentation
+- Add design rationale comment to SearchPathResolver explaining ENV var validation
+- Add upgrade note in README linking to Troubleshooting section
+- Document DebugLogger threading context and caching behavior
+- Condense CLI warning message for non-existent paths
+
+## [0.11.1] - 2025-10-25
+
+### Added
+- Centralized DebugLogger module for unified debug output formatting
+- Path validation warnings for non-existent explicit search paths
+- Comprehensive troubleshooting guide in README
+- DEBUG environment variable documentation with example output
+
+### Technical
+- Edge case test coverage for SearchPathResolver (symlinks, non-existent paths, relative paths)
+- Improved debug output consistency across executors
+- 21 additional test cases (17 DebugLogger, 4 edge cases)
+
+## [0.11.0] - 2025-10-25
+
+### Added
+- Project-wide search by default: `ace-search` now searches entire project from root regardless of current directory
+- Optional search path argument: `ace-search "pattern" [SEARCH_PATH]` to limit scope when needed
+- SearchPathResolver atom with 4-step resolution: explicit path → PROJECT_ROOT_PATH env → project root detection → current directory fallback
+- Support for `PROJECT_ROOT_PATH` environment variable to override project root detection
+- Integration with `Ace::Core::Molecules::ProjectRootFinder` for automatic project root detection
+- Display search path in output context for transparency
+
+### Fixed
+- Fixed search_path propagation through UnifiedSearcher option builders (critical bug)
+- Fixed inconsistent search results when running from different directories
+- Execute ripgrep/fd from search directory using chdir for correct .gitignore processing
+
+### Changed
+- **BEHAVIOR CHANGE**: Default search scope is now project-wide instead of current directory
+  - To maintain old behavior (search current directory only), use: `ace-search "pattern" ./`
+- CLI banner updated to show optional SEARCH_PATH argument: `ace-search [options] PATTERN [SEARCH_PATH]`
+
+### Technical
+- Add comprehensive DEBUG output for troubleshooting search path resolution
+
+## [0.10.0] - 2025-10-14
+
+### Added
+- Standardize Rakefile test commands and add CI fallback
+
+## [0.9.0] - 2025-10-08
+
+### Added
+
+**Core Architecture**
+- Initial release of ace-search gem with full ATOM architecture
+- Complete migration from dev-tools/exe/search to standalone gem
+- Atoms: ripgrep_executor, fd_executor, pattern_analyzer, result_parser, tool_checker
+- Molecules: preset_manager, git_scope_filter, dwim_analyzer, time_filter, fzf_integrator
+- Organisms: unified_searcher, result_formatter, result_aggregator
+- Models: search_result, search_options, search_preset
+
+**CLI Features**
+- Full CLI compatibility with original search tool
+- All search modes: file, content, hybrid with auto-detection (DWIM)
+- Pattern matching: case-insensitive, whole-word, multiline
+- Context options: before, after, and surrounding lines
+- Filtering: glob patterns, include/exclude paths, git scopes (staged/tracked/changed)
+- Output formats: text (with clickable terminal links), JSON, YAML
+- Interactive mode: fzf integration for result selection
+- Time-based filtering: search files modified since/before timestamps
+
+**Configuration System**
+- Integration with ace-core for configuration cascade
+- Support for all CLI flags as configuration defaults in `.ace/search/config.yml`
+- Preset system: organize common searches in `.ace/search/presets/*.yml`
+- Example configuration and presets included in `.ace.example/`
+- Configuration cascade: defaults → global config → project config → preset → CLI flags
+
+**Development Tools**
+- Binstub (`bin/ace-search`) for development use
+- Comprehensive test suite: 43 tests, 158 assertions, 0 failures
+- Flat test structure following ACE patterns (test/atoms/, test/molecules/, etc.)
+- Test runner script for workspace context
+- Integration with ace-test-support
+
+**Documentation**
+- Comprehensive README with usage examples
+- Full usage guide with CLI flag reference
+- Migration guide from dev-tools/exe/search
+- Architecture documentation following ATOM patterns
+- Example configurations and presets
+
+### Changed
+
+**Improvements Over Legacy**
+- File search now matches full paths, not just filenames
+- Configuration supports all CLI flags as defaults (not possible in legacy)
+- Presets organized in separate .yml files for better maintainability
+- Direct ripgrep/fd calls for better performance
+- Clean separation of concerns with ATOM architecture
+
+### Removed
+
+- Editor integration (removed - use terminal's built-in file:line clicking instead)
+- Custom project_root_detector (replaced with ace-core's ConfigDiscovery)
+
+### Fixed
+
+- Pattern analyzer properly detects file globs vs content regex
+- Result parser handles all ripgrep output formats (text, JSON, column numbers)
+- Tool availability checking works across different environments
+
+### Migration Notes
+
+From dev-tools/exe/search (0.8.0):
+- All CLI flags work identically (except editor integration)
+- Use bin/ace-search for development instead of dev-tools/exe/search
+- Configuration moved from custom files to .ace/search/config.yml
+- Presets moved to .ace/search/presets/ directory
+- Performance maintained or improved with direct backend calls
+
+### Dependencies
+
+- ace-core (~> 0.9) for configuration and utilities
+- ripgrep (external) for content search
+- fd (external) for file search
+- fzf (external, optional) for interactive selection
+
+[0.9.0]: https://github.com/cs3b/ace/releases/tag/ace-search-v0.9.0
+
+
+## [0.19.5] - 2026-02-22
+
+### Fixed
+- Standardized quiet, verbose, debug option descriptions to canonical strings

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Michal Czyz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+<div align="center">
+  <h1> ACE - Search </h1>
+
+  Unified codebase search -- one command that auto-detects files or content.
+
+  <img src="https://raw.githubusercontent.com/cs3b/ace/main/docs/brand/AgenticCodingEnvironment.Logo.XS.jpg" alt="ACE Logo" width="480">
+  <br><br>
+
+  <a href="https://rubygems.org/gems/ace-search"><img alt="Gem Version" src="https://img.shields.io/gem/v/ace-search.svg" /></a>
+  <a href="https://www.ruby-lang.org"><img alt="Ruby" src="https://img.shields.io/badge/Ruby-3.2+-CC342D?logo=ruby" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg" /></a>
+
+</div>
+
+> Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.
+
+[Getting Started](docs/getting-started.md) | [Usage Guide](docs/usage.md) | [Handbook - Skills, Agents, Templates](docs/handbook.md)
+
+![ace-search demo](docs/demo/ace-search-getting-started.gif)
+
+`ace-search` gives developers and coding agents a single search entry point that chooses file or content mode automatically (DWIM — Do What I Mean), keeps search scope predictable from any directory, and exposes fast output modes for workflow automation. Use `/as-search-run` for quick searches, `/as-search-research` for multi-search analysis, or `/as-search-feature-research` for implementation gap analysis.
+
+## How It Works
+
+1. Submit a query to [`ace-search`](docs/usage.md) and DWIM detection picks content search (ripgrep) or file search (fd) based on the pattern.
+2. Scope filters like `--staged`, `--tracked`, or `--changed` constrain results to Git-relevant files via [ace-git](../ace-git).
+3. Results are returned in your chosen format (text, JSON, YAML, count, or files-with-matches) for human review or downstream automation.
+
+## Use Cases
+
+**Find code patterns without deciding tooling first** - run `ace-search "TODO"` or `ace-search "*.rb"` and let DWIM detection pick the right backend automatically.
+
+**Constrain investigations to meaningful working sets** - combine `--staged`, `--tracked`, or `--changed` to inspect only [ace-git](../ace-git)-relevant files during reviews and refactors.
+
+**Feed downstream tooling and automation** - use `--json`, `--yaml`, `--count`, or `--files-with-matches` for machine-readable pipelines and scripted checks.
+
+**Standardize repeat searches across teams** - apply named presets with `--preset` via [ace-support-config](../ace-support-config) for consistent daily scans and focused research queries.
+
+**Run multi-search research from an agent** - use `/as-search-research` to execute multiple related searches and synthesize findings, or `/as-search-feature-research` to analyze implementation gaps.
+
+---
+[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/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+desc "Run tests using ace-test"
+task :test do
+  sh "ace-test"
+end
+
+desc "Run tests directly (CI mode)"
+Minitest::TestTask.create(:ci)
+
+task default: :test

data/exe/ace-search

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "ace/support/cli"
+require_relative "../lib/ace/search"
+
+# Start ace-support-cli single-command entrypoint with exception-based exit code handling (per ADR-023)
+begin
+  args = ARGV.empty? ? ["--help"] : ARGV
+  Ace::Support::Cli::Runner.new(Ace::Search::CLI::Commands::Search).call(args: args)
+rescue Ace::Support::Cli::Error => e
+  warn e.message
+  exit(e.exit_code)
+end