Vyasa Extension Refactor Audit and Execution Plan

Architecture Decision FrameworkURL copied

Deepening OpportunitiesURL copied

2. Markdown Pipeline ModuleURL copied

Files:

• vyasa/extensions_builtin/markdown/renderer.py

• vyasa/extensions_builtin/markdown/pipeline.py

• vyasa/extensions_builtin/markdown/tokens.py

• vyasa/extensions_builtin/mermaid/**

• vyasa/extensions_builtin/d2/**

• vyasa/extensions_builtin/cytograph/**

• vyasa/extensions_builtin/tasks/**

• future vyasa/extensions_builtin/cryptograph/**

Problem:

• Markdown owns feature renderers and feature fallbacks.

• Render extensions import private Markdown helpers.

• Disabling an extension does not fully remove behavior.

Solution:

• Markdown owns only registry lookup and rendering orchestration.

• Every fence extension owns its own render.py, CSS, JS, metadata, and registration.

• Markdown receives a fence registry from the frozen extension runtime.

Benefits:

• Leverage: adding a new fence requires no Markdown edits.

• Locality: Mermaid bugs live in Mermaid files.

• Tests: enable/disable behavior is observable through Markdown rendering.