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
Acceptance Criteria
render-pipeline.tscallsrenderFullPage()from@refrakt-md/htmlinstead of building HTML strings- The bespoke HTML shell template is removed
getLuminaBaseCss()is removed —@refrakt-md/luminais no longer a dependencyescapeHtmlutility is removed (handled by the HTML adapter)- Built-in theme CSS is served at
/__plan-theme.css(serve) or written totheme.css(build) - SSE hot reload script is injected via
headExtraoption planLayoutfrom WORK-037 is used for structural placement- Nav region from WORK-038 is passed as
regions.nav plan serveproduces identical visual output as beforeplan buildproduces identical static output as before--themeflag still works fordefault,minimal, and custom paths--base-urlflag still works correctly- All existing plan serve/build tests pass
Approach
- Add
@refrakt-md/htmlas a dependency of@refrakt-md/plan - Remove
@refrakt-md/luminadependency - Assemble a minimal
HtmlThemewithplanLayout - 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
- Plan Site via HTML Adapter (Plan Site via HTML Adapter)
- Define planLayout in @refrakt-md/transform (planLayout definition)
- Build nav region builder for plan site (nav region builder)
Relationships
Related
ID:WORK-050Status:done11/11
Converge plan site renderer with shared layout engine
Priority:highComplexity:complex
ID:WORK-041Status:done0/5
Add client behaviors to plan site
Priority:mediumComplexity:simple
ID:WORK-044Status:done8/8
Collapsible status groups in plan sidebar
Priority:highComplexity:moderate
ID:WORK-042Status:done0/7
Config-aware theme resolution for plan site
Priority:mediumComplexity:moderate
ID:WORK-046Status:done7/7
Enhanced plan dashboard with progress and milestone scoping
Priority:mediumComplexity:moderate
ID:WORK-037Status:done0/5
Define planLayout in @refrakt-md/transform
Priority:highComplexity:simple
ID:WORK-038Status:done0/6
Build nav region builder for plan site
Priority:highComplexity:moderate
ID:WORK-040Status:done0/7
Add syntax highlighting to plan site
Priority:mediumComplexity:moderate
ID:WORK-043Status:done0/6
Token bridging — update plan CSS to use --rf-* tokens
Priority:mediumComplexity:moderate