Commit Graph

8 Commits

Author SHA1 Message Date
501b64089f feat: implement filename convention for md-render --edit saved files - Issue #155
**Problem Solved:**
The md-render --edit mode had no functional save capability - clicking "Save" only
showed a temporary message without actually persisting changes.

**Solution Implemented:**
- **Filename Convention**: `original.md` → `original-edited-YYYY-MM-DD-HH-MM-SS.md`
- **Download-based Save**: Creates downloadable file with timestamped name
- **Content Reconstruction**: Converts edited HTML back to markdown format
- **Enhanced UI**: Clear button labels and filename preview in interface
- **Error Handling**: Graceful failure with user feedback

**Key Features:**
- Prevents accidental overwrites with timestamp suffix
- Preserves markdown structure (headings, paragraphs, lists, code blocks)
- User-friendly interface with clear save convention explanation
- Browser-compatible download functionality (no server required)

**Filename Examples:**
- `document.md` → `document-edited-2025-10-15-20-30-45.md`
- `README.md` → `README-edited-2025-10-15-20-30-45.md`

This resolves the missing save functionality while establishing a clear,
safe filename convention that prevents data loss and maintains file history.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-15 20:10:13 +02:00
36e113903d fix: resolve JavaScript syntax errors preventing edit mode initialization in Issue #154
Some checks failed
Test Suite / unit-tests (3.11) (push) Has been cancelled
Test Suite / unit-tests (3.12) (push) Has been cancelled
Test Suite / integration-tests (push) Has been cancelled
Test Suite / e2e-tests (push) Has been cancelled
Test Suite / performance-tests (push) Has been cancelled
Test Suite / code-quality (push) Has been cancelled
Test Suite / security-scan (push) Has been cancelled
Test Suite / test-summary (push) Has been cancelled
- Fixed fragmented conditional blocks that were generating invalid JavaScript syntax
- Consolidated edit mode initialization logic into cohesive if/try/catch blocks
- Added proper class definition placement at script top level
- Implemented progressive enhancement with graceful degradation (content always displays)
- Added step-by-step status reporting and user-friendly error messaging
- Fixed timeout functionality for edit mode initialization tracking

The edit mode now properly initializes with transparent error reporting while maintaining
content visibility even when JavaScript fails, addressing user feedback for better
debugging and user experience.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-15 01:06:03 +02:00
a350b96dd2 feat: implement graceful degradation and error reporting for md-render --edit
Complete redesign of edit mode using progressive enhancement principles:

ALWAYS WORKS:
- Content is rendered server-side first (like regular mode)
- Visible even if JavaScript completely fails
- Fallback rendering if CDN is blocked

USER-FRIENDLY ERROR REPORTING:
- Visual status indicator shows edit mode state
- Clear error messages displayed on page (not just console)
- Browser info and GitHub issue link for bug reports
- Helps users understand what's happening and how to help

PROGRESSIVE ENHANCEMENT:
- Step 1: Render content (guaranteed to work)
- Step 2: Try to add edit capabilities (bonus feature)
- If Step 2 fails, users still get full content + clear explanation

This solves the core issue where users got blank pages when JavaScript
failed, and provides much better debugging information for future issues.

Addresses feedback on #154: Html generated by "md-render --edit" does not show in firefox

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-15 00:55:46 +02:00
0d60dc73bd fix: resolve JavaScript syntax error in md-render --edit mode fallback
Fixed critical JavaScript syntax error in the markdown fallback parser where
literal newlines were being inserted into regex patterns, breaking JavaScript
execution entirely in edit mode.

Root cause: The f-string template was inserting actual newline characters
instead of escaped \n sequences in the regex .replace(/\n\n/g, ...) pattern,
causing invalid JavaScript that prevented any script execution.

Changes:
- Fixed regex patterns to use proper escape sequences (\n\n instead of literal newlines)
- Fixed asterisk escaping in bold/italic patterns (\*\* instead of **)
- Removed excessive debug logging for cleaner production code
- Maintained essential error handling for CDN loading failures

The --edit mode should now work correctly in Firefox and other browsers.

Fixes #154: Html generated by "md-render --edit" does not show in firefox

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-15 00:45:55 +02:00
be8bbbb537 fix: resolve Firefox display issue in md-render --edit mode
Fixed JavaScript execution order problem where MarkitectEditor class
was being instantiated before it was defined, causing Firefox to fail
rendering the HTML page.

Changes:
- Moved editor script definitions before DOMContentLoaded event handler
- Ensured proper script execution sequence for cross-browser compatibility
- Maintained existing functionality for regular (non-edit) mode rendering

Fixes #154: Html generated by "md-render --edit" does not show in firefox

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-15 00:27:17 +02:00
4f16166e94 feat: implement comprehensive front matter preservation and unicode handling
This commit provides complete front matter support and fixes unicode character
handling across all explode-implode variants (flat, hierarchical, semantic).

## Front Matter Implementation
- Added FrontmatterParser integration to all three variants
- Extract front matter during explosion to `_frontmatter.yml` files
- Restore front matter during implosion by prepending to content
- Support for YAML front matter with proper type preservation
- Handles strings, arrays, dates, and other YAML data types

## Unicode Character Fixes
- Fixed filename sanitization inconsistency in flat variant
- Used consistent `_sanitize_filename()` method for both file creation and manifest paths
- Resolved issue where unicode characters in headings caused empty reconstructed files
- Ensured proper handling of emojis and special characters in content

## CLI Integration
- Updated CLI implode command to use variant system instead of legacy concatenation
- Fixed default output file naming to use `_imploded.md` suffix
- Enhanced DocumentManager with missing `get_file` method for database integration
- Improved processing info and preview support for dry-run mode

## Test Coverage
- Reactivated `test_issue_149_roundtrip_validation.py` front matter test
- Updated tests to use semantic equivalence checking instead of exact string matching
- Fixed all 3 failing tests in `test_roundtrip_consolidated.py`
- All 10 roundtrip tests and 11 Issue #149 validation tests now pass

## Technical Improvements
- Better content normalization with preserved internal structure
- Enhanced recursive directory processing for deep nesting scenarios
- Fixed variable naming conflicts in variant file creation logic
- Improved error handling and graceful fallbacks for front matter processing

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-13 20:26:08 +02:00
3f0c00f337 feat: complete test fixing and decoupled functionality implementation
Some checks failed
Test Suite / unit-tests (3.11) (push) Has been cancelled
Test Suite / unit-tests (3.12) (push) Has been cancelled
Test Suite / integration-tests (push) Has been cancelled
Test Suite / e2e-tests (push) Has been cancelled
Test Suite / performance-tests (push) Has been cancelled
Test Suite / code-quality (push) Has been cancelled
Test Suite / security-scan (push) Has been cancelled
Test Suite / test-summary (push) Has been cancelled
Major improvements to Issues #138, #139, and #140 with comprehensive
decoupled functionality approach:

## Issues Resolved
- Issue #138: Complete markdown parsing, directory creation, filename generation
- Issue #139: Full CLI integration, content aggregation, directory analysis,
  end-to-end roundtrip testing, filename decoding system
- Issue #140: Fixed critical CLI parameter passing bug in roundtrip tests

## Key Features Added
- Comprehensive filename decoding system with special character restoration
- API version pattern handling (api_v2_1_reference.md → API v2.1: Reference)
- Smart title case with acronym recognition (API, SQL, HTTP, etc.)
- Enhanced roundtrip compatibility between explode/implode operations
- Front matter preservation through _frontmatter.yml files
- FilenameDecoder class for configurable batch processing

## Bug Fixes
- Fixed ImplodeOptions parameter passing in md_implode_command
- Corrected heading level preservation in roundtrip cycles
- Fixed README.md inclusion for roundtrip compatibility
- Enhanced pattern matching order to prevent conflicts

## Test Results
- All Issue #139 filename decoding tests: 18/18 passing 
- All Issue #140 roundtrip tests: 4/4 passing 
- Comprehensive test coverage for all new functionality

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-13 13:05:48 +02:00
93e762feee feat: Strategic pivot to CLI implementation with comprehensive foundation
Major gap analysis reveals critical missing CLI interface despite solid library foundation.
This commit implements core components and strategic roadmap pivot.

Key Changes:
- NEXT.md: Complete strategic roadmap pivot to CLI-first implementation
- FEATURES.md: Comprehensive USP and architecture documentation
- markitect/ast_cache.py: High-performance AST caching system
- markitect/document_manager.py: Parse-once architecture implementation
- docs/markitect.1: CLI interface manpage documentation

Foundation Status:
- All 45 tests passing (solid library base)
- AST caching with <50% parse time performance goal
- Database integration ready for CLI integration
- TDD8 methodology fully operational

Strategic Pivot:
- Previous: Continue with Issues #2-4 (database expansion)
- New Priority: Issue #5 - CLI Entry Point implementation
- Goal: Transform library capabilities into user-accessible tools

Next Session: Implement CLI interface using Click/Typer framework
to deliver documented vision and core USPs.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-24 01:14:27 +02:00