WORK-039
ID:WORK-039Status:done

Refactor plan render pipeline to use @refrakt-md/html

The main refactor: replace the bespoke HTML shell template in @refrakt-md/plan with calls to renderFullPage() from @refrakt-md/html. This removes the hand-rolled document structure, inline styles, and direct HTML string concatenation.

Priority:highComplexity:complexSource:SPEC-014
claude/file-naming-convention-LJdwR View source

Criteria completion

No incremental history — criteria tracking started on Apr 21.

Relationships

Implements 1
Related 9
Branches 3
claude/file-naming-convention-LJdwR current done
main donechangeset-release/main doneclaude/align-sidenav-styling-4MuxV done
History 2
  1. bbbb94c
    Created (done)by bjornolofandersson
  2. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand

Acceptance Criteria

  • render-pipeline.ts calls renderFullPage() from @refrakt-md/html instead of building HTML strings
  • The bespoke HTML shell template is removed
  • getLuminaBaseCss() is removed — @refrakt-md/lumina is no longer a dependency
  • escapeHtml utility is removed (handled by the HTML adapter)
  • Built-in theme CSS is served at /__plan-theme.css (serve) or written to theme.css (build)
  • SSE hot reload script is injected via headExtra option
  • planLayout from WORK-037 is used for structural placement
  • Nav region from WORK-038 is passed as regions.nav
  • plan serve produces identical visual output as before
  • plan build produces identical static output as before
  • --theme flag still works for default, minimal, and custom paths
  • --base-url flag still works correctly
  • All existing plan serve/build tests pass

Approach

  1. Add @refrakt-md/html as a dependency of @refrakt-md/plan
  2. Remove @refrakt-md/lumina dependency
  3. Assemble a minimal HtmlTheme with planLayout
  4. Replace the HTML shell with renderFullPage() calls
  5. Move theme CSS from inline <style> to external stylesheet references
  6. Update serve command to serve CSS and behaviors at dedicated routes
  7. Update build command to write CSS and behaviors as separate files

References

  • SPEC-014 (Plan Site via HTML Adapter)
  • WORK-037 (planLayout definition)
  • WORK-038 (nav region builder)