Repository navigation
v1.2.0
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:Nblock 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--parallelCLI optionfile:Nblock 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