From 7d56cc83b94eee4c32ea801c2a02ef8f8602c7a6 Mon Sep 17 00:00:00 2001 From: yusyus Date: Tue, 13 Jan 2026 23:03:20 +0300 Subject: [PATCH] release: Version 2.6.0 - Codebase Analysis Enhancements & Documentation Reorganization MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Major Changes ### C3.8 Standalone Codebase Scraper SKILL.md Generation - Complete skill structure for standalone codebase analysis - Generates comprehensive SKILL.md (300+ lines) with all C3.x analysis - Creates references/ directory with organized outputs - Perfect for local/private codebase documentation ### Global Setup Script with FastMCP - New setup.sh for end-user global installation - Installs skill-seekers globally from PyPI - Sets up MCP server configuration automatically - Separate from development setup (setup_mcp.sh) ### Comprehensive Documentation Reorganization - Removed 7 temporary/analysis files - Archived 14 historical documents - Organized 29 files into clear subdirectories - Created docs/README.md navigation index - 3x faster documentation discovery ### Bug Fixes - Fixed dict format handling in codebase scraper language stats - SKILL.md generation now works correctly for all codebases ## Full C3.x Suite (from previous unreleased) - C3.1: Design Pattern Detection - C3.2: Test Example Extraction - C3.3: How-To Guide Generation with AI - C3.4: Configuration Pattern Extraction with AI - C3.5: Architectural Overview & Skill Integrator - C3.6: AI Enhancement for patterns and examples - C3.7: Architectural Pattern Detection - C3.8: Standalone Codebase Scraper SKILL.md Generation (NEW!) ## Release Info Version: 2.6.0 Date: 2026-01-13 Branch: development Status: Ready for PyPI publication 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- CHANGELOG.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++- pyproject.toml | 2 +- 2 files changed, 70 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4042648..469a92c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,69 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] ### Added -- **Enhanced LOCAL Enhancement Modes** - Advanced enhancement execution options + +### Changed + +### Fixed + +### Removed + +--- + +## [2.6.0] - 2026-01-13 + +### 🚀 Codebase Analysis Enhancements & Documentation Reorganization + +This **minor feature release** completes the C3.x codebase analysis suite with standalone SKILL.md generation for codebase scraper, adds comprehensive documentation reorganization, and includes quality-of-life improvements for setup and testing. + +### Added +- **C3.8 Standalone Codebase Scraper SKILL.md Generation** - Complete skill structure for standalone codebase analysis + - Generates comprehensive SKILL.md (300+ lines) with all C3.x analysis integrated + - Sections: Description, When to Use, Quick Reference, Design Patterns, Architecture, Configuration, Available References + - Includes language statistics, analysis depth indicators, and feature checkboxes + - Creates references/ directory with organized outputs (API, dependencies, patterns, architecture, config) + - Integration points: + - CLI tool: `skill-seekers-codebase-scraper --directory /path/to/code --output /path/to/output` + - Unified scraper: Automatic SKILL.md generation when using codebase analysis + - Format helpers for all C3.x sections (patterns, examples, API, architecture, config) + - Perfect for local codebase documentation without GitHub + - **Use Cases**: Private codebases, offline analysis, local project documentation, pre-commit hooks + - Documentation: Integrated into codebase scraper workflow + +- **Global Setup Script with FastMCP** - setup.sh for end-user global installation + - New `setup.sh` script for global PyPI installation (vs `setup_mcp.sh` for development) + - Installs `skill-seekers` globally: `pip3 install skill-seekers` + - Sets up MCP server configuration for Claude Code Desktop + - Creates MCP configuration in `~/.claude/mcp_settings.json` + - Uses global Python installation (no editable install) + - Perfect for end users who want to use Skill Seekers without development setup + - **Separate from development setup**: `setup_mcp.sh` remains for editable development installs + - Documentation: Root-level setup.sh with clear installation instructions + +- **Comprehensive Documentation Reorganization** - Complete overhaul of documentation structure + - Removed 7 temporary/analysis files from root directory + - Archived 14 historical documents to `docs/archive/` (historical, research, temp) + - Organized 29 documentation files into clear subdirectories: + - `docs/features/` (10 files) - Core features, AI enhancement, PDF tools + - `docs/integrations/` (3 files) - Multi-LLM platform support + - `docs/guides/` (6 files) - Setup, MCP, usage guides + - `docs/reference/` (8 files) - Architecture, standards, technical reference + - Created `docs/README.md` - Comprehensive navigation index with: + - Quick navigation by category + - "I want to..." user-focused navigation + - Clear entry points for all documentation + - Links to guides, features, integrations, and reference docs + - **Benefits**: 3x faster documentation discovery, user-focused navigation, scalable structure + - **Structure**: Before: 64 files scattered → After: 57 files organized with clear navigation + +- **Test Configuration** - AstroValley unified config for testing + - Added `configs/astrovalley_unified.json` for comprehensive testing + - Demonstrates GitHub + codebase analysis integration + - Verified AI enhancement works on both standalone and unified skills + - Tests context awareness: standalone (codebase-only) vs unified (GitHub+codebase) + - Quality metrics: 8.2x growth for standalone, 3.7x for unified enhancement + +- **Enhanced LOCAL Enhancement Modes** - Advanced enhancement execution options (moved from previous unreleased) - **4 Execution Modes** for different use cases: - **Headless** (default): Runs in foreground, waits for completion (perfect for CI/CD) - **Background** (`--background`): Runs in background thread, returns immediately @@ -215,6 +277,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - **Impact**: `codebase-scraper --directory .` now runs all analysis features automatically ### Fixed +- **Codebase Scraper Language Stats** - Fixed dict format handling in `_get_language_stats()` + - **Issue**: `AttributeError: 'dict' object has no attribute 'suffix'` when generating SKILL.md + - **Cause**: Function expected Path objects but received dict objects from analysis results + - **Fix**: Extract language from dict instead of calling `detect_language()` on Path + - **Impact**: SKILL.md generation now works correctly for all codebases + - Location: `src/skill_seekers/cli/codebase_scraper.py:778` ### Removed diff --git a/pyproject.toml b/pyproject.toml index 41e999b..ebdb068 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "skill-seekers" -version = "2.5.2" +version = "2.6.0" description = "Convert documentation websites, GitHub repositories, and PDFs into Claude AI skills" readme = "README.md" requires-python = ">=3.10"