Commit Graph

26 Commits

Author SHA1 Message Date
yusyus
4683087af7 chore: remove stale planning, QA, and release markdown files
Deleted 46 files that were internal development artifacts:
- PHASE*_COMPLETION_SUMMARY.md (5 files)
- QA_*.md / COMPREHENSIVE_QA_REPORT.md (8 files)
- RELEASE_PLAN*.md / RELEASE_*_SUMMARY.md / RELEASE_*_CHECKLIST.md (8 files)
- CLI_REFACTOR_*.md (3 files)
- V3_*.md (3 files)
- ALL_PHASES_COMPLETION_SUMMARY.md, BUGFIX_SUMMARY.md, DEV_TO_POST.md,
  ENHANCEMENT_WORKFLOW_SYSTEM.md, FINAL_STATUS.md, KIMI_QA_FIXES_SUMMARY.md,
  TEST_RESULTS_SUMMARY.md, UI_INTEGRATION_GUIDE.md,
  UNIFIED_CREATE_IMPLEMENTATION_SUMMARY.md, WEBSITE_HANDOFF_V3.md,
  WORKFLOW_ENHANCEMENT_SEQUENTIAL_EXECUTION.md, CLI_OPTIONS_COMPLETE_LIST.md
- docs/COMPREHENSIVE_QA_REPORT.md, docs/FINAL_QA_VERIFICATION.md,
  docs/QA_FIXES_*.md, docs/WEEK2_TESTING_GUIDE.md
- .github/ISSUES_TO_CREATE.md, .github/PROJECT_BOARD_SETUP.md,
  .github/SETUP_GUIDE.md, .github/SETUP_INSTRUCTIONS.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-18 22:09:47 +03:00
yusyus
aa952aff81 ci: Update setup-python to v5 and add Python version verification 2026-02-08 23:24:37 +03:00
yusyus
8b3f31409e fix: Enforce min_chunk_size in RAG chunker
- Filter out chunks smaller than min_chunk_size (default 100 tokens)
- Exception: Keep all chunks if entire document is smaller than target size
- All 15 tests passing (100% pass rate)

Fixes edge case where very small chunks (e.g., 'Short.' = 6 chars) were
being created despite min_chunk_size=100 setting.

Test: pytest tests/test_rag_chunker.py -v
2026-02-07 20:59:03 +03:00
yusyus
2d038e25c0 ci: Add PyPI publishing to release workflow
- Build package with uv
- Publish to PyPI using UV_PUBLISH_TOKEN secret
- Automates PyPI release alongside GitHub release
2026-02-01 17:31:18 +03:00
yusyus
97272a8989 ci: Fix release workflow - install uv and initialize submodules
Fixes release build failures:

1. Install uv for bootstrap skill tests
   - Added step to install uv from astral.sh
   - Fixes 7 bootstrap test failures (test_bootstrap_skill*.py)

2. Initialize git submodules
   - Added 'submodules: recursive' to checkout action
   - Fixes test_cli_all_flag_lists_configs (needs configs submodule)

This ensures all 1200+ tests pass in release builds.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-18 14:22:10 +03:00
yusyus
5d1a84d100 fix: Correct uv installation PATH in CI workflow
The uv installer puts the binary in ~/.local/bin but the workflow was
adding ~/.cargo/bin to PATH, causing 'uv: command not found' errors.

Fixed bootstrap E2E tests failing on Python 3.10 and 3.11.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:29:32 +03:00
yusyus
d81a5a8080 fix: Install ruff and mypy explicitly in lint CI job
The lint job was failing with 'ruff: command not found' because
dependency-groups in pyproject.toml require newer pip/setuptools to work.

Install ruff and mypy directly before installing the package to ensure
they're available for the linting steps.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:23:34 +03:00
yusyus
b837244e42 ci: Add ruff and mypy code quality checks to GitHub Actions
Completes issue #250 by adding automated code quality checks to CI.

New 'lint' job runs before tests with:
- Ruff linter (ruff check) - catches code smells and errors
- Ruff formatter (ruff format --check) - ensures consistent formatting
- Mypy type checker - validates type annotations

Configuration:
- Runs on ubuntu-latest with Python 3.12
- Uses existing ruff/mypy config from pyproject.toml (PR #251)
- Mypy continues on error (gradual typing adoption)
- Both lint and test jobs must pass for PR approval

Benefits:
- Enforces code quality standards automatically
- Catches formatting issues before code review
- Prevents regressions in code style
- Complements existing test suite

Related:
- Issue #250 (request for linters)
- PR #251 (added ruff/mypy config and formatted codebase)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:46:04 +03:00
yusyus
6244c41ac0 ci: Add uv installation to GitHub Actions workflow
Fix bootstrap test failures in CI by installing uv package manager.

The bootstrap script (scripts/bootstrap_skill.sh) requires uv to run,
which was causing 7 bootstrap E2E tests to fail in CI with:
  'uv: command not found'

Changes:
- Install uv via official installer (works on Ubuntu & macOS)
- Add uv to PATH for subsequent steps

This resolves the failing tests from PR #251 merge.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:11:15 +03:00
yusyus
f4d427b0e8 ci: Initialize git submodules in GitHub Actions workflow
Fix test failure for test_cli_all_flag_lists_configs by ensuring
api/configs_repo submodule is initialized during checkout.

The test expects configs in api/configs_repo/official/ but the
submodule was not being initialized, causing the directory to be
empty and the test to fail.

Related:
- Commit 1cbb8fe: Added api/configs_repo as git submodule
- Commit f5f37f6: Updated render.yaml for Render deployment

This completes the submodule integration for both:
- Production (Render API deployment)
- CI/CD (GitHub Actions tests)

Fixes: FAILED tests/test_estimate_pages.py::TestEstimatePagesCLI::test_cli_all_flag_lists_configs
2026-01-14 23:25:39 +03:00
yusyus
998be0d2dd fix: Update setup_mcp.sh for v2.0.0 src/ layout + test fixes (#201)
Merges setup_mcp.sh fix for v2.0.0 src/ layout + test updates.

Original fix by @501981732 in PR #197.
Test updates to make CI pass.

Closes #192
2025-11-29 21:34:51 +03:00
yusyus
30d7ff555a fix: Install package in CI for src/ layout compatibility
- Add pip install -e . to install package in editable mode
- Update coverage path from cli/ to src/skill_seekers/
- Required for tests to import skill_seekers module

Fixes CI test failures: ModuleNotFoundError: No module named 'skill_seekers'
2025-11-11 23:14:44 +03:00
yusyus
e6e8db8031 Add GitHub Sponsors button with Buy Me a Coffee
Enables the 'Sponsor' button on the repository with Buy Me a Coffee link.

Link: https://buymeacoffee.com/yusufkaraaslan
2025-10-26 18:45:40 +03:00
yusyus
1bf53423dc Fix Release workflow - use requirements.txt and correct MCP path
- Changed from manual pip install to using requirements.txt
- Fixed mcp/requirements.txt -> skill_seeker_mcp/requirements.txt
- This ensures all dependencies (including httpx) are installed

Fixes the v2.0.0 tag Release workflow failure
2025-10-26 17:48:23 +03:00
yusyus
7a27af99a2 fix: Update GitHub Actions workflow for refactored package structure
Fix test failures in CI by updating dependencies installation:
- Install from requirements.txt (includes httpx for async support)
- Update path: mcp/ → skill_seeker_mcp/
- Fix coverage command to use correct package name

Fixes ModuleNotFoundError: No module named 'httpx' in CI

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 13:21:39 +03:00
yusyus
a0298b884a fix: Add summary job to resolve CI merge blocking issue
Adds 'tests-complete' summary job that:
- Provides single status check for branch protection
- Only passes when all matrix tests succeed
- Fixes "Tests" check always showing as pending
- Resolves PR merge blocking issue

This ensures PRs can auto-merge once all 5 matrix jobs pass.
2025-10-25 14:54:33 +03:00
yusyus
05dc5c1cf6 Update GitHub Actions to use development branch
Changed:
- tests.yml: Run on 'development' instead of 'dev'
- Triggers on push to: main, development
- Triggers on PRs to: main, development

This ensures:
 All PRs to development run tests
 Pushes to development run tests
 Branch protection can require 'Tests' check
 CI works with new two-branch workflow

Related: Two-branch workflow setup

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 23:35:47 +03:00
yusyus
8f062bb96c Fix GitHub Actions release workflow permissions
Problem:
- Release workflow failing with "Resource not accessible by integration"
- Missing permissions for GITHUB_TOKEN to create releases
- Workflow tried to create releases that already exist manually

Fix:
1. Added `permissions: contents: write` at workflow level
   - Grants GITHUB_TOKEN permission to create/edit releases
   - Required for softprops/action-gh-release@v1

2. Added release existence check before creation
   - Prevents errors when release already exists
   - Skips creation gracefully with informative message
   - Useful for manually created releases (like v1.1.0)

Changes:
- Line 8-9: Added permissions section
- Line 48-57: Check if release exists with gh CLI
- Line 59-60: Only create if release doesn't exist
- Line 69-73: Skip message when release already exists

This allows:
- Automatic release creation on new tags
- Manual release creation without workflow conflicts
- Proper error handling and user feedback

Related: GitHub Actions permissions model
https://docs.github.com/en/actions/security-guides/automatic-token-authentication

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 23:13:55 +03:00
yusyus
90449cc86d Add step-by-step project board setup instructions
- Complete checklist for manual setup
- GitHub CLI automation commands
- Label colors and descriptions
- Milestone creation guide
- Issue creation workflow

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 13:40:29 +03:00
yusyus
29a181752a Add GitHub Project Board setup and issue templates
- Add comprehensive PROJECT_BOARD_SETUP.md with 20 issues
- Create 3 milestones: v1.1.0, v1.2.0, v2.0.0
- Add issue templates: feature, bug, documentation
- Add PR template with checklist
- Define labels for priority, type, component, status
- Include setup instructions for web UI and CLI

Features:
- 6-column project board structure
- 20 pre-defined issues covering website, core improvements, advanced features
- Custom fields: Effort, Impact, Category
- Success metrics and community engagement guidelines

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 13:38:13 +03:00
yusyus
b83f276621 Update Python requirement to 3.10+ for MCP compatibility
The MCP package requires Python 3.10 or higher. Updated:
- GitHub Actions workflow to test Python 3.10, 3.11, 3.12
- README.md badge to Python 3.10+
- CLAUDE.md prerequisites
- CONTRIBUTING.md prerequisites
- docs/MCP_SETUP.md prerequisites

This fixes the MCP installation error in CI:
'ERROR: No matching distribution found for mcp>=1.0.0'

MCP package versions 0.9.1+ all require Python 3.10+.
2025-10-19 22:53:28 +03:00
yusyus
9ce78e9a16 Fix GitHub Actions workflow: Update Python version requirements
- Update CI workflow to Python 3.9-3.12 (from 3.7-3.11)
- Python 3.7 and 3.8 no longer available on ubuntu-latest (Ubuntu 24.04)
- Add fail-fast: false to continue testing on failures
- Update all documentation to reflect Python 3.9+ requirement

Files updated:
- .github/workflows/tests.yml - New Python versions
- README.md - Badge updated to Python 3.9+
- CLAUDE.md - Prerequisites updated
- CONTRIBUTING.md - Prerequisites updated
- docs/MCP_SETUP.md - Prerequisites updated

This fixes the failing GitHub Actions tests.
2025-10-19 22:49:14 +03:00
yusyus
517ed46338 Add project infrastructure and documentation
Infrastructure:
- Add GitHub Actions workflows (tests.yml, release.yml)
- Add CHANGELOG.md with full version history
- Add CONTRIBUTING.md with contribution guidelines
- Add RELEASE_NOTES_v1.0.0.md for v1.0.0 release

Documentation:
- Update README.md with version badge (v1.0.0)
- Update test count badge (14 tests)
- Add links to new documentation files

Features:
- CI/CD pipeline with automated testing
- Multi-OS testing (Ubuntu, macOS)
- Multi-Python version testing (3.7-3.11)
- Automated release creation on tag push
- Code coverage reporting

This completes the v1.0.0 production release setup.
2025-10-19 22:37:55 +03:00
yusyus
ba7cacdb4c Fix all test failures and add upper limit validation (100% pass rate!)
**Test Fixes:**
- Fixed 3 failing tests by checking warnings instead of errors
- test_missing_recommended_selectors: now checks warnings
- test_invalid_rate_limit_too_high: now checks warnings
- test_invalid_max_pages_too_high: now checks warnings

**Validation Improvements:**
- Added rate_limit upper limit warning (> 10s)
- Added max_pages upper limit warning (> 10000)
- Helps users avoid extreme values

**Results:**
- Before: 68/71 tests passing (95.8%)
- After: 71/71 tests passing (100%) 

**Planning Files Added:**
- .github/create_issues.sh - Helper for creating issues
- .github/SETUP_GUIDE.md - GitHub setup instructions

Tests now comprehensively cover all validation scenarios including
errors, warnings, and edge cases.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 15:50:25 +03:00
yusyus
23277ded26 Update TODO.md with current sprint tasks and create GitHub issues
**TODO.md Updates:**
- Mark current 4 tasks as STARTED
- Add "In Progress" and "Completed Today" sections
- Document current branch: MCP_refactor
- Clear tracking of sprint progress

**GitHub Issues Created (templates):**
1. Fix 3 test failures (warnings vs errors)
2. Create MCP setup guide for Claude Code
3. Test MCP server with actual Claude Code
4. Update documentation for monorepo structure

**Issue Templates Include:**
- Detailed problem descriptions
- Step-by-step solutions
- Acceptance criteria
- Files to modify
- Test plans

**Next Steps:**
User can create issues via:
- GitHub web UI (copy from ISSUES_TO_CREATE.md)
- GitHub CLI (gh issue create)
- Or work directly from TODO.md

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 15:30:13 +03:00
yusyus
f66718122a Add project planning and roadmap documentation
**Planning Structure:**
- TODO.md - Sprint planning and current tasks
- ROADMAP.md - Long-term vision and milestones
- .github/ISSUE_TEMPLATE/ - Issue templates for features and MCP tools

**TODO.md:**
- 5 phases: Core (done), Enhancement, Advanced, Docs, Integrations
- Current sprint tasks clearly defined
- Progress tracking with checkboxes

**ROADMAP.md:**
- Vision and milestones
- v1.0 (done), v1.1 (in progress), v1.2-3.0 (planned)
- Feature ideas categorized by priority
- Metrics and goals
- Release schedule

**Issue Templates:**
- feature_request.md - General features
- mcp_tool.md - New MCP tools specifically

Next: Fix tests, test MCP with Claude Code, document setup

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 15:23:58 +03:00