Ruliad Renderer

Isolated renderer service for the public Ruliad launch stack.

This renderer speaks the same contract the MCP server expects:

• POST /render
• GET /render/{jobId}
• GET /artifacts/{jobId}/artifact.json
• GET /artifacts/{jobId}/preview.html

Current implementation:

• accepts timelineSpec from the MCP server
• consumes timelineSpec.assemblyTemplate and timelineSpec.renderPlan when present
• compiles a deterministic commerce end-card render artifact
• writes an isolated artifact bundle under .renders/
• serves a human-readable HTML preview plus the structured JSON artifact
• emits a richer review package with package.html, endcard.svg, and storyboard.svg
• can be managed from the CLI

Run flow:

1. npm run build
2. npm start

Default port: 8788

CLI:

• node cli.mjs health --base-url http://localhost:8788
• node cli.mjs demo-payload
• node cli.mjs render --base-url http://localhost:8788 --file ./payload.json
• node cli.mjs status --base-url http://localhost:8788 --job-id render_123
• node cli.mjs artifact --url http://localhost:8788/artifacts/render_123/artifact.json

Promotion surface:

• install CTA: npx ruliad-renderer@latest help
• action CTA: npx ruliad-renderer@latest demo-payload
• docs CTA: this README plus the MCP public contract
• immediate output CTA: render and open package.html

Recommended public install path:

npx ruliad-renderer@latest help

Integration:

• point RULIAD_RENDERER_BASE_URL in ruliad-mcp-server to http://localhost:8788
• call export_video through MCP
• the MCP export flow will create a live render job and return the artifact preview URL