@cyber-dash-tech/revela 0.18.15 → 0.19.0

package/lib/runtime/index.ts

@@ -15,6 +15,7 @@ import {
   installDesignDraftPackage,
   listDesignAssets,
   listDesigns,
+  materializeDesignPreview,
   packDesignPackage,
   seedBuiltinDesigns,
   validateDesignDraftPackage,
@@ -30,6 +31,7 @@ import { runNarrativeMarkdownQa, type MarkdownQaOptions } from "../narrative-vau
 import { formatArtifactQaUserNotice, formatMarkdownQaUserNotice } from "../hook-notifications"
 import { deckPlanDesignDiagnostics, readDeckPlanArtifact, upsertDeckPlanSlideArtifact, type DeckPlanSlideUpsertInput } from "../narrative-state/deck-plan-artifact"
 import { extractDesignClasses } from "../design/designs"
+import { addTemplateScaffold as addPageTemplateScaffold, addTemplateSlide as addPageTemplateSlide, getPageTemplateFoundation, getPageTemplateVocabulary, listPageTemplates as listBuiltinPageTemplates, renderTemplateScaffold as renderPageTemplateScaffold, renderTemplateSlide as renderPageTemplateSlide } from "../page-templates"
 import { recordRenderedArtifact, workspaceRelative } from "../workspace-state/rendered-artifacts"
 import { existingWorkspaceMetaPath, workspaceMetaPath } from "../workspace-meta"
 import { checkMaterialIntake, extractMaterial, materialIntakeNoticeForCommand, prepareLocalMaterials, recordMaterialReview } from "../material-intake"
@@ -84,17 +86,49 @@ export interface RuntimeDeckPlanSlideUpsertInput extends RuntimeWorkspaceInput,
   designName?: string
 }
 
+export interface RuntimeTemplateSlideInput extends RuntimeWorkspaceInput {
+  templateId: string
+  slideIndex: number
+  content: Record<string, any>
+  designName?: string
+}
+
+export interface RuntimeTemplateSlideAddInput extends RuntimeTemplateSlideInput {
+  outputPath: string
+}
+
+export interface RuntimeTemplateScaffoldInput extends RuntimeWorkspaceInput {
+  templateId: string
+  slideIndex: number
+  seed?: Record<string, any>
+  designName?: string
+}
+
+export interface RuntimeTemplateScaffoldAddInput extends RuntimeTemplateScaffoldInput {
+  outputPath: string
+}
+
+export interface RuntimePageTemplateReadInput {
+  templateId: string
+}
+
 export interface RuntimeDesignCreateInput {
   name: string
   base?: string
   designMd: string
-  previewHtml: string
+  designCss?: string
+  previewHtml?: string
   assets?: DesignPackageAssetInput[]
   overwrite?: boolean
 }
 
 export interface RuntimeDesignDraftCreateInput extends RuntimeDesignCreateInput, RuntimeWorkspaceInput {}
 
+export interface RuntimeDesignPreviewInput extends RuntimeWorkspaceInput {
+  name: string
+  source?: "draft" | "installed" | "builtin"
+}
+
 export interface RuntimeDomainCreateInput {
   name: string
   domainMd: string
@@ -218,6 +252,58 @@ export function createDeckFoundation(input: RuntimeDeckFoundationInput) {
   })
 }
 
+export function listPageTemplates() {
+  return listBuiltinPageTemplates()
+}
+
+export function renderTemplateSlide(input: RuntimeTemplateSlideInput) {
+  return renderPageTemplateSlide({
+    templateId: requiredString(input?.templateId, "templateId"),
+    slideIndex: input.slideIndex,
+    content: input.content ?? {},
+    designName: input.designName || activeDesign(),
+  })
+}
+
+export function renderTemplateScaffold(input: RuntimeTemplateScaffoldInput) {
+  return renderPageTemplateScaffold({
+    templateId: requiredString(input?.templateId, "templateId"),
+    slideIndex: input.slideIndex,
+    seed: input.seed ?? {},
+    designName: input.designName || activeDesign(),
+  })
+}
+
+export function addTemplateSlide(input: RuntimeTemplateSlideAddInput) {
+  return addPageTemplateSlide({
+    workspaceRoot: root(input.workspaceRoot),
+    outputPath: requiredString(input?.outputPath, "outputPath"),
+    templateId: requiredString(input?.templateId, "templateId"),
+    slideIndex: input.slideIndex,
+    content: input.content ?? {},
+    designName: input.designName || activeDesign(),
+  })
+}
+
+export function addTemplateScaffold(input: RuntimeTemplateScaffoldAddInput) {
+  return addPageTemplateScaffold({
+    workspaceRoot: root(input.workspaceRoot),
+    outputPath: requiredString(input?.outputPath, "outputPath"),
+    templateId: requiredString(input?.templateId, "templateId"),
+    slideIndex: input.slideIndex,
+    seed: input.seed ?? {},
+    designName: input.designName || activeDesign(),
+  })
+}
+
+export function pageTemplateFoundation(input: RuntimePageTemplateReadInput) {
+  return { ok: true, foundation: getPageTemplateFoundation(requiredString(input?.templateId, "templateId")) }
+}
+
+export function pageTemplateVocabulary(input: RuntimePageTemplateReadInput) {
+  return { ok: true, vocabulary: getPageTemplateVocabulary(requiredString(input?.templateId, "templateId")) }
+}
+
 export async function runDeckQa(input: RuntimeFileInput) {
   const { formatArtifactQAReport, runArtifactQA } = await import("../qa/artifact")
   const workspaceRoot = root(input.workspaceRoot)
@@ -362,7 +448,8 @@ export function designCreate(input: RuntimeDesignCreateInput) {
     name: requiredString(input?.name, "design name"),
     base: input.base,
     designMd: requiredString(input?.designMd, "designMd"),
-    previewHtml: requiredString(input?.previewHtml, "previewHtml"),
+    designCss: input.designCss,
+    previewHtml: input.previewHtml,
     assets: input.assets,
     overwrite: input.overwrite ?? false,
   })
@@ -378,7 +465,8 @@ export function designDraftCreate(input: RuntimeDesignDraftCreateInput) {
     name: requiredString(input?.name, "design name"),
     base: input.base,
     designMd: requiredString(input?.designMd, "designMd"),
-    previewHtml: requiredString(input?.previewHtml, "previewHtml"),
+    designCss: input.designCss,
+    previewHtml: input.previewHtml,
     assets: input.assets,
     overwrite: input.overwrite ?? false,
   })
@@ -388,6 +476,14 @@ export function designDraftValidate(input: RuntimeWorkspaceInput & RuntimeNameIn
   return validateDesignDraftPackage(root(input.workspaceRoot), requiredName(input, "design draft"))
 }
 
+export function designPreview(input: RuntimeDesignPreviewInput) {
+  return materializeDesignPreview({
+    workspaceRoot: root(input.workspaceRoot),
+    name: requiredName(input, "design"),
+    source: input.source,
+  })
+}
+
 export function designDraftInstall(input: RuntimeDraftInstallInput) {
   seedBuiltinDesigns()
   return installDesignDraftPackage({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.18.15",
+  "version": "0.19.0",
   "description": "Codex-first CLI/MCP workspace for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",
@@ -11,11 +11,7 @@
     ".": "./index.ts"
   },
   "files": [
-    "assets/img/logo.png",
-    "assets/img/logo-64.png",
-    "assets/img/logo-256.png",
-    "assets/img/logo-wordmark.png",
-    "assets/img/review-ui.png",
+    "assets/img/",
     "bin/",
     "plugin.ts",
     "lib/",
@@ -23,15 +19,11 @@
     "tools/",
     "skill/",
     "designs/aurora/DESIGN.md",
-    "designs/starter/DESIGN.md",
-    "designs/starter/preview.html",
-    "designs/summit/DESIGN.md",
-    "designs/summit/preview.html",
-    "designs/monet/DESIGN.md",
-    "designs/monet/preview.html",
-    "designs/lucent/DESIGN.md",
-    "designs/lucent/preview.html",
-    "designs/lucent/assets/",
+    "designs/starter/",
+    "designs/summit/",
+    "designs/monet/",
+    "designs/lucent/",
+    "designs/lucent-dark/",
     "domains/general/INDUSTRY.md",
     "domains/deeptech-investment/INDUSTRY.md",
     "domains/consulting/INDUSTRY.md",

package/plugins/revela/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "revela",
-  "version": "0.18.15",
-  "description": "Use Revela in Codex to specify, research, plan, make, review, and export trusted narrative decision artifacts.",
+  "version": "0.19.0",
+  "description": "Use Revela in Codex to specify, research, plan, make, and export trusted narrative decision artifacts.",
   "author": {
     "name": "cyber-dash-tech",
     "url": "https://github.com/cyber-dash-tech"
@@ -20,7 +20,7 @@
   "interface": {
     "displayName": "Revela",
     "shortDescription": "Trusted narrative artifacts from local sources and research.",
-    "longDescription": "Revela helps Codex route workspace workflows, capture requirements in spec.md, ingest local materials, save research findings, plan decks, generate HTML deck artifacts, review them, and export PDF/PPTX/PNG outputs while preserving source traceability.",
+    "longDescription": "Revela helps Codex route workspace workflows, capture requirements in spec.md, ingest local materials, save research findings, plan decks, generate HTML deck artifacts, open them in Codex Browser for annotation, and export PDF/PPTX/PNG outputs while preserving source traceability.",
     "developerName": "cyber-dash-tech",
     "category": "Productivity",
     "capabilities": [
@@ -31,7 +31,7 @@
       "Use Revela to route the next workflow step for this workspace.",
       "Use Revela to write a spec.md for this deck objective.",
       "Use Revela to make a deck from the deck plan.",
-      "Use Revela to review this deck artifact."
+      "Use Revela to export this deck artifact."
     ],
     "brandColor": "#2563EB"
   }

package/plugins/revela/hooks/revela_guard.ts

@@ -26,6 +26,16 @@ export async function runPreWriteChecks(input: string): Promise<HookResult> {
     ].join("\n"))
   }
 
+  const protectedDesignCssTargets = extractProtectedDesignCssPatchTargets(input)
+  if (protectedDesignCssTargets.length > 0) {
+    messages.push([
+      "Revela design CSS patches are blocked outside the design draft workflow.",
+      `Protected target(s): ${protectedDesignCssTargets.map((target) => `\`${target}\``).join(", ")}`,
+      "Create or edit designs under `.revela/drafts/designs/<name>/design.css`, then validate and install the draft.",
+      "Deck-local `decks/_revela-design/**/design.css` files are render snapshots and should be regenerated, not patched.",
+    ].join("\n"))
+  }
+
   const deckTargets = extractDeckHtmlPatchTargets(input)
   if (deckTargets.length > 0) {
     const pluginRoot = resolve(process.env.PLUGIN_ROOT || dirname(dirname(fileURLToPath(import.meta.url))))
@@ -74,6 +84,31 @@ export function extractNarrativeCachePatchTargets(input: string): string[] {
   return [...targets].sort((a, b) => a.localeCompare(b))
 }
 
+export function extractProtectedDesignCssPatchTargets(input: string): string[] {
+  const targets = new Set<string>()
+  for (const patch of patchPayloads(input)) {
+    const pattern = /(?:^\*\*\* Update File: |^\*\*\* Add File: |^\*\*\* Delete File: |^\*\*\* Move to: )([^\r\n]*design\.css)\s*$/gm
+    let match: RegExpExecArray | null
+    while ((match = pattern.exec(patch))) {
+      const target = match[1].trim().replace(/\\/g, "/")
+      if (isAllowedDesignDraftCssTarget(target)) continue
+      if (isProtectedDesignCssTarget(target)) targets.add(target)
+    }
+  }
+  return [...targets].sort((a, b) => a.localeCompare(b))
+}
+
+function isAllowedDesignDraftCssTarget(target: string): boolean {
+  return /(^|\/)\.revela\/drafts\/designs\/[^/]+\/design\.css$/.test(target)
+}
+
+function isProtectedDesignCssTarget(target: string): boolean {
+  return /(^|\/)designs\/[^/]+\/design\.css$/.test(target)
+    || /(^|\/)decks\/_revela-design\/[^/]+\/design\.css$/.test(target)
+    || /(^|\/)_revela-design\/[^/]+\/design\.css$/.test(target)
+    || /(^|\/)\.config\/revela\/designs\/[^/]+\/design\.css$/.test(target)
+}
+
 function patchPayloads(input: string): string[] {
   try {
     const parsed = JSON.parse(input)

package/plugins/revela/hooks/revela_post_write_notice.ts

@@ -1,4 +1,5 @@
-import { dirname, resolve } from "path"
+import { basename, dirname, resolve } from "path"
+import { existsSync, readFileSync } from "fs"
 import { fileURLToPath, pathToFileURL } from "url"
 import { resolveRevelaRuntime } from "../mcp/runtime-resolver"
 
@@ -9,15 +10,13 @@ interface HookResult {
 
 export function extractDeckHtmlTargets(input: string): string[] {
   const targets = new Set<string>()
-  const patterns = [
-    /\bdecks\/[^\s"'`<>]+\.html\b/g,
-    /(?:^\*\*\* Update File: |^\*\*\* Add File: )([^\r\n]+decks\/[^\r\n]+\.html)\s*$/gm,
-  ]
+  const pattern = /(?:^\*\*\* Update File: |^\*\*\* Add File: )((?:[^\r\n]*\/)?decks\/[^\s"'`<>*?\r\n]+\.html)\s*$/gm
 
-  for (const pattern of patterns) {
+  for (const patch of patchPayloadsFromInput(input)) {
     let match: RegExpExecArray | null
-    while ((match = pattern.exec(input))) {
-      targets.add((match[1] ?? match[0]).trim())
+    while ((match = pattern.exec(patch))) {
+      const target = match[1].trim()
+      if (!target.includes("*") && !target.includes("?")) targets.add(target)
     }
   }
 
@@ -59,6 +58,32 @@ export function workspaceRootFromInput(input: string): string {
   return resolve(process.env.CODEX_WORKSPACE_ROOT || process.env.PWD || process.cwd())
 }
 
+function titleFromDeckHtml(absolutePath: string): string {
+  try {
+    if (!existsSync(absolutePath)) return basename(absolutePath)
+    const html = readFileSync(absolutePath, "utf-8")
+    const title = html.match(/<title[^>]*>([^<]+)<\/title>/i)?.[1]?.trim()
+    return title || basename(absolutePath)
+  } catch {
+    return basename(absolutePath)
+  }
+}
+
+export function formatDeckWebsiteCardHandoffNotice(workspaceRoot: string, target: string): string {
+  const absolutePath = resolve(workspaceRoot, target)
+  const deckUrl = pathToFileURL(absolutePath).href
+  const title = titleFromDeckHtml(absolutePath)
+  return [
+    "**Deck website card ready**",
+    "",
+    `Artifact QA passed for \`${target}\`. Reply with this standalone deck link so Codex renders an Open in Browser website card:`,
+    "",
+    `[${title}](${deckUrl})`,
+    "",
+    `If the card or direct \`file://\` navigation is unavailable, start a read-only local static server from the workspace root and link to \`http://127.0.0.1:<port>/${target}\` instead.`,
+  ].join("\n")
+}
+
 export async function runPostWriteChecks(input: string): Promise<HookResult> {
   const messages: string[] = []
   const deckTargets = extractDeckHtmlTargets(input)
@@ -97,11 +122,16 @@ export async function runPostWriteChecks(input: string): Promise<HookResult> {
   }
 
   for (const target of deckTargets) {
+    if (!existsSync(resolve(workspaceRoot, target))) continue
     const result = await runtimeModule.runDeckQa({ workspaceRoot, file: target })
     messages.push(result.markdown ?? JSON.stringify(result, null, 2))
     const notice = runtimeModule.formatArtifactQaUserNotice?.(result.report)
     if (notice) messages.push(notice)
-    if (!result.ok) ok = false
+    if (result.ok) {
+      messages.push(formatDeckWebsiteCardHandoffNotice(workspaceRoot, target))
+    } else {
+      ok = false
+    }
   }
 
   return { ok, messages }

package/plugins/revela/mcp/revela-server.ts

@@ -13,6 +13,13 @@ type RuntimeModule = {
   readDeckPlan(input?: any): any
   upsertDeckPlanSlide(input: any): any
   createDeckFoundation(input: any): any
+  listPageTemplates(): any
+  renderTemplateSlide(input: any): any
+  addTemplateSlide(input: any): any
+  renderTemplateScaffold(input: any): any
+  addTemplateScaffold(input: any): any
+  pageTemplateFoundation(input: any): any
+  pageTemplateVocabulary(input: any): any
   runDeckQa(input: any): Promise<any>
   exportPdf(input: any): Promise<any>
   exportPptx(input: any): Promise<any>
@@ -25,6 +32,7 @@ type RuntimeModule = {
   designActivate(input: any): any
   designCreate(input: any): any
   designValidate(input: any): any
+  designPreview(input: any): any
   designDraftCreate(input: any): any
   designDraftValidate(input: any): any
   designDraftInstall(input: any): any
@@ -94,6 +102,71 @@ const tools = [
       overwrite: booleanProp("Whether create mode may overwrite an existing file."),
     }, ["outputPath", "title", "language"]),
   },
+  {
+    name: "revela_list_page_templates",
+    description: "List built-in Revela page templates with semantic fields, content rules, and template QA contracts.",
+    inputSchema: objectSchema({}),
+  },
+  {
+    name: "revela_render_template_slide",
+    description: "Render one built-in page template into a stable Revela slide HTML skeleton using the active/requested design.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      designName: stringProp("Optional design name. Defaults to the active design."),
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+      slideIndex: requiredNumberProp("Positive 1-based slide index."),
+      content: objectProp("Template content fields. The built-in template renderer owns the HTML skeleton."),
+    }, ["templateId", "slideIndex", "content"]),
+  },
+  {
+    name: "revela_page_template_foundation",
+    description: "Read the built-in template foundation for custom design authoring: scaffold HTML, CSS hooks, slots, and contract notes.",
+    inputSchema: objectSchema({
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+    }, ["templateId"]),
+  },
+  {
+    name: "revela_page_template_vocabulary",
+    description: "Read machine-readable classes, slots, editable regions, replaceable regions, and contract notes for one page template.",
+    inputSchema: objectSchema({
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+    }, ["templateId"]),
+  },
+  {
+    name: "revela_render_template_scaffold",
+    description: "Render one built-in page template scaffold with stable editable slots using minimal seed content.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      designName: stringProp("Optional design name. Defaults to the active design."),
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+      slideIndex: requiredNumberProp("Positive 1-based slide index."),
+      seed: objectProp("Optional scaffold seed fields. This is not the final authoring interface."),
+    }, ["templateId", "slideIndex"]),
+  },
+  {
+    name: "revela_add_template_scaffold",
+    description: "Render and append one built-in page template scaffold into an existing Revela deck HTML file between slide markers.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      outputPath: requiredStringProp("Workspace-relative HTML deck path."),
+      designName: stringProp("Optional design name. Defaults to the active design."),
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+      slideIndex: requiredNumberProp("Positive 1-based slide index."),
+      seed: objectProp("Optional scaffold seed fields. LLM should bounded-edit the inserted slide after scaffold creation."),
+    }, ["outputPath", "templateId", "slideIndex"]),
+  },
+  {
+    name: "revela_add_template_slide",
+    description: "Compatibility path: render and append one built-in page template slide from full content JSON into an existing deck HTML file.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      outputPath: requiredStringProp("Workspace-relative HTML deck path."),
+      designName: stringProp("Optional design name. Defaults to the active design."),
+      templateId: requiredStringProp("Built-in template id, such as timeline-roadmap."),
+      slideIndex: requiredNumberProp("Positive 1-based slide index."),
+      content: objectProp("Template content fields. Prefer scaffold-first flow for new deck creation."),
+    }, ["outputPath", "templateId", "slideIndex", "content"]),
+  },
   {
     name: "revela_run_deck_qa",
     description: "Run Revela artifact QA on a generated HTML deck.",
@@ -171,15 +244,16 @@ const tools = [
   },
   {
     name: "revela_design_create",
-    description: "Create and validate a local Revela design package from complete DESIGN.md and preview.html content.",
+    description: "Create and validate a local Revela design package from complete DESIGN.md, design.css, and optional legacy preview.html content.",
     inputSchema: objectSchema({
       name: requiredStringProp("Design name in kebab-case."),
       base: stringProp("Optional base design used as structural scaffold."),
       designMd: requiredStringProp("Complete DESIGN.md content."),
-      previewHtml: requiredStringProp("Complete preview.html content."),
+      designCss: stringProp("Complete design.css content. Required for CSS-native designs; omitted only for legacy compatibility."),
+      previewHtml: stringProp("Optional legacy preview.html content. Current design previews are generated with revela_design_preview."),
       assets: designAssetsProp(),
       overwrite: booleanProp("Whether to replace an existing local design package. Defaults to false."),
-    }, ["name", "designMd", "previewHtml"]),
+    }, ["name", "designMd"]),
   },
   {
     name: "revela_design_validate",
@@ -194,10 +268,11 @@ const tools = [
       name: requiredStringProp("Design name in kebab-case."),
       base: stringProp("Optional base design used as structural scaffold."),
       designMd: requiredStringProp("Complete DESIGN.md content."),
-      previewHtml: requiredStringProp("Complete preview.html content."),
+      designCss: stringProp("Complete design.css content. Required for CSS-native designs; omitted only for legacy compatibility."),
+      previewHtml: stringProp("Optional legacy preview.html content. Current design previews are generated with revela_design_preview."),
       assets: designAssetsProp(),
       overwrite: booleanProp("Whether to replace an existing workspace draft. Defaults to false."),
-    }, ["name", "designMd", "previewHtml"]),
+    }, ["name", "designMd"]),
   },
   {
     name: "revela_design_draft_validate",
@@ -207,6 +282,15 @@ const tools = [
       name: requiredStringProp("Design draft name to validate."),
     }, ["name"]),
   },
+  {
+    name: "revela_design_preview",
+    description: "Generate a workspace-local preview for a draft, installed, or built-in Revela design using the built-in page template preview fixture plus the design.css file.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Design name to preview."),
+      source: stringProp("Optional source: draft, installed, or builtin. Defaults to draft when present, otherwise installed/builtin."),
+    }, ["name"]),
+  },
   {
     name: "revela_design_draft_install",
     description: "Install a validated workspace-local Revela design draft into the user-level design registry.",
@@ -296,7 +380,7 @@ const tools = [
   },
   {
     name: "revela_review_deck_read",
-    description: "Read-only aggregate Review diagnostics for a Revela HTML deck: artifact QA, deck-plan diagnostics, and export/readiness signals.",
+    description: "Compatibility-only read of aggregate Review diagnostics for a Revela HTML deck: artifact QA, deck-plan diagnostics, and export/readiness signals.",
     inputSchema: objectSchema({
       workspaceRoot: stringProp("Optional workspace root."),
       file: requiredStringProp("Workspace-relative or absolute HTML deck path."),
@@ -305,7 +389,7 @@ const tools = [
   },
   {
     name: "revela_review_deck_open",
-    description: "Open a local Codex-backed Review UI for a Revela HTML deck from the current MCP server process.",
+    description: "Compatibility-only opener for the legacy local Codex-backed Review UI for a Revela HTML deck.",
     inputSchema: objectSchema({
       workspaceRoot: stringProp("Optional workspace root."),
       file: requiredStringProp("Workspace-relative or absolute HTML deck path."),
@@ -421,6 +505,13 @@ async function callTool(name: string, args: any): Promise<any> {
   if (name === "revela_read_deck_plan") return r.readDeckPlan(args)
   if (name === "revela_upsert_deck_plan_slide") return r.upsertDeckPlanSlide(args)
   if (name === "revela_create_deck_foundation") return r.createDeckFoundation(args)
+  if (name === "revela_list_page_templates") return r.listPageTemplates()
+  if (name === "revela_render_template_slide") return r.renderTemplateSlide(args)
+  if (name === "revela_add_template_slide") return r.addTemplateSlide(args)
+  if (name === "revela_page_template_foundation") return r.pageTemplateFoundation(args)
+  if (name === "revela_page_template_vocabulary") return r.pageTemplateVocabulary(args)
+  if (name === "revela_render_template_scaffold") return r.renderTemplateScaffold(args)
+  if (name === "revela_add_template_scaffold") return r.addTemplateScaffold(args)
   if (name === "revela_run_deck_qa") return r.runDeckQa(args)
   if (name === "revela_export_pdf") return r.exportPdf(args)
   if (name === "revela_export_pptx") return r.exportPptx(args)
@@ -435,6 +526,7 @@ async function callTool(name: string, args: any): Promise<any> {
   if (name === "revela_design_validate") return r.designValidate(args)
   if (name === "revela_design_draft_create") return r.designDraftCreate(args)
   if (name === "revela_design_draft_validate") return r.designDraftValidate(args)
+  if (name === "revela_design_preview") return r.designPreview(args)
   if (name === "revela_design_draft_install") return r.designDraftInstall(args)
   if (name === "revela_design_pack") return r.designPack(args)
   if (name === "revela_design_install_archive") return r.designInstallArchive(args)
@@ -496,6 +588,10 @@ function arrayProp(description: string) {
   return { type: "array", items: { type: "string" }, description }
 }
 
+function objectProp(description: string) {
+  return { type: "object", description, additionalProperties: true }
+}
+
 function stringOrArrayProp(description: string) {
   return {
     anyOf: [

package/plugins/revela/skills/revela/SKILL.md

@@ -11,7 +11,7 @@ Use this skill as the main Revela entrypoint in Codex. It should inspect intent
 
 - This is a non-mutating router.
 - It may inspect runtime, active design/domain, and workspace artifact status.
-- It must not write `spec.md`, save research findings, write `deck-plan.md`, generate deck HTML, open Review UI, or export artifacts.
+- It must not write `spec.md`, save research findings, write `deck-plan.md`, generate deck HTML, open deck browser views, or export artifacts.
 - Route quickly once the next workflow is clear.
 
 ## Required Tools
@@ -29,7 +29,7 @@ Use this skill as the main Revela entrypoint in Codex. It should inspect intent
 - `spec.md` exists but source support, material review, or findings are missing: use `revela-research`.
 - `spec.md` and sufficient findings exist but `deck-plan.md` is missing or needs normal authoring: use `revela-research` Planning Handoff.
 - Valid `deck-plan.md` exists and the user asks to make, generate, render, or update a deck: use `revela-make-deck`.
-- Existing deck artifact and the user asks to review, diagnose, QA, or refine: use `revela-review`.
+- Existing deck artifact and the user asks to review, annotate, diagnose, QA, or refine: use Codex Browser's native browsing/annotation flow. If the deck was not just generated, reply with the existing deck as a website card/link and use native annotations after it opens; route export requests to `revela-export`.
 - Existing deck artifact and the user asks for PDF, PPTX, or PNG output: use `revela-export`.
 - If the next step is still ambiguous after inspection, ask the smallest missing question and recommend the safest next specialist skill.
 
@@ -47,5 +47,5 @@ Report:
 - Do not write or patch files.
 - Do not do external web research.
 - Do not create or repair `spec.md` or `deck-plan.md`.
-- Do not generate, review, patch, or export deck artifacts.
+- Do not generate, annotate, patch, or export deck artifacts.
 - Do not install or activate designs or domains; route those requests to `revela-design` or `revela-domain`.