claude_swarm 1.0.1 → 1.0.4

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.4
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -141,18 +141,44 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".claude/commands/release.md"
+- ".claude/hooks/lint-code-files.rb"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".ruby-version"
 - CHANGELOG.md
 - CLAUDE.md
-- EXAMPLES.md
+- CONTRIBUTING.md
 - LICENSE
 - README.md
 - RELEASING.md
 - Rakefile
+- analyze_coverage.rb
 - claude-sdk-docs.md
+- docs-team-swarm.yml
+- docs/v2/CHANGELOG.swarm_cli.md
+- docs/v2/CHANGELOG.swarm_memory.md
+- docs/v2/CHANGELOG.swarm_sdk.md
+- docs/v2/README.md
+- docs/v2/guides/claude-code-agents.md
+- docs/v2/guides/complete-tutorial.md
+- docs/v2/guides/getting-started.md
+- docs/v2/guides/memory-adapters.md
+- docs/v2/guides/plugins.md
+- docs/v2/guides/quick-start-cli.md
+- docs/v2/guides/rails-integration.md
+- docs/v2/guides/swarm-memory.md
+- docs/v2/reference/cli.md
+- docs/v2/reference/ruby-dsl.md
+- docs/v2/reference/yaml.md
 - examples/claude-swarm.yml
+- examples/learning-assistant/assistant.md
+- examples/learning-assistant/example-memories/concept-example.md
+- examples/learning-assistant/example-memories/experience-example.md
+- examples/learning-assistant/example-memories/fact-example.md
+- examples/learning-assistant/example-memories/memory-index.md
+- examples/learning-assistant/example-memories/skill-example.md
+- examples/learning-assistant/learning_assistant.rb
+- examples/learning-assistant/learning_assistant.yml
 - examples/microservices-team.yml
 - examples/mixed-provider-swarm.yml
 - examples/monitoring-demo.yml
@@ -160,8 +186,59 @@ files:
 - examples/session-restoration-demo.yml
 - examples/simple-session-hook-swarm.yml
 - examples/test-generation.yml
+- examples/v2/dsl/01_basic.rb
+- examples/v2/dsl/02_core_parameters.rb
+- examples/v2/dsl/03_capabilities.rb
+- examples/v2/dsl/04_llm_parameters.rb
+- examples/v2/dsl/05_advanced_flags.rb
+- examples/v2/dsl/06_permissions.rb
+- examples/v2/dsl/07_mcp_server.rb
+- examples/v2/dsl/08_swarm_hooks.rb
+- examples/v2/dsl/09_agent_hooks.rb
+- examples/v2/dsl/10_all_agents_hooks.rb
+- examples/v2/dsl/11_delegation.rb
+- examples/v2/dsl/12_complete_integration.rb
+- examples/v2/file_tools_swarm.yml
+- examples/v2/hooks/01_basic_hooks.rb
+- examples/v2/hooks/02_usage_tracking.rb
+- examples/v2/hooks/03_production_monitoring.rb
+- examples/v2/hooks/agent_stop_exit_0.yml
+- examples/v2/hooks/agent_stop_exit_1.yml
+- examples/v2/hooks/agent_stop_exit_2.yml
+- examples/v2/hooks/multiple_hooks_all_pass.yml
+- examples/v2/hooks/multiple_hooks_first_fails.yml
+- examples/v2/hooks/multiple_hooks_second_fails.yml
+- examples/v2/hooks/multiple_hooks_warnings.yml
+- examples/v2/hooks/post_tool_use_exit_0.yml
+- examples/v2/hooks/post_tool_use_exit_1.yml
+- examples/v2/hooks/post_tool_use_exit_2.yml
+- examples/v2/hooks/post_tool_use_multi_matcher_exit_0.yml
+- examples/v2/hooks/post_tool_use_multi_matcher_exit_1.yml
+- examples/v2/hooks/post_tool_use_multi_matcher_exit_2.yml
+- examples/v2/hooks/pre_tool_use_exit_0.yml
+- examples/v2/hooks/pre_tool_use_exit_1.yml
+- examples/v2/hooks/pre_tool_use_exit_2.yml
+- examples/v2/hooks/pre_tool_use_multi_matcher_exit_0.yml
+- examples/v2/hooks/pre_tool_use_multi_matcher_exit_1.yml
+- examples/v2/hooks/pre_tool_use_multi_matcher_exit_2.yml
+- examples/v2/hooks/swarm_summary.sh
+- examples/v2/hooks/user_prompt_exit_0.yml
+- examples/v2/hooks/user_prompt_exit_1.yml
+- examples/v2/hooks/user_prompt_exit_2.yml
+- examples/v2/hooks/validate_bash.rb
+- examples/v2/multi_directory_permissions.yml
+- examples/v2/node_context_demo.rb
+- examples/v2/node_workflow.rb
+- examples/v2/path_resolution_demo.rb
+- examples/v2/simple-swarm-v2.rb
+- examples/v2/simple-swarm-v2.yml
+- examples/v2/swarm.yml
+- examples/v2/swarm_with_hooks.yml
+- examples/v2/swarm_with_hooks_simple.yml
+- examples/v2/think_tool_demo.rb
 - examples/with-before-commands.yml
 - exe/claude-swarm
+- exe/swarm
 - lib/claude_swarm.rb
 - lib/claude_swarm/base_executor.rb
 - lib/claude_swarm/claude_code_executor.rb
@@ -188,15 +265,181 @@ files:
 - lib/claude_swarm/tools/task_tool.rb
 - lib/claude_swarm/version.rb
 - lib/claude_swarm/worktree_manager.rb
+- lib/claude_swarm/yaml_loader.rb
+- lib/swarm_cli.rb
+- lib/swarm_cli/cli.rb
+- lib/swarm_cli/command_registry.rb
+- lib/swarm_cli/commands/mcp_serve.rb
+- lib/swarm_cli/commands/mcp_tools.rb
+- lib/swarm_cli/commands/migrate.rb
+- lib/swarm_cli/commands/run.rb
+- lib/swarm_cli/config_loader.rb
+- lib/swarm_cli/formatters/human_formatter.rb
+- lib/swarm_cli/formatters/json_formatter.rb
+- lib/swarm_cli/interactive_repl.rb
+- lib/swarm_cli/mcp_serve_options.rb
+- lib/swarm_cli/mcp_tools_options.rb
+- lib/swarm_cli/migrate_options.rb
+- lib/swarm_cli/migrator.rb
+- lib/swarm_cli/options.rb
+- lib/swarm_cli/ui/components/agent_badge.rb
+- lib/swarm_cli/ui/components/content_block.rb
+- lib/swarm_cli/ui/components/divider.rb
+- lib/swarm_cli/ui/components/panel.rb
+- lib/swarm_cli/ui/components/usage_stats.rb
+- lib/swarm_cli/ui/formatters/cost.rb
+- lib/swarm_cli/ui/formatters/number.rb
+- lib/swarm_cli/ui/formatters/text.rb
+- lib/swarm_cli/ui/formatters/time.rb
+- lib/swarm_cli/ui/icons.rb
+- lib/swarm_cli/ui/renderers/event_renderer.rb
+- lib/swarm_cli/ui/state/agent_color_cache.rb
+- lib/swarm_cli/ui/state/depth_tracker.rb
+- lib/swarm_cli/ui/state/spinner_manager.rb
+- lib/swarm_cli/ui/state/usage_tracker.rb
+- lib/swarm_cli/version.rb
+- lib/swarm_memory.rb
+- lib/swarm_memory/adapters/base.rb
+- lib/swarm_memory/adapters/filesystem_adapter.rb
+- lib/swarm_memory/chat_extension.rb
+- lib/swarm_memory/cli/commands.rb
+- lib/swarm_memory/core/entry.rb
+- lib/swarm_memory/core/frontmatter_parser.rb
+- lib/swarm_memory/core/metadata_extractor.rb
+- lib/swarm_memory/core/path_normalizer.rb
+- lib/swarm_memory/core/semantic_index.rb
+- lib/swarm_memory/core/storage.rb
+- lib/swarm_memory/core/storage_read_tracker.rb
+- lib/swarm_memory/dsl/builder_extension.rb
+- lib/swarm_memory/dsl/memory_config.rb
+- lib/swarm_memory/embeddings/embedder.rb
+- lib/swarm_memory/embeddings/informers_embedder.rb
+- lib/swarm_memory/errors.rb
+- lib/swarm_memory/integration/cli_registration.rb
+- lib/swarm_memory/integration/configuration.rb
+- lib/swarm_memory/integration/registration.rb
+- lib/swarm_memory/integration/sdk_plugin.rb
+- lib/swarm_memory/optimization/analyzer.rb
+- lib/swarm_memory/optimization/defragmenter.rb
+- lib/swarm_memory/prompts/memory.md.erb
+- lib/swarm_memory/prompts/memory_assistant.md.erb
+- lib/swarm_memory/prompts/memory_researcher.md.erb
+- lib/swarm_memory/prompts/memory_retrieval.md.erb
+- lib/swarm_memory/search/semantic_search.rb
+- lib/swarm_memory/search/text_search.rb
+- lib/swarm_memory/search/text_similarity.rb
+- lib/swarm_memory/skills/meta/deep-learning.md
+- lib/swarm_memory/skills/meta/deep-learning.yml
+- lib/swarm_memory/tools/load_skill.rb
+- lib/swarm_memory/tools/memory_defrag.rb
+- lib/swarm_memory/tools/memory_delete.rb
+- lib/swarm_memory/tools/memory_edit.rb
+- lib/swarm_memory/tools/memory_glob.rb
+- lib/swarm_memory/tools/memory_grep.rb
+- lib/swarm_memory/tools/memory_multi_edit.rb
+- lib/swarm_memory/tools/memory_read.rb
+- lib/swarm_memory/tools/memory_write.rb
+- lib/swarm_memory/utils.rb
+- lib/swarm_memory/version.rb
+- lib/swarm_sdk.rb
+- lib/swarm_sdk/agent/RETRY_LOGIC.md
+- lib/swarm_sdk/agent/builder.rb
+- lib/swarm_sdk/agent/chat.rb
+- lib/swarm_sdk/agent/chat/context_tracker.rb
+- lib/swarm_sdk/agent/chat/hook_integration.rb
+- lib/swarm_sdk/agent/chat/logging_helpers.rb
+- lib/swarm_sdk/agent/chat/system_reminder_injector.rb
+- lib/swarm_sdk/agent/context.rb
+- lib/swarm_sdk/agent/context_manager.rb
+- lib/swarm_sdk/agent/definition.rb
+- lib/swarm_sdk/claude_code_agent_adapter.rb
+- lib/swarm_sdk/configuration.rb
+- lib/swarm_sdk/context_compactor.rb
+- lib/swarm_sdk/context_compactor/metrics.rb
+- lib/swarm_sdk/context_compactor/token_counter.rb
+- lib/swarm_sdk/hooks/adapter.rb
+- lib/swarm_sdk/hooks/context.rb
+- lib/swarm_sdk/hooks/definition.rb
+- lib/swarm_sdk/hooks/error.rb
+- lib/swarm_sdk/hooks/executor.rb
+- lib/swarm_sdk/hooks/registry.rb
+- lib/swarm_sdk/hooks/result.rb
+- lib/swarm_sdk/hooks/shell_executor.rb
+- lib/swarm_sdk/hooks/tool_call.rb
+- lib/swarm_sdk/hooks/tool_result.rb
+- lib/swarm_sdk/log_collector.rb
+- lib/swarm_sdk/log_stream.rb
+- lib/swarm_sdk/markdown_parser.rb
+- lib/swarm_sdk/model_aliases.json
+- lib/swarm_sdk/models.json
+- lib/swarm_sdk/models.rb
+- lib/swarm_sdk/node/agent_config.rb
+- lib/swarm_sdk/node/builder.rb
+- lib/swarm_sdk/node/transformer_executor.rb
+- lib/swarm_sdk/node_context.rb
+- lib/swarm_sdk/node_orchestrator.rb
+- lib/swarm_sdk/permissions/config.rb
+- lib/swarm_sdk/permissions/error_formatter.rb
+- lib/swarm_sdk/permissions/path_matcher.rb
+- lib/swarm_sdk/permissions/validator.rb
+- lib/swarm_sdk/permissions_builder.rb
+- lib/swarm_sdk/plugin.rb
+- lib/swarm_sdk/plugin_registry.rb
+- lib/swarm_sdk/prompts/base_system_prompt.md.erb
+- lib/swarm_sdk/providers/openai_with_responses.rb
+- lib/swarm_sdk/result.rb
+- lib/swarm_sdk/swarm.rb
+- lib/swarm_sdk/swarm/agent_initializer.rb
+- lib/swarm_sdk/swarm/all_agents_builder.rb
+- lib/swarm_sdk/swarm/builder.rb
+- lib/swarm_sdk/swarm/mcp_configurator.rb
+- lib/swarm_sdk/swarm/tool_configurator.rb
+- lib/swarm_sdk/tools/bash.rb
+- lib/swarm_sdk/tools/clock.rb
+- lib/swarm_sdk/tools/delegate.rb
+- lib/swarm_sdk/tools/document_converters/base_converter.rb
+- lib/swarm_sdk/tools/document_converters/docx_converter.rb
+- lib/swarm_sdk/tools/document_converters/html_converter.rb
+- lib/swarm_sdk/tools/document_converters/pdf_converter.rb
+- lib/swarm_sdk/tools/document_converters/xlsx_converter.rb
+- lib/swarm_sdk/tools/edit.rb
+- lib/swarm_sdk/tools/glob.rb
+- lib/swarm_sdk/tools/grep.rb
+- lib/swarm_sdk/tools/image_extractors/docx_image_extractor.rb
+- lib/swarm_sdk/tools/image_extractors/pdf_image_extractor.rb
+- lib/swarm_sdk/tools/image_formats/tiff_builder.rb
+- lib/swarm_sdk/tools/multi_edit.rb
+- lib/swarm_sdk/tools/path_resolver.rb
+- lib/swarm_sdk/tools/read.rb
+- lib/swarm_sdk/tools/registry.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_list.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_read.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_write.rb
+- lib/swarm_sdk/tools/stores/read_tracker.rb
+- lib/swarm_sdk/tools/stores/scratchpad_storage.rb
+- lib/swarm_sdk/tools/stores/storage.rb
+- lib/swarm_sdk/tools/stores/todo_manager.rb
+- lib/swarm_sdk/tools/think.rb
+- lib/swarm_sdk/tools/todo_write.rb
+- lib/swarm_sdk/tools/web_fetch.rb
+- lib/swarm_sdk/tools/write.rb
+- lib/swarm_sdk/utils.rb
+- lib/swarm_sdk/version.rb
+- llm.v2.txt
 - llms.txt
+- rubocop/cop/security/no_reflection_methods.rb
+- rubocop/cop/security/no_ruby_llm_logger.rb
 - single.yml
+- swarm_cli.gemspec
+- swarm_memory.gemspec
+- swarm_sdk.gemspec
 - team.yml
-- team_v2.yml
+- team_full.yml
+- team_sdk.yml
 homepage: https://github.com/parruda/claude-swarm
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/parruda/claude-swarm
   source_code_uri: https://github.com/parruda/claude-swarm
   changelog_uri: https://github.com/parruda/claude-swarm/blob/main/CHANGELOG.md
 rdoc_options: []
@@ -213,7 +456,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Orchestrate multiple Claude Code instances as a collaborative AI development
   team

data/EXAMPLES.md

@@ -1,164 +0,0 @@
-## Draft use case
-
-Imagine you're working in the storefront-web repository. Page load times doubled yesterday. You're not sure why. 
-
-To investigate today you'd use a generalized Claude. It has access to dozens of MCP tools. Tools to read data from BigQuery. Tools to crawl repositories. Tools to checkout code it needs. Tools for GitHub interactions. Tools for Kafka. Tools for file operations.
-
-You need to query BigQuery to pinpoint when the performance degraded. You also need to check recent gem upgrades. But Claude doesn't know which gem repositories to look at. You have to provide context about where to find gem source code. You have to guide it through vendor directories or gem installation paths.
-
-Claude might be able to do this. But with dozens of MCP tools loaded and lots of context it can be overwhelmed and unfocused. It struggles to pick the right tools. It struggles to understand which repos to read. It struggles to keep context in mind while switching between data analysis and code exploration.
-
-## Enter Claude-Swarm
-
-```
-Without Swarm:                         With Claude-Swarm:
-                                      
-┌──────────────────────────────┐       ┌─────────────────────────────────┐
-│           You                │       │            You                  │
-└──────────────┬───────────────┘       └──────────────┬──────────────────┘
-               │                                      │
-               v                                      v
-┌──────────────────────────────┐       ┌─────────────────────────────────┐
-│     Generalized Claude       │       │         Coordinator             │
-│                              │       │                                 │
-│ [30+ MCP Tools]              │       │      [Task delegation]          │
-│ • BigQuery tools             │       └──────────────┬──────────────────┘
-│ • File tools                 │                      │
-│ • Git tools                  │       ┌──────────────┼──────────────────┐
-│ • GitHub tools               │       │              │                  │
-│ • Kafka tools                │       v              v                  v
-│ • ...                        │     ┌────────┐  ┌────────┐    ┌────────┐
-│                              │     │Data    │  │Code    │    │PR      │
-│ Overwhelmed &                │     │Expert  │  │Expert  │    │Expert  │
-│ Context switching            │     │[BQ]    │  │[Files] │    │[GitHub]│
-└──────────────────────────────┘     └────────┘  └────────┘    └────────┘
-```
-
-Claude-swarm is one AI that can hire specialist AIs. Each specialist lives in one domain. You talk to the manager not the specialists. Manager coordinates and gives you answers.
-
-It's NOT multiple AIs running at once. It's ONE AI with "summon expert" superpowers. Experts appear and answer questions. Then they disappear.
-
-## Three Key Features
-
-### Domain Isolation
-- Data expert can pull BigQuery and performance metrics
-- Code expert lives in gem source directory
-- PR Expert only cares about writing a quality PR
-- Each expert focused on their domain. Each expert with custom context and prompts.
-
-### Selective Tool Access
-- Data expert ONLY gets BigQuery and Kafka tools (prompt it with best practices and context for querying)
-- Code expert ONLY gets file and git tools. It instantiates in a specific repo (Prompt it and provide it special context)
-- PR expert ONLY gets PR/GH tools. Can prompt it with best practices for PR submissions/context
-
-### Coordinated Intelligence
-- You ask one question
-- Get answers from multiple domains, each with specialized context and prompts
-- "Why are pages loading slowly?"
-- Data expert finds timing spike at 2pm yesterday
-- Code expert finds the problem
-- Code expert fixes the problem
-- PR Expert creates the PR with your specifications
-
-## Example Configuration
-
-```yaml
-version: 1
-swarm:
-  name: "Performance Investigation"
-  main: coordinator
-  instances:
-    coordinator:
-      description: "Lead developer coordinating performance investigation"
-      directory: ~/storefront-web
-      connections: [data_expert, code_expert, pr_expert]
-      prompt: |
-        You are a senior lead developer coordinating a performance investigation team.
-        Your role is to delegate tasks to specialists and synthesize their findings.
-        
-        When investigating performance issues:
-        1. Start with data_expert to identify when/where problems occurred
-        2. Use code_expert to analyze code changes and identify root causes
-        3. Use pr_expert to implement fixes via pull requests
-        
-        Always provide clear, actionable summaries to the user.
-      
-    data_expert:
-      description: "Analyzes performance metrics and data"
-      directory: ~/analysis
-      tools: [data_mcp_portal_find_tables, data_mcp_portal_query]
-      prompt: |
-        You are a data analyst specializing in web performance metrics.
-        You have access to BigQuery and performance monitoring data.
-        
-        When analyzing performance issues:
-        - Always use partition filters (date-based) to limit query scope
-        - Look for correlations between timing spikes and deployments
-        - Focus on p95/p99 latencies, not just averages
-        - Identify affected user segments and geographic regions
-        
-        Provide specific timestamps and quantified impact metrics.
-      
-    code_expert:
-      description: "Analyzes code, dependencies, and implementations"
-      directory: ~/gems/http-client
-      tools: [read, grep, glob, git]
-      prompt: |
-        You are a senior Ruby developer specializing in performance optimization.
-        You work primarily with gems, dependencies, and low-level implementations.
-        
-        When investigating performance issues:
-        - Check recent version changes in Gemfile.lock
-        - Look for connection pooling, caching, and resource management patterns
-        - Identify blocking I/O operations and inefficient algorithms
-        - Consider memory allocation and garbage collection impacts
-        
-        Focus on actionable code-level fixes and configuration changes.
-        
-    pr_expert:
-      description: "Creates high-quality pull requests"
-      directory: ~/storefront-web
-      tools: [read, write, gh_cli, git]
-      prompt: |
-        You are a senior developer focused on creating excellent pull requests.
-        
-        For performance fixes:
-        - Write clear, specific titles: "Fix: Enable HTTP connection pooling for 40% latency reduction"
-        - Include before/after performance metrics in description
-        - Add links to supporting data analysis
-        - Include deployment considerations and rollback plans
-        - Add relevant reviewers based on affected systems
-        
-        Always follow the team's PR template and coding standards.
-```
-
-## Investigation and Fix Flow
-
-**You:** "Why are pages loading slowly?"
-
-**Coordinator asks data_expert:** "When did latency spike and what's the impact?"
-
-**Data expert:** 
-```sql
--- Query shows latency spike at 2:15 PM yesterday
--- P95 response time increased from 250ms to 890ms
--- Affecting 15% of traffic, primarily checkout flows
-```
-
-**Coordinator asks code_expert:** "What changed around 2:15 PM yesterday that could cause this?"
-
-**Code expert:** 
-```ruby
-# Gemfile.lock shows http-client gem updated from 3.1.9 to 3.2.0 at 2:14 PM
-# Version 3.2.0 changelog: "Removed automatic connection pooling for thread safety"
-# Now creates new HTTP connection per request instead of reusing connections
-```
-
-**Coordinator:** "The http-client gem update removed connection pooling, causing 3x latency increase during checkout."
-
-**You:** "Fix this and create a PR"
-
-**Code expert:** "Two options: downgrade to 3.1.9 or configure explicit pooling with `pool_size: 10` in initializer"
-
-**PR expert:** "Created PR #1234: 'Fix: Enable HTTP connection pooling for 40% latency reduction' with performance benchmarks and rollback plan"
-