Vyasa Extension Refactor Audit and Execution Plan
Non-Negotiable Rules For The Next RefactorURL copied
- No built-in extension may import a private renderer/helper from a sibling
extension.
- No extension may mutate
ExtensionRuntime directly.
- No extension may register routes against raw
rt or raw FastHTML.
- No feature-specific UI JavaScript may remain in the global
scripts.js once
that feature is an extension.
- No feature-specific CSS may remain in global
header.css once that feature
is an extension.
- A render extension owns its fence parser, renderer, CSS, JavaScript, config,
and tests.
- A route extension owns its route handlers, permission checks, response shape,
storage namespace requests, CSS, JavaScript, and tests.
- Core may expose contracts. Core must not know that "Mermaid", "Tasks",
"Bookmarks", or "Slides" exist.
- Any fallback behavior must go through the default preset, not hard-coded
fallback branches in Markdown or core.
- Move by file operations and function extraction. Avoid retyping large code.