mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
74a830694c
Previously, embeddings were only generated for root directory files (1.6% coverage, 5/303 files). This fix implements recursive processing across all subdirectory indexes, achieving 100% coverage with 2,042 semantic chunks across all 303 files in 26 index databases. Key improvements: 1. **Recursive embeddings generation** (embedding_manager.py): - Add generate_embeddings_recursive() to process all _index.db files in directory tree - Add get_embeddings_status() for comprehensive coverage statistics - Add discover_all_index_dbs() helper for recursive file discovery 2. **Enhanced CLI commands** (commands.py): - embeddings-generate: Add --recursive flag for full project coverage - init: Use recursive generation by default for complete indexing - status: Display embeddings coverage statistics with 50% threshold 3. **Smart search routing improvements** (smart-search.ts): - Add 50% embeddings coverage threshold for hybrid mode routing - Auto-fallback to exact mode when coverage insufficient - Strip ANSI color codes from JSON output for correct parsing - Add embeddings_coverage_percent to IndexStatus and SearchMetadata - Provide clear warnings with actionable suggestions 4. **Documentation and analysis**: - Add SMART_SEARCH_ANALYSIS.md with initial investigation - Add SMART_SEARCH_CORRECTED_ANALYSIS.md revealing true extent of issue - Add EMBEDDINGS_FIX_SUMMARY.md with complete fix summary - Add check_embeddings.py script for coverage verification Results: - Coverage improved from 1.6% (5/303 files) to 100% (303/303 files) - 62.5x increase - Semantic chunks increased from 10 to 2,042 - 204x increase - All 26 subdirectory indexes now have embeddings vs just 1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
CCW - Claude Code Workflow CLI
A command-line tool for viewing workflow sessions and code review results from the Claude Code Workflow system.
Installation
# Install globally
npm install -g ccw
# Or install from local source
cd path/to/ccw
npm install
npm link
Usage
View Dashboard
# Open workflow dashboard in browser
ccw view
# Specify project path
ccw view -p /path/to/project
# Generate dashboard without opening browser
ccw view --no-browser
# Custom output path
ccw view -o report.html
Features
Workflow Dashboard
- Active Sessions: View all active workflow sessions with task progress
- Archived Sessions: Browse completed/archived sessions
- Task Tracking: See individual task status (pending/in_progress/completed)
- Progress Bars: Visual progress indicators for each session
Review Integration
- Code Review Findings: View results from
review-module-cycle - Severity Distribution: Critical/High/Medium/Low finding counts
- Dimension Analysis: Findings by review dimension (Security, Architecture, Quality, etc.)
- Tabbed Interface: Switch between Workflow and Reviews tabs
Dashboard Data Sources
The CLI reads data from the .workflow/ directory structure:
.workflow/
├── active/
│ └── WFS-{session-id}/
│ ├── workflow-session.json # Session metadata
│ ├── .task/
│ │ └── IMPL-*.json # Task definitions
│ └── .review/
│ ├── review-progress.json # Review progress
│ └── dimensions/
│ └── *.json # Dimension findings
└── archives/
└── WFS-{session-id}/ # Archived sessions
Bundled Templates
The CLI includes bundled dashboard templates:
workflow-dashboard.html- Workflow session and task visualizationreview-cycle-dashboard.html- Code review findings display
No external template installation required - templates are included in the npm package.
Requirements
- Node.js >= 16.0.0
- npm or yarn
Integration with Claude Code Workflow
This CLI is a standalone tool that works with the Claude Code Workflow system:
-
Install CCW CLI (via npm)
npm install -g ccw- Provides
ccw viewcommand for dashboard viewing - Templates are bundled - no additional installation required
-
Optional: Install Claude Code Workflow (via
Install-Claude.ps1)- Provides workflow commands, agents, and automation
- CCW will automatically detect and display workflow sessions
Options
| Option | Description |
|---|---|
-p, --path <path> |
Path to project directory (default: current directory) |
--no-browser |
Generate dashboard without opening browser |
-o, --output <file> |
Custom output path for HTML file |
-V, --version |
Display version number |
-h, --help |
Display help information |
Development
# Clone and install dependencies
git clone <repo-url>
cd ccw
npm install
# Link for local testing
npm link
# Test the CLI
ccw view -p /path/to/test/project
License
MIT