@cyber-dash-tech/revela 0.17.24 → 0.18.2

package/plugin.ts

@@ -44,6 +44,7 @@ import {
 } from "./lib/commands/domains"
 import { handlePdf } from "./lib/commands/pdf"
 import { buildPptxNotesPrompt, handlePptx, parsePptxArgs, resolvePptxDeck } from "./lib/commands/pptx"
+import { handlePng } from "./lib/commands/png"
 import { handleRefine } from "./lib/commands/refine"
 import { formatArtifactQAReport, runArtifactQA } from "./lib/qa/artifact"
 import { ensureRefineDeckOpenForChange } from "./lib/refine/open"
@@ -57,9 +58,7 @@ import {
 } from "./lib/commands/designs-new"
 import { buildInitPrompt } from "./lib/commands/init"
 import { buildResearchPrompt } from "./lib/commands/research"
-import { handleBrief, parseBriefArgs } from "./lib/commands/brief"
-import { buildNarrativeViewPrompt, parseStoryArgs } from "./lib/commands/narrative"
-import { buildDeckPrompt } from "./lib/commands/review"
+import { buildDeckMakePrompt, buildDeckPlanPrompt } from "./lib/commands/review"
 import {
   extractDeckHtmlTargetsFromPatch,
   extractPatchTextArg,
@@ -87,9 +86,6 @@ import mediaBatchSaveTool from "./tools/media-batch-save"
 import mediaSaveTool from "./tools/media-save"
 import researchImagesListTool from "./tools/research-images-list"
 import researchSaveTool from "./tools/research-save"
-import inspectionContextTool from "./tools/inspection-context"
-import inspectionResultTool from "./tools/inspection-result"
-import narrativeViewTool from "./tools/narrative-view"
 import workspaceScanTool from "./tools/workspace-scan"
 import extractDocumentMaterialsTool from "./tools/extract-document-materials"
 import qaTool from "./tools/qa"
@@ -356,24 +352,32 @@ const server: Plugin = (async (pluginCtx) => {
             sessionID,
             name: "make --deck",
             mode: "deck-render",
-            visibleText: "Make Revela deck from approved story.",
-            hiddenPrompt: buildDeckPrompt({ exists: hasDecksState(workspaceRoot), workspaceRoot }),
+            visibleText: "Make Revela deck from deck-plan.",
+            hiddenPrompt: buildDeckMakePrompt({ exists: hasDecksState(workspaceRoot), workspaceRoot }),
             output,
           })
           return
         }
-        if (target === "--brief") {
-          const parsed = parseBriefArgs(makeParam)
-          if (!parsed.ok) {
-            await send(parsed.error.replace("/revela brief", "/revela make --brief"))
-            throw new Error("__REVELA_MAKE_BRIEF_USAGE_HANDLED__")
-          }
-          await handleBrief({ workspaceRoot, outputPath: parsed.args.outputPath }, send)
-          throw new Error("__REVELA_MAKE_BRIEF_HANDLED__")
-        }
-        await send("Usage: `/revela make --deck` or `/revela make --brief [workspace-relative-output.md]`.")
+        await send("Usage: `/revela make --deck`.")
         throw new Error("__REVELA_MAKE_USAGE_HANDLED__")
       }
+      if (sub === "plan") {
+        const target = args[1]?.toLowerCase() ?? ""
+        const planParam = args.slice(2).join(" ")
+        if (target !== "--deck" || planParam) {
+          await send("Usage: `/revela plan --deck`.")
+          throw new Error("__REVELA_PLAN_USAGE_HANDLED__")
+        }
+        queueWorkflowCommand({
+          sessionID,
+          name: "plan --deck",
+          mode: "deck-render",
+          visibleText: "Plan Revela deck from local materials and research.",
+          hiddenPrompt: buildDeckPlanPrompt({ exists: hasDecksState(workspaceRoot), workspaceRoot }),
+          output,
+        })
+        return
+      }
       if (sub === "review") {
         if (param !== "--deck") {
           await send("Usage: `/revela review --deck`.")
@@ -395,14 +399,18 @@ const server: Plugin = (async (pluginCtx) => {
         const target = args[1]?.toLowerCase() ?? ""
         const format = args[2]?.toLowerCase() ?? ""
         const exportParam = args.slice(3).join(" ")
-        if (target !== "--deck" || (format !== "pdf" && format !== "pptx")) {
-          await send("Usage: `/revela export --deck pdf [file.html]` or `/revela export --deck pptx [file.html] [--notes]`.")
+        if (target !== "--deck" || (format !== "pdf" && format !== "pptx" && format !== "png")) {
+          await send("Usage: `/revela export --deck pdf [file.html]`, `/revela export --deck pptx [file.html] [--notes]`, or `/revela export --deck png [file.html]`.")
           throw new Error("__REVELA_EXPORT_USAGE_HANDLED__")
         }
         if (format === "pdf") {
           await handlePdf(exportParam, send, workspaceRoot)
           throw new Error("__REVELA_EXPORT_PDF_HANDLED__")
         }
+        if (format === "png") {
+          await handlePng(exportParam, send, workspaceRoot)
+          throw new Error("__REVELA_EXPORT_PNG_HANDLED__")
+        }
         const pptxArgs = parsePptxArgs(exportParam)
         if (pptxArgs.notes) {
           try {
@@ -530,7 +538,7 @@ const server: Plugin = (async (pluginCtx) => {
         throw new Error("__REVELA_DOMAIN_USAGE_HANDLED__")
       }
       const legacyCommands = new Set([
-        "review", "narrative", "deck", "brief", "edit", "inspect", "remember",
+        "narrative", "deck", "brief", "edit", "inspect", "story", "remember",
         "designs", "designs-new", "designs-edit", "designs-preview", "designs-add", "designs-rm",
         "domains", "domains-add", "domains-rm", "pdf", "pptx",
       ])
@@ -551,35 +559,19 @@ const server: Plugin = (async (pluginCtx) => {
       }
       if (sub === "research") {
         if (param) {
-          await send("`/revela research` does not accept arguments yet. Add the research question in normal chat, or run it to work from open story gaps.")
+          await send("`/revela research` does not accept arguments yet. Add the research question in normal chat, or run it to work from deck inputs and unresolved source needs.")
           throw new Error("__REVELA_RESEARCH_USAGE_HANDLED__")
         }
         queueWorkflowCommand({
           sessionID,
           name: "research",
           mode: "narrative",
-          visibleText: "Research Revela story gaps.",
+          visibleText: "Research Revela deck inputs.",
           hiddenPrompt: buildResearchPrompt({ exists: hasDecksState(workspaceRoot), workspaceRoot }),
           output,
         })
         return
       }
-      if (sub === "story") {
-        const parsed = parseStoryArgs(param)
-        if (!parsed.ok) {
-          await send(parsed.error)
-          throw new Error("__REVELA_STORY_USAGE_HANDLED__")
-        }
-        queueWorkflowCommand({
-          sessionID,
-          name: "story",
-          mode: "narrative",
-          visibleText: "Open Revela story workspace.",
-          hiddenPrompt: buildNarrativeViewPrompt({ workspaceRoot, language: parsed.args.language }),
-          output,
-        })
-        return
-      }
 
       await send(`**Unknown sub-command:** \`${sub}\`\nRun \`/revela\` to see available commands.`)
       throw new Error("__REVELA_UNKNOWN_HANDLED__")
@@ -596,9 +588,6 @@ const server: Plugin = (async (pluginCtx) => {
       "revela-media-save": mediaSaveTool,
       "revela-research-images-list": researchImagesListTool,
       "revela-research-save": researchSaveTool,
-      "revela-inspection-context": inspectionContextTool,
-      "revela-inspection-result": inspectionResultTool,
-      "revela-narrative-view": narrativeViewTool,
       "revela-workspace-scan": workspaceScanTool,
       "revela-extract-document-materials": extractDocumentMaterialsTool,
       "revela-qa": qaTool,

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

@@ -20,7 +20,7 @@
   "interface": {
     "displayName": "Revela",
     "shortDescription": "Trusted narrative artifacts from local sources and research.",
-    "longDescription": "Revela helps Codex initialize a narrative vault, bind evidence, plan decks, generate artifact foundations, run QA, and export decision artifacts while preserving source traceability.",
+    "longDescription": "Revela helps Codex ingest local materials, save research findings, plan decks, generate HTML deck artifacts, review them, and export PDF/PPTX/PNG outputs while preserving source traceability.",
     "developerName": "cyber-dash-tech",
     "category": "Productivity",
     "capabilities": [
@@ -29,7 +29,7 @@
     ],
     "defaultPrompt": [
       "Use Revela to initialize this workspace.",
-      "Use Revela to make a deck from the narrative.",
+      "Use Revela to make a deck from the deck plan.",
       "Use Revela to review this deck artifact."
     ],
     "brandColor": "#2563EB"

package/plugins/revela/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "revela": {
       "command": "npx",
-      "args": ["-y", "@cyber-dash-tech/revela@0.17.24", "mcp"]
+      "args": ["-y", "@cyber-dash-tech/revela@0.18.2", "mcp"]
     }
   }
 }

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

@@ -10,14 +10,13 @@ type JsonRpcRequest = {
 
 type RuntimeModule = {
   doctor(input?: any): any
-  compileNarrative(input?: any): any
-  markdownQa(input?: any): any
   readDeckPlan(input?: any): any
   upsertDeckPlanSlide(input: any): any
   createDeckFoundation(input: any): any
   runDeckQa(input: any): Promise<any>
   exportPdf(input: any): Promise<any>
   exportPptx(input: any): Promise<any>
+  exportPng(input: any): Promise<any>
   designList(): any
   designRead(input?: any): any
   designInventory(input?: any): any
@@ -37,13 +36,9 @@ type RuntimeModule = {
   domainDraftCreate(input: any): any
   domainDraftValidate(input: any): any
   domainDraftInstall(input: any): any
-  storyRead(input?: any): any
   reviewDeckRead(input: any): Promise<any>
   reviewDeckOpen(input: any): Promise<any>
-  researchTargets(input?: any): any
   researchSave(input: any): any
-  evaluateResearchFindings(input: any): any
-  bindResearchFindings(input: any): any
   prepareLocalMaterials(input: any): Promise<any>
   extractMaterial(input: any): Promise<any>
   recordMaterialReview(input: any): any
@@ -58,32 +53,18 @@ const tools = [
     description: "Inspect Revela workspace availability and basic file-native state.",
     inputSchema: objectSchema({ workspaceRoot: stringProp("Optional workspace root.") }),
   },
-  {
-    name: "revela_compile_narrative",
-    description: "Compile revela-narrative/ Markdown into canonical NarrativeStateV1 diagnostics.",
-    inputSchema: objectSchema({ workspaceRoot: stringProp("Optional workspace root.") }),
-  },
-  {
-    name: "revela_markdown_qa",
-    description: "Run Markdown QA for the Revela narrative vault.",
-    inputSchema: objectSchema({
-      workspaceRoot: stringProp("Optional workspace root."),
-      scope: enumProp(["touched", "affected", "full"], "QA scope."),
-      strictness: enumProp(["authoring", "readiness", "render"], "QA strictness."),
-      touched: arrayProp("Touched vault files."),
-    }),
-  },
   {
     name: "revela_read_deck_plan",
-    description: "Read the file-native deck-plan/ projection and diagnostics.",
+    description: "Read canonical deck-plan.md projection and diagnostics, with legacy deck-plan/ fallback support.",
     inputSchema: objectSchema({ workspaceRoot: stringProp("Optional workspace root.") }),
   },
   {
     name: "revela_upsert_deck_plan_slide",
-    description: "Create or update one structured deck-plan/slides/*.md slide plan with active/requested design vocabulary validation.",
+    description: "Compatibility/repair helper for creating or updating one slide block in canonical deck-plan.md with active/requested design vocabulary validation. Normal planning should write deck-plan.md directly and use revela_read_deck_plan for diagnostics.",
     inputSchema: objectSchema({
       workspaceRoot: stringProp("Optional workspace root."),
       designName: stringProp("Optional design name. Defaults to the active design."),
+      outputPath: stringProp("Optional workspace-relative HTML output path."),
       slideIndex: requiredNumberProp("Positive 1-based slide index."),
       id: stringProp("Optional stable slide node id."),
       title: requiredStringProp("Slide title."),
@@ -93,9 +74,10 @@ const tools = [
       layout: requiredStringProp("Design layout name from inventory."),
       components: componentPlanArrayProp(),
       visualIntent: visualIntentProp(),
+      sourceLinks: sourceLinksProp(),
       narrativeLinks: narrativeLinksProp(),
       caveats: arrayProp("Optional caveats to keep visible in the slide plan."),
-    }, ["slideIndex", "title", "chapter", "narrativeRole", "layout", "components", "visualIntent", "narrativeLinks"]),
+    }, ["slideIndex", "title", "chapter", "narrativeRole", "layout", "components", "visualIntent"]),
   },
   {
     name: "revela_create_deck_foundation",
@@ -134,6 +116,15 @@ const tools = [
       file: requiredStringProp("Workspace-relative or absolute HTML deck path."),
     }, ["file"]),
   },
+  {
+    name: "revela_export_png",
+    description: "Export a Revela HTML deck to one PNG file per slide.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      file: requiredStringProp("Workspace-relative or absolute HTML deck path."),
+      outputDir: stringProp("Optional workspace-relative output directory."),
+    }, ["file"]),
+  },
   {
     name: "revela_design_list",
     description: "List installed Revela designs and the active design.",
@@ -277,17 +268,9 @@ const tools = [
       overwrite: booleanProp("Whether to replace an existing user-level domain package. Defaults to false."),
     }, ["name"]),
   },
-  {
-    name: "revela_story_read",
-    description: "Read a deterministic Revela Story map and optional Markdown view from the canonical narrative vault without mutating files.",
-    inputSchema: objectSchema({
-      workspaceRoot: stringProp("Optional workspace root."),
-      format: enumProp(["map", "markdown"], "Return only the map, or include a formatted Markdown reading view."),
-    }),
-  },
   {
     name: "revela_review_deck_read",
-    description: "Read-only aggregate Review diagnostics for a Revela HTML deck: artifact QA, deck-plan diagnostics, narrative/vault diagnostics, artifact coverage, and available evidence trace.",
+    description: "Read-only 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."),
@@ -300,18 +283,13 @@ const tools = [
     inputSchema: objectSchema({
       workspaceRoot: stringProp("Optional workspace root."),
       file: requiredStringProp("Workspace-relative or absolute HTML deck path."),
-      bridge: enumProp(["codex-exec"], "Prompt bridge for browser Insight and Comment interactions."),
+      bridge: enumProp(["codex-exec"], "Prompt bridge for browser Comment and Apply Fix interactions."),
       openBrowser: booleanProp("Whether the tool should open the browser itself. Defaults to true when omitted."),
     }, ["file"]),
   },
-  {
-    name: "revela_research_targets",
-    description: "Derive current Revela research targets from canonical narrative state, saved findings, and evidence gaps.",
-    inputSchema: objectSchema({ workspaceRoot: stringProp("Optional workspace root.") }),
-  },
   {
     name: "revela_research_save",
-    description: "Save research findings under researches/{topic}/{filename}.md and evaluate binding readiness when workspace state exists.",
+    description: "Save source-linked research findings under researches/{topic}/{filename}.md for deck-plan use.",
     inputSchema: objectSchema({
       workspaceRoot: stringProp("Optional workspace root."),
       topic: requiredStringProp("Research topic key."),
@@ -320,23 +298,6 @@ const tools = [
       sources: arrayProp("Source URLs or workspace files for YAML frontmatter."),
     }, ["topic", "filename", "content"]),
   },
-  {
-    name: "revela_evaluate_research_findings",
-    description: "Evaluate whether a saved researches/**/*.md findings file is safely bindable as canonical evidence.",
-    inputSchema: objectSchema({
-      workspaceRoot: stringProp("Optional workspace root."),
-      findingsFile: requiredStringProp("Workspace-relative researches/**/*.md findings file."),
-    }, ["findingsFile"]),
-  },
-  {
-    name: "revela_bind_research_findings",
-    description: "Bind a safely evaluated findings file into canonical revela-narrative/evidence/*.md evidence.",
-    inputSchema: objectSchema({
-      workspaceRoot: stringProp("Optional workspace root."),
-      findingsFile: requiredStringProp("Workspace-relative researches/**/*.md findings file."),
-      evidenceId: stringProp("Optional canonical evidence node id override."),
-    }, ["findingsFile"]),
-  },
   {
     name: "revela_prepare_local_materials",
     description: "Scan local workspace source materials, create/update the material-intake registry, and optionally extract Office/PDF files into read views.",
@@ -431,14 +392,13 @@ async function handle(req: JsonRpcRequest): Promise<any | undefined> {
 async function callTool(name: string, args: any): Promise<any> {
   const r = await runtime()
   if (name === "revela_doctor") return r.doctor(args)
-  if (name === "revela_compile_narrative") return r.compileNarrative(args)
-  if (name === "revela_markdown_qa") return r.markdownQa(args)
   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_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)
+  if (name === "revela_export_png") return r.exportPng(args)
   if (name === "revela_design_list") return r.designList()
   if (name === "revela_design_read") return r.designRead(args)
   if (name === "revela_design_inventory") return r.designInventory(args)
@@ -458,13 +418,9 @@ async function callTool(name: string, args: any): Promise<any> {
   if (name === "revela_domain_draft_create") return r.domainDraftCreate(args)
   if (name === "revela_domain_draft_validate") return r.domainDraftValidate(args)
   if (name === "revela_domain_draft_install") return r.domainDraftInstall(args)
-  if (name === "revela_story_read") return r.storyRead(args)
   if (name === "revela_review_deck_read") return r.reviewDeckRead(args)
   if (name === "revela_review_deck_open") return r.reviewDeckOpen(args)
-  if (name === "revela_research_targets") return r.researchTargets(args)
   if (name === "revela_research_save") return r.researchSave(args)
-  if (name === "revela_evaluate_research_findings") return r.evaluateResearchFindings(args)
-  if (name === "revela_bind_research_findings") return r.bindResearchFindings(args)
   if (name === "revela_prepare_local_materials") return r.prepareLocalMaterials(args)
   if (name === "revela_extract_document_materials") return r.extractMaterial(args)
   if (name === "revela_record_material_review") return r.recordMaterialReview(args)
@@ -540,26 +496,33 @@ function arrayObjectProp(description: string) {
 }
 
 function componentPlanArrayProp() {
+  const childSchema: any = {
+    type: "object",
+    properties: {
+      name: { type: "string", description: "Design component name." },
+      slot: { type: "string", description: "Layout semantic slot from design inventory, such as left, right, top, bottom, fullbleed, or a numbered slot." },
+      position: { type: "string", description: "Slot-local kebab-case anchor, such as left-top, center, or overlay-top-right." },
+      purpose: { type: "string", description: "Component communication job." },
+      content: { type: "string", description: "Exact text, data, or structure to render." },
+      claimIds: { type: "array", items: { type: "string" } },
+      evidenceIds: { type: "array", items: { type: "string" } },
+      sourceNotes: { type: "array", items: { type: "string" } },
+      renderNotes: { type: "array", items: { type: "string" } },
+      placementNote: { type: "string" },
+    },
+    required: ["name", "slot", "position", "purpose", "content"],
+    additionalProperties: false,
+  }
+  const componentSchema: any = JSON.parse(JSON.stringify(childSchema))
+  componentSchema.properties.children = {
+    type: "array",
+    description: "Nested child components. Use box as the semantic container for grouped child content.",
+    items: childSchema,
+  }
   return {
     type: "array",
     description: "Structured component plan entries.",
-    items: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "Design component name." },
-        slot: { type: "string", description: "Layout semantic slot, such as left, right, top, main, bottom, footer, or fullbleed." },
-        position: { type: "string", description: "Slot-local kebab-case anchor, such as left-top, center, or overlay-top-right." },
-        purpose: { type: "string", description: "Component communication job." },
-        content: { type: "string", description: "Exact text, data, or structure to render." },
-        claimIds: { type: "array", items: { type: "string" } },
-        evidenceIds: { type: "array", items: { type: "string" } },
-        sourceNotes: { type: "array", items: { type: "string" } },
-        renderNotes: { type: "array", items: { type: "string" } },
-        placementNote: { type: "string" },
-      },
-      required: ["name", "slot", "position", "purpose", "content"],
-      additionalProperties: false,
-    },
+    items: componentSchema,
   }
 }
 
@@ -596,6 +559,21 @@ function narrativeLinksProp() {
   }
 }
 
+function sourceLinksProp() {
+  return {
+    type: "object",
+    description: "Deck-first source links. Use these instead of narrativeLinks for new plans.",
+    properties: {
+      materials: { type: "array", items: { type: "string" } },
+      findings: { type: "array", items: { type: "string" } },
+      assets: { type: "array", items: { type: "string" } },
+      urls: { type: "array", items: { type: "string" } },
+      caveats: { type: "array", items: { type: "string" } },
+    },
+    additionalProperties: false,
+  }
+}
+
 function writeMessage(message: any, mode: MessageMode = activeResponseMode): void {
   activeResponseMode = mode
   const body = JSON.stringify(message)

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

@@ -11,7 +11,7 @@ Use this skill when the user asks about Revela designs or when generating deck H
 
 1. Call `revela_design_list` to inspect installed designs.
 2. Call `revela_design_read` with `section: "rules"` before writing or patching `decks/*.html`; this records the Codex hook context required for deck writes.
-3. Call `revela_design_inventory` before authoring or repairing `deck-plan/` so planned layout/component names come from the active design. Use `revela_upsert_deck_plan_slide` for slide-plan writes; do not hand-write slide plan Markdown.
+3. Call `revela_design_inventory` before authoring or repairing `deck-plan.md` so planned layout names, slots, component names, and nesting hints come from the active design. Write slide plan Markdown directly, then call `revela_read_deck_plan` for diagnostics.
 4. Read required details with `revela_design_read_layout` and `revela_design_read_component` before writing slide HTML that uses those layouts/components.
 5. When the user asks to switch designs for future work, call `revela_design_activate` with the requested design name, then read the active design again.
 6. For one-off deck generation with a requested design, read that design by name, call `revela_design_inventory` with that name, and pass `designName` to `revela_create_deck_foundation` without changing active design unless the user asked to switch.
@@ -25,7 +25,9 @@ Design changes are visual/artifact-level unless they change claim meaning, evide
 
 ## Inventory-First Planning
 
-Deck planning uses design vocabulary before HTML. Inspect the inventory, choose a valid layout for each slide, and choose valid component names for each planned element. Every component plan must include a semantic `slot` such as `left`, `right`, `top`, `main`, `bottom`, `footer`, or `fullbleed`, plus a non-empty kebab-case `position` such as `left-top`, `left-middle`, `right-bottom`, `center`, or `overlay-top-right`.
+Deck planning uses design vocabulary before HTML. Inspect the inventory, choose a valid layout for each slide, and choose valid component names for each planned element. Every top-level component plan must use a `slot` returned by the selected layout's inventory entry, plus a non-empty kebab-case `position` such as `left-top`, `left-middle`, `right-bottom`, `center`, or `overlay-top-right`.
+
+Use `box` as the semantic container when several child components support one idea. Put children under `box.children`; do not repeat those child components as separate top-level component plan entries. `hero` is fullbleed-only, while `page-number` and `brand-watermark` are utilities.
 
 Use `placementNote` for natural-language placement detail when slot and position are not enough. Slot and position are planning anchors; before HTML generation, fetch the actual layout/component definitions and implement the final structure with the design's CSS and markup.
 

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

@@ -1,6 +1,6 @@
 ---
 name: revela-domain
-description: Use or switch Revela narrative domain guidance in Codex for init, research, and story work.
+description: Use or switch Revela domain guidance in Codex for init, research, and deck planning work.
 ---
 
 # Revela Domain

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

@@ -1,6 +1,6 @@
 ---
 name: revela-export
-description: Export Revela deck artifacts from Codex to PDF or PPTX.
+description: Export Revela deck artifacts from Codex to PDF, PPTX, or PNG.
 ---
 
 # Revela Export
@@ -12,10 +12,9 @@ Use this skill when the user asks to export a Revela deck.
 1. Resolve the target HTML deck path.
 2. For PDF, call `revela_export_pdf`.
 3. For PPTX, call `revela_export_pptx`.
-4. Report output path or export errors.
+4. For per-slide PNG files, call `revela_export_png`.
+5. Report output path(s), slide count, or export errors.
 
-`revela_run_deck_qa`, `revela_export_pdf`, and `revela_export_pptx` may launch a browser. In sandboxed Codex sessions, request user-approved command escalation when the browser cannot start inside the default sandbox.
+`revela_run_deck_qa`, `revela_export_pdf`, `revela_export_pptx`, and `revela_export_png` may launch a browser. In sandboxed Codex sessions, request user-approved command escalation when the browser cannot start inside the default sandbox.
 
 Post-write hooks and explicit QA tools surface Artifact QA failures. If the latest visible QA result has hard errors, repair them before treating the deck as export-ready.
-
-Do not treat narrative gaps as export blockers unless they affect technical artifact validity or data safety.

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

@@ -1,46 +1,31 @@
 ---
 name: revela-init
-description: Initialize or refresh a Revela narrative workspace in Codex from local source materials, preserving source traceability and file-native state.
+description: Initialize a Revela deck-first workspace in Codex from local source materials and material reviews.
 ---
 
 # Revela Init
 
-Use this skill when the user asks to start Revela, initialize the workspace, ingest local materials, or prepare a trusted narrative graph.
+Use this skill when the user asks to start Revela, initialize the workspace, ingest local materials, or prepare source inputs for a deck.
 
 ## Product Contract
 
-- `revela-narrative/` is the editable source of truth for communication meaning when present.
-- `NarrativeStateV1` is the compiled internal interface.
-- `deck-plan/` is render planning, not canonical meaning.
-- `decks/*.html` are artifacts.
-- `DECKS.json` is compatibility/cache state, not workflow authority.
-- Do not invent quotes, source paths, URLs, page references, caveats, claim ids, evidence ids, or artifact coverage.
+- Init prepares local source material intake; it does not create a Narrative Vault.
+- Durable deck-first state is local material intake, material review files, `researches/`, `deck-plan.md`, `assets/`, and `decks/*.html`.
+- Scan results prove only that files exist. A material is usable only after its direct text or extracted read view has been reviewed.
+- Do not invent quotes, source paths, URLs, page references, caveats, licenses, or artifact coverage.
 
 ## Workflow
 
-1. Call `revela_prepare_local_materials` first. Treat scan results as an intake registry and task list, not as source content.
-2. For any registry entry with `requiresExtraction: true`, do not read the original Office/PDF file directly for narrative intake. Use the returned `allowedReadPath` / `read_view_path`; if missing, call `revela_extract_document_materials` first.
-3. Prefer local source materials first: Markdown, text, CSV, PDFs, Office files, existing `researches/`, existing `revela-narrative/`, `deck-plan/`, and `decks/`.
-4. After reading extracted material views, call `revela_record_material_review` for each considered Office/PDF source. Record what was merged, deferred, ignored, or left as a gap.
-5. Call `revela_domain_list` and `revela_domain_read` for active domain guidance before authoring narrative meaning. Treat domain guidance as framing guidance, never as evidence.
-6. If `revela-narrative/` exists, call `revela_markdown_qa` and `revela_compile_narrative`.
-7. If the narrative vault is missing, create the initial `revela-narrative/` Markdown nodes directly with valid frontmatter and plain wikilink relations.
-8. Evidence nodes must preserve source, quote/snippet, support scope, unsupported scope, caveat, and strength before being treated as support.
-9. After writing narrative Markdown, call `revela_markdown_qa` and `revela_compile_narrative` again.
-10. Before the final report, call `revela_check_material_intake` and surface any warnings about scanned-but-unextracted, extracted-but-unreviewed, unsupported, failed, or text-only sources.
-11. End with a concise init report: local materials found, active domain, narrative graph status, material intake status, open gaps, Markdown QA status, and next command/action.
-
-## Material Intake Rules
-
-- Scan results only prove that files exist; they do not prove file content.
-- For `.docx`, `.pptx`, `.xlsx`, and `.pdf`, read the extracted `read_view_path` instead of using Codex/textutil/raw reads of the original file.
-- Extracted images are candidate materials only. Do not interpret them as evidence unless image meaning is explicitly reviewed or supplied by the user.
-- If a user explicitly asks for text-only inspection, report it as degraded intake and do not treat it as complete source review.
-
-## Markdown Rules
-
-- Use node types: `index`, `audience`, `decision`, `thesis`, `claim`, `evidence`, `objection`, `risk`, `research-gap`.
-- Use one leading frontmatter block per file.
-- Use `## Relations` with plain node-id wikilinks, such as `- supports: [[claim-recommendation]]`.
-- Do not use typed wikilinks such as `[[claim:claim-recommendation]]`.
-- Do not duplicate stable headings like `## Evidence`, `## Caveats`, `## Relations`, `## Response`, or `## Mitigation`.
+1. Call `revela_prepare_local_materials` first. Treat the result as an intake registry and task list.
+2. For Office/PDF sources, read `allowedReadPath` / `read_view_path`; if missing, call `revela_extract_document_materials`.
+3. Prefer local source materials first: Markdown, text, CSV, PDFs, Office files, existing `researches/`, `deck-plan.md`, `assets/`, and `decks/`.
+4. After reading extracted material views, call `revela_record_material_review` for each considered Office/PDF source.
+5. Call `revela_check_material_intake` before the final report and surface scanned-but-unreviewed, unsupported, failed, or text-only limitations.
+6. Ask only high-impact intent questions: audience, objective, decision/action, scope, language, source priority, or whether public research is allowed.
+7. End with an intake report: local materials found, read views reviewed, material reviews recorded, source limitations, captured user intent, and next command.
+
+## Report
+
+- Recommend `/revela research` when public/source support is still needed.
+- Recommend `/revela plan --deck` when enough local/research inputs exist.
+- Do not ask for layout, visual style, output path, export format, or approval during init.