TODO.md

TODO: Remaining Tasks

Documentation ✅ Complete

• Main README.md
• LICENSE (MIT)
• CONTRIBUTING.md
• requirements.txt / requirements-dev.txt
• setup.py
• docs/specification.md
• docs/api-reference.md
• docs/claude-skill.md
• docs/skill/SKILL.md (Claude Code skill file)
• .gitignore

Fixes Needed ✅ Complete

• Fix README.md references (docs/examples.md vs examples/README.md)
• Create examples/snippets/integration.puml (referenced but missing)
• Create tests/fixtures/ with example .puml files

Source Code Structure ✅ Complete

• src/plantuml_manipulator/init.py (basic version info)
• src/plantuml_manipulator/cli.py (CLI structure with all commands)
• src/plantuml_manipulator/parser.py (complete class structure)
• src/plantuml_manipulator/manipulator.py (complete class structure)
• src/plantuml_manipulator/validator.py (complete class structure)

Test Structure ✅ Complete

• tests/init.py (empty placeholder)
• tests/test_parser.py (comprehensive test structure)
• tests/test_manipulator.py (comprehensive test structure)
• tests/test_validator.py (comprehensive test structure)
• tests/fixtures/ (4 example .puml files: simple, with_groups, with_participants, complex)

Examples ✅ Complete

• examples/README.md
• examples/snippets/validation.puml
• examples/snippets/integration.puml

Implementation

Phase 1: Core Implementation ✅ Complete

• PlantUMLParser implementation
  • parse_file() - Parse PlantUML files
  • parse_lines() - Parse content from lines
  • find_participants() - Extract participant declarations
  • find_groups() - Extract group blocks with nesting support
• DiagramManipulator implementation
  • insert_after_group() - Insert blocks after groups
  • add_participant() - Add participant declarations
• Custom exception classes (GroupNotFoundError, ParticipantNotFoundError, etc.)
• Unit tests for parser (23 tests passing)
• Unit tests for manipulator
• Test fixtures and examples

Phase 2: CLI & File Processing ✅ Complete

• CLI implementation (cli.py)
  • insert-after command
  • add-participant command
  • --dry-run and --verbose flags
• FileProcessor implementation
  • Batch file processing
  • File filtering (only-if-has-participant, skip-if-exists, only-if-has-group)
  • Backup functionality

Phase 3: Validation & Reporting ✅ Complete

• Validator implementation
  • validate_structure() - Validate diagram structure with required/forbidden elements
  • validate_file() - Validate a single file
  • validate_multiple_files() - Batch validation with filtering
• Report generation
  • list_groups() - List all groups across files
  • list_participants() - List all participants across files
  • show_structure() - Show structure of a single file
  • generate_matrix() - Matrix showing file/group relationships
• JSON output format (+ table, simple, CSV formats)
• validate CLI command with multiple output formats
• report CLI commands (groups, participants, structure)

Phase 4: Advanced Features

• remove_group() method
• replace_group() method
• Interactive mode
• Undo functionality

Notes

• Tool should work universally for all PlantUML sequence diagrams
• All examples abstracted from specific project context
• Ready for open-source publication once implementation is complete