firefrost-gaming/skill-seekers-reference
3
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
329 Commits 1 Branch 0 Tags
38e8969ae765d50bc7d0f9ec3ab84ee3d7b8551c
Commit Graph

7 Commits

Author SHA1 Message Date
yusyus
38e8969ae7 feat: Merge PR #249 - Bootstrap skill with fixes and MCP optionality 
Merged PR #249 from @MiaoDX with enhancements:

Bootstrap Feature:
- Self-bootstrap: Generate skill-seekers as Claude Code skill
- Robust frontmatter detection (dynamic line finding)
- SKILL.md validation (YAML + Markdown structure)
- Comprehensive error handling (uv check, permission checks)
- 6 E2E tests with venv isolation

MCP Optionality (User Feature):
- MCP removed from core dependencies
- Optional install: pip install skill-seekers[mcp]
- Lazy loading with helpful error messages
- Interactive setup wizard on first run
- Backward compatible

Bug Fixes:
- Fixed codebase_scraper.py AttributeError (line 1193)
- Fixed test_bootstrap_skill_e2e.py Path vs str issue
- Updated test version expectations to 2.7.0
- Added httpx to core (required for async scraping)
- Added anthropic to core (required for AI enhancement)

Testing:
- 6 new bootstrap E2E tests (all passing)
- 1207/1217 tests passing (99.2% pass rate)
- All bootstrap and enhancement tests pass
- Remaining failures are pre-existing test infrastructure issues

Documentation:
- Updated CHANGELOG.md with v2.7.0 notes
- Updated README.md with bootstrap and installation options
- Added setup wizard guide

Files Modified (9):
- CHANGELOG.md, README.md - Documentation updates
- pyproject.toml - MCP optional, httpx/anthropic core, markers, entry points
- scripts/bootstrap_skill.sh - Dynamic frontmatter, validation, error handling
- src/skill_seekers/cli/install_skill.py - Lazy MCP loading
- tests/test_cli_paths.py - Version 2.7.0
- uv.lock - Dependency updates

New Files (2):
- src/skill_seekers/cli/setup_wizard.py - Interactive installation guide (95 lines)
- tests/test_bootstrap_skill_e2e.py - E2E bootstrap tests (169 lines)

Credits: @MiaoDX for PR #249

Co-Authored-By: MiaoDX <MiaoDX@hotmail.com>
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-17 20:37:30 +03:00
yusyus
58d37c957d test: Update version assertions to 2.5.1 
Fixed test_main_cli_version_output to expect 2.5.1 instead of 2.4.0.

Related: v2.5.1 version bump
 2025-12-30 23:27:18 +03:00
yusyus
9e41094436 feat: v2.4.0 - MCP 2025 upgrade with multi-agent support (#217) 
* feat: v2.4.0 - MCP 2025 upgrade with multi-agent support

Major MCP infrastructure upgrade to 2025 specification with HTTP + stdio
transport and automatic configuration for 5+ AI coding agents.

### 🚀 What's New

**MCP 2025 Specification (SDK v1.25.0)**
- FastMCP framework integration (68% code reduction)
- HTTP + stdio dual transport support
- Multi-agent auto-configuration
- 17 MCP tools (up from 9)
- Improved performance and reliability

**Multi-Agent Support**
- Auto-detects 5 AI coding agents (Claude Code, Cursor, Windsurf, VS Code, IntelliJ)
- Generates correct config for each agent (stdio vs HTTP)
- One-command setup via ./setup_mcp.sh
- HTTP server for concurrent multi-client support

**Architecture Improvements**
- Modular tool organization (tools/ package)
- Graceful degradation for testing
- Backward compatibility maintained
- Comprehensive test coverage (606 tests passing)

### 📦 Changed Files

**Core MCP Server:**
- src/skill_seekers/mcp/server_fastmcp.py (NEW - 300 lines, FastMCP-based)
- src/skill_seekers/mcp/server.py (UPDATED - compatibility shim)
- src/skill_seekers/mcp/agent_detector.py (NEW - multi-agent detection)

**Tool Modules:**
- src/skill_seekers/mcp/tools/config_tools.py (NEW)
- src/skill_seekers/mcp/tools/scraping_tools.py (NEW)
- src/skill_seekers/mcp/tools/packaging_tools.py (NEW)
- src/skill_seekers/mcp/tools/splitting_tools.py (NEW)
- src/skill_seekers/mcp/tools/source_tools.py (NEW)

**Version Updates:**
- pyproject.toml: 2.3.0 → 2.4.0
- src/skill_seekers/cli/main.py: version string updated
- src/skill_seekers/mcp/__init__.py: 2.0.0 → 2.4.0

**Documentation:**
- README.md: Added multi-agent support section
- docs/MCP_SETUP.md: Complete rewrite for MCP 2025
- docs/HTTP_TRANSPORT.md (NEW)
- docs/MULTI_AGENT_SETUP.md (NEW)
- CHANGELOG.md: v2.4.0 entry with migration guide

**Tests:**
- tests/test_mcp_fastmcp.py (NEW - 57 tests)
- tests/test_server_fastmcp_http.py (NEW - HTTP transport tests)
- All existing tests updated and passing (606/606)

### ✅ Test Results

**E2E Testing:**
- Fresh venv installation: ✅
- stdio transport: ✅
- HTTP transport: ✅ (health check, SSE endpoint)
- Agent detection: ✅ (found Claude Code)
- Full test suite: ✅ 606 passed, 152 skipped

**Test Coverage:**
- Core functionality: 100% passing
- Backward compatibility: Verified
- No breaking changes: Confirmed

### 🔄 Migration Path

**Existing Users:**
- Old `python -m skill_seekers.mcp.server` still works
- Existing configs unchanged
- All tools function identically
- Deprecation warnings added (removal in v3.0.0)

**New Users:**
- Use `./setup_mcp.sh` for auto-configuration
- Or manually use `python -m skill_seekers.mcp.server_fastmcp`
- HTTP mode: `--http --port 8000`

### 📊 Metrics

- Lines of code: 2200 → 300 (87% reduction in server.py)
- Tools: 9 → 17 (88% increase)
- Agents supported: 1 → 5 (400% increase)
- Tests: 427 → 606 (42% increase)
- All tests passing: ✅

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Add backward compatibility exports to server.py for tests

Re-export tool functions from server.py to maintain backward compatibility
with test_mcp_server.py which imports from the legacy server module.

This fixes CI test failures where tests expected functions like list_tools()
and generate_config_tool() to be importable from skill_seekers.mcp.server.

All tool functions are now re-exported for compatibility while maintaining
the deprecation warning for direct server execution.

* fix: Export run_subprocess_with_streaming and fix tool schemas for backward compatibility

- Add run_subprocess_with_streaming export from scraping_tools
- Fix tool schemas to include properties field (required by tests)
- Resolves 9 failing tests in test_mcp_server.py

* fix: Add call_tool router and fix test patches for modular architecture

- Add call_tool function to server.py for backward compatibility
- Fix test patches to use correct module paths (scraping_tools instead of server)
- Update 7 test decorators to patch the correct function locations
- Resolves remaining CI test failures

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-26 00:45:48 +03:00
yusyus
9d91bf0b82 test: Update version test to expect 2.2.0 2025-12-22 00:31:02 +03:00
yusyus
a4e5025dd1 test: Update version test to expect 2.1.1 2025-11-30 12:25:55 +03:00
yusyus
ccbf67bb80 test: Fix tests for modern Python packaging structure 
Updated test files to work with new src/ layout and unified CLI:

Fixed Tests (17 tests):
- test_cli_paths.py: Complete rewrite for modern CLI
  * Check for skill-seekers commands instead of python3 cli/
  * Test unified CLI entry points
  * Verify src/ package structure
- test_estimate_pages.py: Update CLI tests for entry points
- test_package_skill.py: Update CLI tests for entry points
- test_upload_skill.py: Update CLI tests for entry points
- test_setup_scripts.py: Update paths for src/skill_seekers/mcp/

Changes:
- Old: Check for python3 cli/*.py commands
- New: Check for skill-seekers subcommands
- Old: Look in cli/ and skill_seeker_mcp/ directories
- New: Look in src/skill_seekers/cli/ and src/skill_seekers/mcp/
- Added FileNotFoundError handling to skip tests if not installed
- Accept exit code 0 or 2 from argparse --help

Results:
- ✅ 381 tests passing (up from 364)
- ✅ 17 tests fixed
- ⚠️ 2 tests flaky (pass individually, fail in full suite)
- ⏭️ 28 tests skipped (MCP server tests - require MCP install)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-10 21:35:44 +03:00
yusyus
c03186574d Add comprehensive CLI path tests and fix remaining issues 
Added 18 new tests covering all aspects of CLI path corrections:
- Docstring/usage examples (5 tests)
- Print statements (3 tests)
- Subprocess calls (1 test)
- Documentation files (3 tests)
- Help output functionality (2 tests)
- Script executability (4 tests)

All tests verify that:
1. Scripts can be executed with cli/ prefix
2. Usage examples show correct paths
3. Print statements guide users correctly
4. No old hardcoded paths remain
5. Documentation is consistent

Fixed additional issues found by tests:
- cli/enhance_skill.py: Fixed 4 more occurrences in docstring and error message
- cli/package_skill.py: Fixed 1 occurrence in help epilog

Test Results:
- Total tests: 118 (100 existing + 18 new)
- All tests passing: 100%
- Coverage: CLI paths, scraper features, config validation, integration, MCP server

Related: PR #145
 2025-10-22 21:45:51 +03:00