Remove outdated theme system refactor content from TODO.md since the layered
theme architecture work was already completed and released in v0.6.0. The
todofile is now clean and ready for new active development tasks.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit implements a comprehensive insert mode that preserves document structure
by protecting heading levels 1-3 from modification while allowing full content editing.
## Insert Mode Features
- CLI integration with --insert flag for md-render command
- Protected heading display (read-only) for levels 1-3
- Content-only editing for sections with protected headings
- Full editing capability for heading levels 4-6
- Theme-aware CSS styling for all UI themes
- Modal confirmation dialogs with proper positioning
- Section splitting with automatic protection inheritance
- Validation to prevent protected heading modifications
## Implementation Details
- Added MARKITECT_INSERT_MODE JavaScript flag and configuration
- Enhanced Section class with heading level detection and protection methods
- Added getHeadingText() and getHeadingContent() methods for content separation
- Implemented insert mode UI with protected heading display above content editor
- Added comprehensive CSS styling for insert mode components and modals
- Updated CLI with --insert option and mutual exclusion with --edit
## Bug Fixes
- Fixed JavaScript syntax errors caused by unescaped newline characters in string literals
- Corrected split('\n') and join('\n') calls to use proper escaping for Python string context
- Fixed heading level 3 display showing "null" by improving regex pattern matching
- Resolved content not displaying in edit/insert modes due to JavaScript parsing failures
## Documentation
- Updated UserInterfaceFramework.md with complete Insert Mode Editor section
- Added behavioral comparison table between edit and insert modes
- Updated Component Integration Matrix to reflect new capabilities
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add document viewport scroll indicators with triangular arrows
- Implement disabled state styling (grey background, cursor: not-allowed)
- Add smooth scrolling with easing functions for indicator clicks
- Include hover detection at top/bottom of viewport for indicator display
- Fix CSS syntax error in scroll indicator styles
- Add theme-aware styling for all UI themes (standard, greyscale, electric, psychedelic)
- Extend confirmation dialog with theme-consistent danger and secondary button properties
- Update UserInterfaceFramework.md to mark confirmation dialog as completed
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Version 0.6.0 introduces comprehensive improvements:
🚀 Major Features:
- Custom status modal system with theme consistency
- HTML generation dogtag with user attribution
- Enhanced link navigation (new tabs, no edit trigger)
- Comprehensive UI framework documentation
🔧 Architecture:
- Complete document_manager.py cleanup (-2000 lines)
- Clean wrapper pattern maintaining compatibility
- Enhanced database integration and AST processing
🎨 UI/UX:
- Theme-aware modal dialogs
- Standardized CSS naming conventions
- Improved error handling and validation
🧪 Quality:
- Updated test suite for clean implementation
- Fixed JavaScript syntax and CSS escape issues
- Enhanced front matter parsing integration
This release establishes a solid foundation for maintainable,
clean architecture while preserving all existing functionality.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major architectural improvements and feature enhancements:
## Core Features Added
- ✨ Custom status modal system replacing browser alerts with theme-consistent branding
- ✨ HTML generation dogtag with timestamp and username linking
- ✨ All document links now open in new tabs without triggering edit mode
- ✨ Comprehensive UI framework documentation (UserInterfaceFramework.md)
## Architecture Improvements
- 🔧 Complete cleanup of document_manager.py - removed 2000+ lines of legacy code
- 🔧 Clean wrapper implementation maintaining backward compatibility
- 🔧 Enhanced database integration with proper front matter parsing
- 🔧 Improved AST processing and cache file generation
## UI/UX Enhancements
- 🎨 Theme-aware modal dialogs with proper CSS styling and accessibility
- 🎨 Consistent CSS class naming conventions across all UI components
- 🎨 Enhanced link behavior for better document navigation
- 🎨 Professional status information display
## Developer Experience
- 📝 Comprehensive UI component documentation for future development
- 🧪 Updated test suite to work with clean implementation
- 🧪 Fixed multiple test compatibility issues
- 🧪 Enhanced error handling and validation
## Technical Details
- Added store_document method to CleanDocumentManager
- Enhanced ingest_file method with proper title extraction
- Implemented theme-consistent modal overlay patterns
- Added --nodogtag CLI option for clean output when needed
- Fixed CSS escape sequences and JavaScript syntax issues
This release establishes a solid foundation for the clean editor architecture
while maintaining full backward compatibility with existing functionality.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
The Problem:
- UI themes were defined but CSS wasn't applying to editor interface
- CSS selectors didn't match actual HTML element classes/IDs
The Solution:
- Updated CSS selectors to target correct editor elements:
- #markitect-global-controls (main control panel)
- .control-btn (action buttons like Save, Reset)
- .markitect-section-editable (editable section frames)
- textarea (text editing areas)
Results:
- Greyscale theme: Grey panels, borders, subtle shadows
- Electric theme: Cyan/navy cyberpunk with yellow focus
- Psychedelic theme: Rainbow gradients with hot pink accents
- Standard theme: Clean professional interface (default)
All UI themes now properly style the editor interface in --edit mode!
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added `markitect themes` command to list all available themes
- Supports multiple output formats: table (default), list, and json
- Allows filtering by theme scope: ui, document, branding, or all
- Shows key properties for each theme (colors, fonts, etc.)
- Includes legacy theme mappings and usage examples
- Enhances discoverability of the layered theme system
Usage examples:
- markitect themes
- markitect themes --format json
- markitect themes --scope ui
- markitect themes --scope document --format list
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added link_color: #777777 and link_hover_color: #999999 to academic theme
- Grey colors provide good contrast on both light and dark backgrounds
- Maintains academic aesthetic while ensuring accessibility
- Link contrast ratios: 4.48:1 (light), 4.23:1 (dark) - meet WCAG AA standards
- All template system tests continue to pass
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Enhanced dark theme with brighter link colors (#79c0ff, #a5d6ff)
- Added corresponding light theme link colors (#0969da, #0550ae)
- Fixed template parsing bug where 'light' theme was falling back to 'basic'
- All theme system tests continue to pass
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Mark theme system refactor as completed
- Add context about new layered theme capabilities
- Document successful implementation of sophisticated theme combinations
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add agent symlinks in .claude/agents/ directory
- Include agent-project-management.md and test-agent.md
- Add tools/register-agents-claude.py for agent registration
- Enable specialized agents for project management and testing
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add standard Keep a Changelog header with format description
- Add Unreleased section following standard format
- Add comprehensive entries for versions 0.1.0, 0.2.0, and 0.3.0
- Research and document historical features using git log analysis
- Follow Keep a Changelog categories (Added, Changed, Fixed)
- Maintain chronological order with proper release dates
- Update TODO.md to reflect completed changelog enhancement work
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Set table font-size to 0.85em for improved readability
- Add professional table styling with borders and spacing
- Include header styling with background color and bold text
- Enhance visual hierarchy in generated HTML documents
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add comprehensive image test document with various image types
- Update project structure with development artifacts
- Prepare foundation for image support enhancement phase
- Include test files for validating image editing workflows
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This release represents a major milestone in MarkiTect's evolution, featuring a complete rewrite of the editor system using test-driven development principles and clean object-oriented architecture.
Key highlights:
- Clean TDD-driven editor architecture with Section/SectionManager/DOMRenderer classes
- Multiple concurrent section editing with intelligent section splitting
- Four-layer content management system (original, current, pending, editing)
- Enhanced status dialog with repository info and version tracking
- Comprehensive testing framework with separation of concerns
- Elegant slide-in control panel and intelligent auto-sizing textarea
- Complete legacy editor system replacement
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace legacy editor with clean object-oriented architecture
- Add comprehensive test-driven Section, SectionManager, and DOMRenderer classes
- Implement four-layer content management with proper action semantics
- Add multiple concurrent section editing capability
- Implement intelligent section splitting with heading detection
- Add enhanced status dialog with repository info, version, and save filename
- Include git commit information and modification status
- Provide actual save filename preview instead of source filename
- Maintain proper section positioning and global reset functionality
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Addressed multiple critical editing experience issues:
Enhanced Markdown Preservation:
- Fixed htmlToMarkdown() to properly preserve heading hash signs (# ## ###)
- Maintained markdown structure for lists, code blocks, and blockquotes
- Preserved inline formatting (bold, italic, code) within paragraphs
- Improved spacing and indentation handling for complex structures
Font Size & Style Preservation:
- Extract and apply original element's font-size to textarea
- Preserve line-height from source content for consistent appearance
- Use inherit values in CSS, overridden by JavaScript for accuracy
- Ensures editing experience matches visual appearance of content
Improved Textarea Sizing:
- More reasonable height constraints (max 360px vs 400px)
- Line-count based minimum height calculation (~24px per line)
- Reduced excessive height for short content
- Added both horizontal and vertical resize capability
- Set minimum width constraint (200px) for better usability
CSS Enhancements:
- Changed resize from vertical-only to both directions
- Added min-width constraint for better proportions
- Improved overflow handling (auto vs overflow-y only)
- Font properties use inherit with JavaScript override
Technical Improvements:
- Better content height calculation using actual line count
- Proper handling of edge cases in markdown conversion
- Maintained smooth transitions while fixing sizing logic
- Preserved all existing functionality while fixing issues
These fixes ensure that:
- Headings preserve their # markers when edited
- Font sizes match the original content being edited
- Textarea dimensions are proportional and user-controllable
- Markdown structure roundtrips accurately
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhanced the editing experience with smart textarea sizing that adapts
to content dimensions:
Smart Auto-Sizing Logic:
- Dynamically calculates height based on content lines
- Minimum height: 3 lines (63px) for comfortable editing
- Maximum height: 20 lines (444px) to prevent excessive expansion
- Precise calculation using line-height and padding measurements
Responsive Behavior:
- Auto-resizes on input events as you type
- Handles paste operations with proper sizing
- Smooth transitions with 0.15s ease animation
- Temporarily disables transition during measurement for accuracy
Technical Implementation:
- Line-height aware calculation (14px font × 1.5 = 21px per line)
- Proper padding compensation (24px total)
- Scroll-height based measurement for precise content fitting
- Debounced initial sizing to handle DOM rendering
User Experience Benefits:
- Textarea perfectly fits content size on open
- No unnecessary white space for short content
- Sufficient space for longer content without overwhelming
- Natural, document-like editing experience
- Visual harmony with surrounding content boxes
CSS Enhancements:
- Reduced min-height from 100px to 60px for better proportions
- Added smooth height transitions for polished feel
- Maintained vertical resize capability for user control
- Proper box-sizing for consistent measurements
This creates a much more natural editing experience where the textarea
intelligently adapts to match the content being edited.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical positioning issue where split sections would jump to end
of document instead of staying at their original location.
Problem:
- appendChild() was adding new sections at end of parent container
- Split sections appeared at bottom of document, not at edit location
- Disrupted document flow and user experience
Solution:
- Remember original position with nextSibling before removal
- Use insertBefore(wrapper, nextSibling) for correct positioning
- New sections now appear exactly where original section was located
- Maintains proper document order and reading flow
This ensures that when you split a paragraph by adding empty lines,
the resulting sections stay in their logical position within the
document structure.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Implemented sophisticated paragraph handling for the markdown editor:
Enhanced HTML-to-Markdown Conversion:
- Replaced simple tag stripping with proper structural parsing
- Preserves formatting for headers, emphasis, code, blockquotes
- Maintains paragraph separation with proper spacing
- Handles nested elements and mixed content correctly
Dynamic Section Splitting:
- Detects paragraph breaks (double newlines) when editing
- Automatically creates separate editable sections for each paragraph
- Enables independent editing of logically separate content
- Maintains proper section indexing with sub-identifiers
Visual Enhancements:
- Added green styling for edited sections to distinguish from originals
- Subtle borders and backgrounds indicate modified content
- Hover effects provide clear feedback on editable areas
Technical Improvements:
- Enhanced blur handler to detect multiple paragraphs
- Smart wrapper creation for single vs. multi-paragraph content
- Proper DOM manipulation for section insertion and replacement
- Preserves editing state and section relationships
Benefits:
- Empty lines between paragraphs are preserved accurately
- Text separated by empty lines becomes independently editable
- Better content organization and editing granularity
- Improved user experience with clear visual feedback
This resolves the empty line swallowing issue and provides intuitive
paragraph-level editing that matches user expectations.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical bug where editing a section would cause content duplication
in the saved file due to improper handling of DOM reconstruction.
Problem:
- marked.parse() creates multiple HTML elements from single markdown section
- markSections() marked all new elements as individual editable sections
- getMarkdownContent() processed all marked sections, causing duplication
- Example: editing "## Header\nText" created <h2> + <p>, both saved separately
Solution:
- Wrap edited content in container div with data-edited attribute
- Update markSections() to skip elements inside edited wrappers
- Enhanced getMarkdownContent() to handle edited wrappers as single units
- Process child elements within edited wrappers correctly
- Maintain section indexing while preventing double-marking
Technical Changes:
- editSection() now creates wrapper div for parsed content
- markSections() skips content inside [data-edited] containers
- getMarkdownContent() handles edited vs regular sections differently
- Proper cleanup and re-indexing of section markers
This ensures edited sections are treated as cohesive units and saved
exactly once, eliminating content duplication while maintaining full
editing functionality.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical bug where saving unedited content would introduce unwanted
indentation and formatting changes due to unnecessary DOM reconstruction.
Problem:
- getMarkdownContent() always reconstructed from DOM elements
- textContent doesn't preserve original markdown formatting
- HTML rendering adds/removes whitespace causing formatting drift
- Lines after first would get extra indentation on roundtrip
Solution:
- Added hasEdits tracking to MarkitectEditor class
- Return original markdown content when no edits have been made
- Only reconstruct from DOM when actual edits occurred
- Mark hasEdits=true when textarea blur event fires
This ensures perfect fidelity when saving unedited documents while
maintaining the reconstruction capability for edited content.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhanced the floating control panel behavior:
- Ribbon smoothly fades out (opacity: 0) when panel expands
- Ribbon becomes non-interactive (pointer-events: none) when hidden
- Added smooth opacity transition (0.3s ease) for elegant fade effect
- Maintains consistent transition timing with panel slide animation
This eliminates the redundant ribbon icon when the full panel is visible,
creating a cleaner and less cluttered interface while maintaining the
intuitive expand/collapse interaction.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Replaced the intrusive blue status bar with a sleek slide-in control panel:
UI/UX Improvements:
- Minimized ribbon (📝 icon) on top-right that slides out to full panel
- Beautiful gradient design with backdrop blur effects
- Smooth CSS transitions with cubic-bezier easing
- Auto-expand on load, then minimize after 2 seconds
- Click outside to close, click ribbon to toggle
Features Combined:
- Status indicators with dynamic icons (⏳ loading, ✅ success, ❌ error)
- Save & Download and Preview buttons in clean grid layout
- Version information in panel header
- Error reporting with expandable details
- Responsive design for mobile devices
Technical Changes:
- Replaced old floating-header with integrated control panel
- Enhanced status update function with visual state management
- Added toggle functionality with click-outside-to-close
- Improved typography and spacing throughout
- Updated test to match new element ID structure
This provides a much cleaner editing experience with better space utilization
while maintaining all previous functionality and adding visual polish.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical bug where CSS files were not being embedded inline due to
missing Path import in _generate_html_template method. This was causing
CSS content to fall back to link tags instead of inline embedding.
The issue was:
- Path used in CSS handling code (line 367) before being imported
- Path import was conditional and occurred later in the method (line 623)
- Exception handling silently fell back to link tags
Solution:
- Added explicit `from pathlib import Path` import at method start
- CSS files now properly embed inline as intended
- All CSS-related tests now pass (6/6 previously failing)
This resolves the test failures where CSS content was expected to be
embedded inline but was generating link tags instead.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Simplified installation process with clearer, more intuitive targets:
- NEW: `make install` - One-command global installation (recommended)
- NEW: `make uninstall` - Clean removal of global installation
- RENAMED: install-deps → install-user-deps (clearer purpose)
- RENAMED: install-deps-force → install-force-deps (better naming)
- RENAMED: install-system → install-system-deps (clearer scope)
- UPDATED: Help messages and cross-references throughout
The new `make install` target:
1. Creates user virtual environment with dependencies
2. Installs markitect binary to ~/bin/
3. Provides clear next steps and verification
This resolves the confusing 8-target installation matrix with a simple,
reliable one-command solution that works from any directory.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Key improvements:
- Fixed critical md-render --edit functionality that was broken
- Enhanced version tracking with git commit hash, timestamps, and local changes detection
- Comprehensive regression tests to prevent future breaks
- Repository cleanup completed
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Remove extensive documentation files to simplify repository structure
for v0.2.0 release. Core functionality is complete and tested.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit fixes the critical md-render --edit regression that was causing
"blue box, no content" issues and adds comprehensive version tracking.
Key fixes:
- Fixed JavaScript newline escaping in f-string templates (\\n\\n not \\\\n\\\\n)
- Restored proper content rendering with marked.js CDN and graceful fallback
- Removed problematic validation logic that was blocking content display
- Cleaned up html-inject-editing command and related experimental code
Enhancements:
- Added version display in edit mode header with git commit and timestamp
- Enhanced version tracking to show local uncommitted changes with timestamps
- Added comprehensive regression tests to prevent future breakage
- Improved error handling and recovery mechanisms
The md-render --edit functionality now works reliably with full version visibility.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Add robust testing framework to prevent regression of edit mode:
- Comprehensive regression tests for JavaScript syntax validation
- Build-time JavaScript validation tool with Node.js integration
- Enhanced error tracking with detailed logging and recovery
- Makefile integration for `make validate-js` command
Features:
- Validates JavaScript syntax in generated HTML templates
- Detects common issues like broken string literals and brace escaping
- Enhanced error reporting with timestamps and context
- Automatic error recovery for graceful degradation
- Build validation to catch syntax errors before deployment
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fix broken edit mode that prevented content rendering due to:
- Unescaped newline literals causing JavaScript string syntax errors
- Inconsistent brace escaping in f-string templates
- Template literal syntax issues with variable interpolation
The edit mode now properly renders content AND provides editing capabilities.
Also added html-inject-editing command for standalone HTML enhancement
with graceful fallback options.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fix critical runtime error where md-ingest command failed with
'str' object has no attribute 'exists'. The DocumentManager.ingest_file()
method expects a Path object but was receiving a string from the CLI.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Kaizen-agentic framework integration as capability submodule
- Test reorganization by capability with better modularity
- Comprehensive capability inclusion management system
- Directory reorganization with logical separation
- Todofile system implementation replacing NEXT.md
- Historical file organization for cleaner structure
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Clean up base directory by moving completed work and legacy files to
organized subdirectories within history/, improving project navigation
and separating active files from historical artifacts.
## Archived Files:
### Development Scripts → history/development-scripts/
- debug_*.py (7 files) - Legacy debugging and development scripts
- demo_issue_150.py - Issue demonstration script
### Migration Reports → history/migration-reports/
- AGENT_MIGRATION_REPORT.md - Completed agent migration work
- ASSET_MODEL_MIGRATION.md - Completed asset model migration
- KAIZEN_MIGRATION_GAMEPLAN.md - Completed kaizen framework migration
- KAIZEN_UPDATE_REPORT.md - Completed kaizen update work
- PHASE_3_COMPLETION_REPORT.md - Completed phase 3 work
- PHASE_4_COMPLETION_REPORT.md - Completed phase 4 work
### Legacy Files → history/legacy-files/
- .env.tddai - Legacy TDD framework configuration
- README.html - Generated file (superseded by README.md)
- test_status.html - Generated test status file
- install-*.sh (5 files) - Legacy individual install scripts
## Benefits:
- **Cleaner Repository**: Base directory now focused on active development
- **Better Organization**: Historical files properly categorized and preserved
- **Improved Navigation**: Easier to find current vs. historical information
- **Preserved History**: All work artifacts maintained for reference
Repository now has 33 active files in base directory (reduced from 48)
with complete historical preservation in organized subdirectories.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Update submodule reference to include agent changes for TODO.md integration.
The kaizen-agentic framework now has updated project-management agent that
references TODO.md instead of NEXT.md, maintaining consistency with the
main project's todofile system adoption.
Submodule changes:
- Updated agent-project-management.md to use TODO.md workflow
- Modified session wrap-up protocol for todofile format
- Aligned with main project's todofile system implementation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Replace NEXT.md approach with standardized Keep a Todofile V0.0.1 format
for better task management and human-AI collaboration during coding sessions.
## Todofile System Setup:
- **TODO.md**: Main todofile following Keep a Todofile V0.0.1 format
- **TODOFILE_GUIDE.md**: Comprehensive system documentation and workflow
- **Integration**: Fully integrated with existing kaizen-agentic framework
- **Agent Support**: Uses agent-keepaTodofile for maintenance
## Content Migration:
- Migrated strategic priorities from NEXT.md to TODO.md [Unreleased] section
- Preserved session success criteria and development milestones
- Organized tasks by impact type (To Add, To Fix, To Refactor)
- Archived NEXT.md to history/NEXT_archived_20251025.md
## Documentation Updates:
- README.md: Updated "Next Actions" → "Current Tasks" link
- agent-project-management.md: Updated workflow to use TODO.md
- docs/README.md: Updated project management references
- Added comprehensive TODOFILE_GUIDE.md
## Benefits:
- **Standardized Format**: Industry-standard Keep a Todofile format
- **Better Organization**: Impact-based task categorization
- **AI-Ready**: Designed for human-AI collaboration workflows
- **Context Preservation**: Maintains coding flow across session interruptions
- **Integration Ready**: Works with existing agent and capability systems
Active tasks now in TODO.md [Unreleased] section focusing on strategic
issue resolution and capability management validation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Separate capability-specific tests from core system tests to establish clear
test organization and separation of concerns.
## Test Reorganization:
- **markitect-content tests**: Moved 6 tests to capabilities/markitect-content/tests/
- **markitect-finance tests**: Moved 7 tests to markitect/finance/tests/
- **markitect-query tests**: Moved 1 test to markitect/query_paradigms/tests/
- **markitect-graphql tests**: Moved 2 tests to markitect/graphql/tests/
- **markitect-plugins tests**: Moved 2 tests to markitect/plugins/tests/
## Makefile Updates:
- **make test**: Excludes capability tests, runs only core system tests
- **make test-capabilities**: Runs all capability tests
- **make test-capability-***: Individual capability test targets
- Updated all test targets (test-red, test-green, test-ultra-fast, test-perf)
- Added capability test targets to help documentation
## Benefits:
- Clear separation between core system tests and capability-specific tests
- Faster core test execution (capability tests not run by default)
- Individual capability testing for focused development
- Supports future capability extraction workflow
- Maintains capability test independence
Test verification:
- Core tests: 1291 tests (capability tests excluded)
- Finance capability: 143 tests working independently
- Content capability: 79 tests working independently
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Move issue-facade submodule from root to capabilities/ directory
- Update .gitmodules to reflect new submodule path: capabilities/issue-facade
- Update all documentation references to new capability paths
- Update agent definitions with new issue-facade location
- Establish logical organization: capabilities/ for all external dependencies
- Maintain wiki/ at root as project documentation, not reusable capability
Improves separation between:
- Project infrastructure (wiki/ at root)
- Reusable capabilities (capabilities/ directory)
- Internal code (markitect/ directory)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added systematic approach to manage capability inclusion via subrepos and prevent code duplication. This addresses the architectural challenge of ensuring Claude recognizes, uses, and respects included capabilities.
New Capability Management System:
- CAPABILITY_REGISTRY.md: Complete registry of all included capabilities
- CLAUDE_CAPABILITY_REFERENCE.md: Quick lookup guide for Claude to prevent duplication
- tools/capability_discovery.py: Automated discovery and validation tool
- Makefile targets: capability-report, capability-search, capability-validate
Registry Coverage:
- Submodule capabilities: issue-facade (universal issue tracking), wiki (documentation)
- Local capabilities: markitect-content (content parsing), markitect-utils (utilities)
- External dependencies: Click, pytest, SQLAlchemy, requests
Agent Integration:
- Updated project-management and tdd-workflow agents with capability awareness
- Clear guidelines for checking existing functionality before implementing
- Integration patterns for using capabilities properly
Discovery & Validation:
- Automated capability discovery across submodules and local directories
- Search functionality to find existing implementations
- Validation tools to detect potential code duplication
- Claude-readable interfaces and usage patterns
Benefits:
- Prevents accidental functionality duplication
- Ensures proper separation of concerns
- Provides easy capability extension and bugfixing
- Maintains clean interfaces between core and capabilities
- Guides Claude to use existing capabilities efficiently
Usage:
- make capability-report: Generate complete capability overview
- make capability-search TERM=xyz: Find existing implementations
- make capability-validate FILE=path: Check for proper capability usage
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Replaced the local issue-facade implementation with a git submodule pointing
to the standalone coulomb/issue-facade repository. This establishes clear
separation between the MarkiTect core project and the universal issue
management facade.
Changes:
- Removed local issue-facade-251025 directory
- Added coulomb/issue-facade as git submodule at issue-facade/
- Updated .gitmodules with submodule configuration
- Updated Claude Code permissions for submodule usage
The issue-facade is now maintained as a separate project while remaining
easily accessible as a submodule. This allows independent development and
versioning of the universal issue tracking facade while maintaining
integration with MarkiTect workflows.
Submodule URL: http://92.205.130.254:32166/coulomb/issue-facade.git
Current commit: 51aea5e (init: first extract of implementation)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Removed test_real_codebase_issueactivity test which was checking for the
existence of the IssueActivity datamodel that was removed during the
cleanup of the old issue management system.
The test was validating:
- Existence of IssueActivity class
- Specific optimization methods (has_implementation_activity, contains_keyword)
- Specific properties (activity_type_value, formatted_date, truncated_details)
Since the entire markitect/issues/ directory was removed in favor of the
issue-facade system, this test is no longer relevant. All other datamodel
optimizer tests continue to pass.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Updated Claude Code agent configuration and specialized subagents to use the new issue-facade system instead of the deprecated tddai framework:
Agent Updates:
- Updated .claude/settings.local.json with issue-facade CLI permissions
- Removed obsolete tddai_cli.py reference from permissions
- Added permissions for issue-facade CLI commands
Subagent Updates:
- agent-project-management.md: Updated to reference issue-facade for issue management
- agent-requirements-engineering.md: Replaced tddai references with issue-facade
- agent-tdd-workflow.md: Comprehensive update to use issue-facade system
- Renamed from tddai-assistant to tdd-workflow-assistant
- Updated all command references to use issue-facade CLI
- Replaced workspace structure with issue-facade architecture
The specialized subagents now properly leverage the universal issue-facade
system for backend-agnostic issue management across GitHub, GitLab, Gitea,
and local SQLite storage.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
