tegwick a283519ccf feat: Rename status command to stats with comprehensive system statistics
Enhanced the status command by renaming it to 'stats' and implementing dual functionality
following the established *-stats command convention for consistent CLI experience.

## Changes Made:

### 1. Renamed status → stats Command
- Updated CLI command: @cli.command('stats')
- Updated function name: status() → stats()
- Enhanced to follow established subsystem naming convention

### 2. Made file_path Argument Optional
- Changed from required to optional: `@click.argument('file_path', required=False)`
- Added comprehensive format support: table, json, yaml, simple
- Updated help text to show `[FILE_PATH]` indicating optional parameter

### 3. Implemented Core System Statistics
- New function `_show_core_system_stats()` for system-wide monitoring
- Comprehensive statistics collection including:
  * **Database**: File counts, size, recent activity, health status
  * **Cache**: Directory info, cached files, size metrics
  * **System Health**: Overall health percentage, subsystem status
  * **System Info**: Working directory, Python version, execution mode

### 4. Dual Functionality Support
```bash
markitect stats                 # Shows core system statistics
markitect stats file.md         # Shows file-specific status (preserved)
```

### 5. Advanced Health Monitoring
- System health percentage calculation (healthy/total subsystems)
- Visual health indicators:  Healthy, ⚠️ Degraded,  Unavailable
- Detailed subsystem status reporting
- Error handling with graceful degradation

### 6. Rich Output Formats
- **Table**: Visual dashboard with emoji icons and status indicators
- **JSON**: Structured data for programmatic integration
- **YAML**: Human-readable structured format
- **Simple**: Key-value pairs for shell scripting

## Implementation Benefits:

- **System Monitoring**: Single command to check entire MarkiTect system health
- **Consistent CLI**: Now matches ast-stats, cache-stats, db-stats, config-stats pattern
- **Operational Insight**: Database activity, cache performance, system status at a glance
- **Backward Compatible**: All existing file-specific functionality preserved
- **Professional Interface**: Clear visual hierarchy and status communication

The stats command now serves as the primary system health dashboard while maintaining
full backward compatibility for file-specific status checking.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 22:38:47 +02:00

MarkiTect - Advanced Markdown Engine

Your Markdown, Redefined.

MarkiTect transforms markdown from plain text into intelligent, structured data with performance optimization, schema validation, and relational querying capabilities. Stop treating documentation as text files—start managing it as a database.

Key Features:

  • Lightning Performance: 60-85% faster document processing through intelligent AST caching
  • Schema Validation: Enforce document structure and consistency
  • Database Integration: Query markdown content with SQL-like operations
  • CLI Tools: Complete command-line interface for automation and workflows

📚 Documentation

Quick Start: Getting Started · Command Reference

Architecture: Caching System · Performance Philosophy

Development: TDD Workflow · Contributing

Project Status: Current Status · Roadmap · Next Actions

Description
An advanced markdown engine
https://coulomb.social/open/MarkiTect
Readme 34 MiB
2025-11-08 20:34:42 +00:00
Languages
Python 84.7%
JavaScript 8%
HTML 5.6%
Makefile 1.3%
Shell 0.2%
Other 0.1%