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.

claude/align-sidenav-styling-4MuxV View source

Criteria completion

Tracking started Apr 17 — check back for trends.

Relationships

ID:SPEC-014Status:accepted

Plan Site via HTML Adapter

ID:WORK-037Status:done

Define planLayout in @refrakt-md/transform

Priority:highComplexity:simple

ID:WORK-038Status:done

Build nav region builder for plan site

Priority:highComplexity:moderate

ID:WORK-040Status:done

Add syntax highlighting to plan site

Priority:mediumComplexity:moderate

ID:WORK-041Status:done

Add client behaviors to plan site

Priority:mediumComplexity:simple

ID:WORK-042Status:done

Config-aware theme resolution for plan site

Priority:mediumComplexity:moderate

ID:WORK-043Status:done

Token bridging — update plan CSS to use --rf-* tokens

Priority:mediumComplexity:moderate

ID:WORK-044Status:done

Collapsible status groups in plan sidebar

Priority:highComplexity:moderate

ID:WORK-046Status:done

Enhanced plan dashboard with progress and milestone scoping

Priority:mediumComplexity:moderate

ID:WORK-050Status:done

Converge plan site renderer with shared layout engine

Priority:highComplexity:complex

claude/align-sidenav-styling-4MuxV current done

changeset-release/main done main done claude/file-naming-convention-LJdwR done

Mar 23, 12:57 PM4f81969
Content editedby Claude
Complete SPEC-014 work items (WORK-037 through WORK-041)
Mar 23, 12:51 PMf5b8bf8
Created (done)by Claude
Add work items WORK-037 through WORK-049 for plan site specs

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

Add @refrakt-md/html as a dependency of @refrakt-md/plan
Remove @refrakt-md/lumina dependency
Assemble a minimal HtmlTheme with planLayout
Replace the HTML shell with renderFullPage() calls
Move theme CSS from inline <style> to external stylesheet references
Update serve command to serve CSS and behaviors at dedicated routes
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)