Vyasa Extension Refactor Audit and Execution Plan

Architecture Decision FrameworkURL copied

Dependency Categories For This RefactorURL copied

Use the skill's dependency categories to decide how to test each module:

  • In-process:
    • Markdown fences
    • Markdown preprocessors/postprocessors
    • layout slots
    • navigation providers
    • page shell composition
    • theme asset selection
    • content tree projection
    • static build URL rewriting

These should be tested directly through the extension app/runtime interface. No port is needed.

  • Local-substitutable:
    • SQLite-backed bookmarks
    • SQLite-backed annotations
    • file search over a temp docs tree
    • static build over a temp output folder
    • config loading from temp .vyasa files

These should be tested with temp files and temp directories. No mock-heavy interface is needed.

  • Remote but owned:
    • none in the current audited code.
  • True external:
    • AI agent provider behavior in agent.py, if it remains part of Vyasa.

This belongs in an optional agent extension with a provider port. Tests should use an in-memory adapter. Production can use the real provider adapter.