v0.5.0 - Hard Constraint Validation System

What's New

Added

• Hard Constraint Validation System: New _scripts/ directory for framework-level validation scripts

  • validate_topic_tree.py: Python script for validating topic tree updates
  • Validates against 4 rules: ID preservation (R1), no ellipsis (R2), Last Updated field (R3), valid states (R4)
  • Returns JSON output with valid, errors, and warnings fields
  • Exit code 0 for success, 1 for failure

• Double-Buffer Validation Flow: New topic tree update mechanism in discussion_assistant.mdc

  • Step 1: Backup current file to ai_workspace/temp/
  • Step 2: Generate new content to temporary file
  • Step 3: Validate using Python script
  • Step 4: Handle result (commit on success, retry on failure, restore after 3 failures)
  • Graceful degradation: Discussion continues even if validation fails

Changed

• Updated _cursor/rules/discussion_assistant.mdc to v1.4 with hard constraint validation rules
• Updated .gitignore to preserve README files in ai_workspace/ for agent guidance
• Added ai_workspace/temp/ directory for temporary files during validation

Technical Details

• Architecture: LLM soft constraints (prompts) + Script hard constraints (Python)
• Problem Solved: Prevents accidental data loss in topic tree due to LLM randomness
• Design Principle: Scripts validate, LLM generates - separation of concerns