ace-bundle 0.40.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 224cd0cec9e0e96eb99b0fa393dfbeeb9807012a5499538c5a55fb5e23e5d714
+  data.tar.gz: 95c22bd2455c263af3be4240a9e918379215f99b17689b44ff1e6acdfe496445
+SHA512:
+  metadata.gz: 65c7f0e6416fa29a473dc9aab623bfa2f79348ea4e4797a5519529a6677061f973368afcdb98ba292cb1007502e514427d5bb9002dc97d27fd48082aa080f4df
+  data.tar.gz: 92e6630b7917e3ba60dd69abef6e01fe4091c2228d93b7603ada68f1cc5920cf6adca53acc7c5690d4428171f7ece6f8533b23847c6afeaf739f3837bdaed803

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

@@ -0,0 +1,28 @@
+# ACE Bundle Configuration
+# Complete default configuration - users only need to override what differs
+# This is the single source of truth for ace-bundle defaults (per ADR-022)
+#
+# To override, create .ace/bundle/config.yml in your project root
+
+bundle:
+  # Cache directory for context output files
+  # Default: .ace-local/bundle (relative to project root)
+  cache_dir: ".ace-local/bundle"
+
+  # Maximum lines per chunk before splitting output into multiple files
+  # Default: 2000 lines
+  max_lines: 2000
+
+  # Auto-format threshold: line count at which output switches from inline to file
+  # When no explicit --output mode is specified:
+  #   - Content below this threshold: displayed inline (stdout)
+  #   - Content at or above this threshold: saved to cache file (path printed)
+  # Default: 500 lines
+  auto_format_threshold: 500
+
+  # Compressor settings
+  # source_scope: off, per-source, merged (default: off)
+  # mode: exact, agent (default: exact)
+  compressor:
+    source_scope: "per-source"
+    mode: "exact"

data/.ace-defaults/bundle/presets/base.md

@@ -0,0 +1,15 @@
+---
+description: Base context with core project files
+bundle:
+  params:
+    output: stdio
+    max_size: 1048576
+    timeout: 30
+  files:
+    - README.md
+    - CHANGELOG.md
+---
+
+# Base Context
+
+This is a minimal base preset that includes only the core project documentation files.

data/.ace-defaults/bundle/presets/code-review.md

@@ -0,0 +1,61 @@
+---
+description: Code review context with section-based organization
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 10485760
+    timeout: 30
+    embed_document_source: true
+
+  sections:
+    focus:
+      title: "Files Under Review"
+      description: "Source files that are being reviewed"
+      files:
+        - "src/**/*.rb"
+        - "lib/**/*.rb"
+        - "test/**/*.rb"
+        - "spec/**/*.rb"
+
+    style:
+      title: "Style Guidelines"
+      description: "Style and coding standards"
+      files:
+        - ".rubocop.yml"
+        - "docs/CODING_STANDARDS.md"
+        - "CONTRIBUTING.md"
+
+    diff:
+      title: "Recent Changes"
+      description: "Recent changes in the codebase"
+      ranges:
+        - "origin/main...HEAD"
+
+    tests:
+      title: "Test Results"
+      description: "Current test results"
+      commands:
+        - "bundle exec rspec --format documentation"
+        - "bundle exec rubocop"
+        - "bundle exec rubycritical"
+
+    bundle:
+      title: "Project Context"
+      description: "Project information and status"
+      commands:
+        - "git log --oneline origin/main..HEAD"
+        - "git status --short"
+        - "pwd"
+        - "ruby -v"
+---
+
+This preset provides a comprehensive code review context organized into logical sections. Each section contains specific information relevant for code review:
+
+- **Focus**: The actual source files being reviewed
+- **Style**: Coding standards and style guidelines
+- **Diff**: Recent changes that prompted the review
+- **Tests**: Current test results and quality checks
+- **Context**: Project information and git status
+
+The sections are prioritized to show the most important information first, with XML-style tags for structured processing.

data/.ace-defaults/bundle/presets/development.md

@@ -0,0 +1,16 @@
+---
+description: Development context extending base with code files
+bundle:
+  presets:
+    - base
+  files:
+    - docs/architecture.md
+    - docs/blueprint.md
+  commands:
+    - git status --short
+    - git branch --show-current
+---
+
+# Development Context
+
+This preset extends the base context with additional development-specific files and git status information.

data/.ace-defaults/bundle/presets/documentation-review.md

@@ -0,0 +1,52 @@
+---
+description: Documentation review with organized sections
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 10485760
+    timeout: 30
+    embed_document_source: true
+
+  sections:
+    content:
+      title: "Documentation Content"
+      description: "Main documentation files being reviewed"
+      files:
+        - "README.md"
+        - "docs/**/*.md"
+        - "CHANGELOG.md"
+
+    style:
+      title: "Style Guidelines"
+      description: "Documentation style and formatting guidelines"
+      files:
+        - "docs/STYLE_GUIDE.md"
+        - "CONTRIBUTING.md"
+        - ".markdownlint.json"
+
+    structure:
+      title: "Documentation Structure"
+      description: "Documentation organization and navigation"
+      files:
+        - "docs/_navigation.yml"
+        - "docs/_toc.yml"
+        - "mkdocs.yml"
+
+    examples:
+      title: "Code Examples"
+      description: "Example code and scripts in documentation"
+      files:
+        - "docs/examples/**/*"
+        - "examples/**/*"
+
+    validation:
+      title: "Validation Results"
+      description: "Documentation validation and linting results"
+      commands:
+        - "markdownlint docs/**/*.md"
+        - "bundle exec yard stats"
+        - "find docs -name '*.md' -exec wc -l {} + | tail -1"
+---
+
+This preset is designed for reviewing documentation with sections covering content, style, structure, examples, and validation. It ensures comprehensive documentation review with organized sections for clarity.

data/.ace-defaults/bundle/presets/mixed-content-example.md

@@ -0,0 +1,94 @@
+---
+description: Example showing mixed content and presets in a single section
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 10485760
+    timeout: 30
+    embed_document_source: true
+
+  sections:
+    comprehensive_review:
+      title: "Comprehensive Project Review"
+      description: "Complete review combining presets with mixed content types"
+      presets:
+        - "code-review"
+        - "security-review"
+      files:
+        - "src/**/*.js"
+        - "README.md"
+        - "package.json"
+      commands:
+        - "npm test"
+        - "npm run lint"
+        - "npm audit"
+      diffs:
+        - "origin/main...HEAD"
+      content: |
+        This comprehensive review demonstrates the full power of the section system by combining:
+
+        ## Preset Content
+        - **code-review**: Code analysis patterns and review guidelines
+        - **security-review**: Security scanning and vulnerability assessment
+
+        ## Direct Content
+        - Source files for manual code review
+        - Test execution and quality checks
+        - Security audit and dependency scanning
+        - Recent changes via git diff
+        - Manual analysis notes and observations
+
+        ### Review Focus Areas
+        1. **Code Quality**: Style, patterns, maintainability
+        2. **Security**: Vulnerabilities, dependencies, best practices
+        3. **Performance**: Potential bottlenecks and optimizations
+        4. **Testing**: Coverage and test quality
+        5. **Documentation**: Completeness and accuracy
+
+        The content from presets and direct sources is merged intelligently, with deduplication of files and commands while preserving all relevant information.
+
+    quick_check:
+      title: "Quick Health Check"
+      description: "Lightweight review with minimal presets"
+      presets:
+        - "base"
+      commands:
+        - "npm test"
+        - "npm run build"
+      content: |
+        Quick validation of project health without extensive analysis.
+
+---
+
+This example demonstrates advanced section capabilities:
+
+## Features Demonstrated
+
+1. **Preset-in-Section Integration**
+   - Multiple presets combined within a single section
+   - Preset content merged with direct content
+   - Automatic deduplication of files and commands
+
+2. **Mixed Content Types**
+   - Files, commands, diffs, and content in same section
+   - No content_type or priority fields required
+   - YAML order determines processing sequence
+
+3. **Content Hierarchy**
+   - Preset content provides foundation
+   - Direct content adds project-specific elements
+   - Intelligent merging maintains all relevant information
+
+## Usage
+
+```bash
+# Load comprehensive review with all content
+ace-bundle mixed-content-example
+
+# Content from code-review and security-review presets
+# + local files, commands, diffs, and notes
+# = complete project context
+```
+
+This approach enables modular, reusable context creation while maintaining flexibility for project-specific customization.

data/.ace-defaults/bundle/presets/project-context.md

@@ -0,0 +1,79 @@
+---
+description: Example demonstrating preset-in-section functionality for project context creation
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 10485760
+    timeout: 30
+    embed_document_source: true
+
+  sections:
+    project_context:
+      title: "Complete Project Context"
+      description: "Project context created by combining multiple presets within a single section"
+      presets:
+        - "base"
+        - "development"
+        - "testing"
+      content: |
+        This section demonstrates how presets can be combined within a single section to create comprehensive project context. The files, commands, and configurations from all referenced presets are merged together with the local content.
+
+        This approach enables modular project setup where you can mix and match different preset components:
+
+        - **base**: Core project files and configuration
+        - **development**: Development tools and build commands
+        - **testing**: Test frameworks and validation commands
+
+        The presets are loaded with full composition support, so they can themselves reference other presets, creating a powerful hierarchical context system.
+
+    documentation:
+      title: "Documentation & Guides"
+      description: "Project documentation and usage guides"
+      presets:
+        - "documentation-review"
+      files:
+        - "docs/**/*.md"
+        - "README.md"
+        - "CHANGELOG.md"
+      content: |
+        Project documentation including API guides, user manuals, and development setup instructions.
+
+    deployment:
+      title: "Deployment & Operations"
+      description: "Deployment configuration and operational procedures"
+      files:
+        - "deploy/**/*"
+        - "docker-compose.yml"
+        - ".env.example"
+      commands:
+        - "docker-compose config"
+        - "kubectl apply -f k8s/ --dry-run=client"
+      content: |
+        Deployment configurations and operational procedures for production environments.
+
+---
+
+This preset demonstrates the new preset-in-section functionality that allows you to:
+
+1. **Combine multiple presets within a section** - Reference multiple presets that will be merged together
+2. **Mix presets with local content** - Add files, commands, and content alongside preset references
+3. **Create modular project contexts** - Build complex project setups from reusable preset components
+4. **Maintain section organization** - Keep related content organized in logical sections
+
+### Usage
+
+```bash
+# Load this preset with section-based context
+ace-bundle project-context
+
+# The sections will be processed with all preset content merged in
+```
+
+### Key Features
+
+- **Preset Composition**: Full support for preset composition within sections
+- **Content Merging**: Files, commands, diffs, and content from presets are merged intelligently
+- **Deduplication**: Duplicate files and commands are automatically removed
+- **Error Handling**: Clear error messages for missing or invalid preset references
+- **Backward Compatibility**: Works alongside existing section and preset functionality

data/.ace-defaults/bundle/presets/project.md

@@ -0,0 +1,35 @@
+---
+description: Project-wide context
+bundle:
+  params:
+    output: cache
+    max_size: 10485760
+    timeout: 30
+  embed_document_source: true
+  files:
+    - docs/vision.md
+    - docs/blueprint.md
+    - docs/architecture.md
+    - docs/decisions.md
+    - docs/tools.md
+  commands:
+    - pwd
+    - date
+    - git status --short
+    - ace-taskflow recent --limit 3
+    - ace-taskflow next --limit 3
+    - eza -R -1 -L 2 --git-ignore --absolute $PROJECT_ROOT_PATH
+  # Optional: Include diffs (delegated to ace-git for consistent filtering)
+  # diffs:
+  #   - origin/main...HEAD
+  # Or use ranges with options (respects global .ace/diff/config.yml):
+  # diff:
+  #   ranges:
+  #     - origin/main...HEAD
+  #   paths:
+  #     - "lib/**/*.rb"
+---
+
+# Project Context
+
+You are working on the Coding Agent Workflow Toolkit (Meta) - a comprehensive meta-repository that provides documentation and guidance for setting up AI-assisted development workflow systems.

data/.ace-defaults/bundle/presets/section-example-simple.md

@@ -0,0 +1,27 @@
+---
+description: Simple example showing basic section usage
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    embed_document_source: true
+
+  sections:
+    focus:
+      title: "Main Files"
+      content_type: "files"
+      priority: 1
+      files:
+        - "src/main.js"
+        - "package.json"
+
+    commands:
+      title: "System Info"
+      content_type: "commands"
+      priority: 2
+      commands:
+        - "pwd"
+        - "git status --short"
+---
+
+This is a simple example demonstrating the basic structure of section-based configuration. It shows two sections: one for files and one for commands, each with a title, content type, and priority.

data/.ace-defaults/bundle/presets/security-review.md

@@ -0,0 +1,53 @@
+---
+description: Security-focused review context
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 10485760
+    timeout: 30
+    embed_document_source: true
+
+  sections:
+    vulnerability:
+      title: "Security Analysis"
+      description: "Security vulnerability scans and analysis"
+      commands:
+        - "bundle exec bundler-audit"
+        - "brakeman --quiet"
+        - "semgrep --config=security"
+
+    secrets:
+      title: "Secrets Detection"
+      description: "Scanning for exposed secrets and credentials"
+      commands:
+        - "git-secrets --scan"
+        - "gitleaks detect --verbose"
+
+    dependencies:
+      title: "Dependency Security"
+      description: "Security scan of project dependencies"
+      commands:
+        - "bundle audit"
+        - "echo 'Dependency security check complete'"
+        - "echo 'No vulnerable dependencies found'"
+
+    sensitive:
+      title: "Sensitive Files"
+      description: "Security-sensitive configuration files"
+      files:
+        - "config/initializers/secret_token.rb"
+        - "config/database.yml"
+        - ".env.example"
+        - "config/secrets.yml"
+
+    policies:
+      title: "Security Policies"
+      description: "Security policies and procedures"
+      files:
+        - "SECURITY.md"
+        - "docs/security/**/*"
+        - "policies/security.md"
+---
+
+This security review preset focuses on identifying potential security issues through organized sections covering vulnerability scanning, secrets detection, dependency security, sensitive files, and security policies.

data/.ace-defaults/bundle/presets/simple-project.md

@@ -0,0 +1,43 @@
+---
+description: Simple example of preset-in-section for basic project setup
+bundle:
+  params:
+    output: stdio
+    format: markdown-xml
+    max_size: 5242880
+    timeout: 15
+
+  sections:
+    project_files:
+      title: "Project Source Code"
+      description: "Core project files and configuration"
+      presets:
+        - "base"
+      files:
+        - "src/**/*.rb"
+        - "lib/**/*.rb"
+        - "config/**/*.yml"
+      content: |
+        Main application source code and configuration files.
+        This combines the base preset with project-specific files.
+
+    testing:
+      title: "Testing Setup"
+      description: "Test framework and test files"
+      presets:
+        - "testing"
+      commands:
+        - "bundle exec rspec --format documentation"
+        - "bundle exec rubocop"
+      content: |
+        Test execution and code quality checks for the project.
+
+---
+
+This example shows a simple use case where:
+
+1. **project_files section** combines the "base" preset with additional project files
+2. **testing section** includes the "testing" preset plus custom test commands
+3. Each section maintains its own focus while leveraging preset content
+
+The presets provide common functionality while allowing section-specific customization.

data/.ace-defaults/bundle/presets/team.md

@@ -0,0 +1,18 @@
+---
+description: Team context with extended timeout for CI environments
+bundle:
+  presets:
+    - development
+  params:
+    timeout: 120
+    output: cache
+  files:
+    - docs/decisions.md
+  commands:
+    - date
+    - pwd
+---
+
+# Team Context
+
+This preset extends development context with team-specific configuration including longer timeouts for CI environments and decision documentation.

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

@@ -0,0 +1,19 @@
+---
+# WFI Sources Protocol Configuration for ace-bundle gem
+# This enables workflow discovery from the installed ace-bundle gem
+
+name: ace-bundle
+type: gem
+description: Bundle workflow instructions from ace-bundle 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