Skip to content

v1.2.0

Choose a tag to compare

@deligoez deligoez released this 11 Feb 22:42
· 1 commit to master since this release

What's New

MAKE-RUNNABLE Mode Rewrite

The MAKE-RUNNABLE mode has been completely rewritten with a new "runnable first, hide second" philosophy:

  • 7-step workflow: Bootstrap Inventory → Classify → Make Runnable → Harden → Hide → Re-verify → Bootstrap Recommendations
  • NEW vs EXISTING block workflows with detailed examples for each scenario
  • Bootstrap profile support — leverage .doctest/ profiles instead of inline // [!code hide]
  • file:N block targeting for fast iteration on individual blocks

Inline Assertion Strategy (// =>)

New cross-cutting strategy for proactively adding // => inline assertions to non-trivial expression lines:

  • HARDEN step added to MAKE-RUNNABLE workflow (Step 4)
  • Placement guide in assertions reference — clear rules for when to add vs skip
  • Integrated into APPLY mode — Step 4 now considers // => for expression lines
  • Principle: under-asserting is worse than over-asserting; users can remove unwanted assertions

Quality Examples

  • APPLY mode: Converting a block with static output
  • FIX mode: Fixing a dynamic output failure (hardcoded year → wildcard)
  • MAKE-RUNNABLE: PriceCalculator API (NEW block), Laravel User model (EXISTING block), complex setup with hide:start/end
  • HARDEN: Multi-step computation with intermediate value verification

Missing Feature Coverage

  • // => dd() debug dump assertion type
  • HTML comment attribute syntax (<!-- doctest-attr: ... -->)
  • bootstrap="profile" attribute with profile discovery and execution order
  • --parallel CLI option
  • file:N block targeting syntax
  • JSON reporter configuration
  • Bootstrap recommendations for repeated patterns

Reference Updates

  • assertions.md: Added Section 7 (Debug Dump) and Inline Assertion Placement Guide
  • attributes.md: Added bootstrap attribute section and HTML Comment Attribute Syntax section
  • make-runnable.md: Complete rewrite (133 → 305 lines) with philosophy, examples, and decision guide
  • shiki.md: Synced to marketplace (was missing from previous release)

Full Changelog: v1.1.0...v1.2.0