@cyber-dash-tech/revela 0.1.13 → 0.1.15

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 Revela is an [OpenCode](https://opencode.ai) plugin that turns your current agent into an HTML slide deck generator.
-Enable it for a session, give the agent a presentation task, and it can research, structure, write, and QA a complete deck in `slides/*.html`.
+Enable it for a session, give the agent a presentation task, and it can research, structure, write, and QA a complete deck in `decks/*.html`.
 
 **[Live Demo — The AI Power Shift](https://cyber-dash-tech.github.io/revela/assets/html/ai-power-shift.html)** · A 5-slide investment brief generated with Revela.
 
@@ -99,13 +99,13 @@ Enable Revela in the current session:
 Then give the agent a slide task, for example:
 
 ```text
-Create a 6-slide HTML deck on humanoid robotics supply chains. Use the summit design, cite the main market drivers, and save the result to slides/humanoid-robotics.html.
+Create a 6-slide HTML deck on humanoid robotics supply chains. Use the summit design, cite the main market drivers, and save the result to decks/humanoid-robotics.html.
 ```
 
 Export the resulting HTML deck to PDF if needed:
 
 ```text
-/revela pdf slides/humanoid-robotics.html
+/revela pdf decks/humanoid-robotics.html
 ```
 
 Disable Revela and return the current agent to normal mode:
@@ -175,7 +175,7 @@ Revela transparently extracts text from these binary files before the main agent
 
 ## Layout QA And Compliance
 
-Every time the agent writes `slides/*.html`, Revela automatically runs a Puppeteer-based QA pass at `1920x1080`.
+Every time the agent writes `decks/*.html`, Revela automatically runs a Puppeteer-based QA pass at `1920x1080`.
 The QA report is fed back immediately so the agent can fix layout or compliance problems before moving on.
 
 Current QA dimensions:
@@ -313,7 +313,7 @@ A custom domain is a folder containing `INDUSTRY.md` with frontmatter metadata s
 Export a generated HTML deck to PDF:
 
 ```text
-/revela pdf slides/my-deck.html
+/revela pdf decks/my-deck.html
 ```
 
 Revela renders each slide through Chrome/Chromium and assembles the final PDF in the same directory.

package/README.zh-CN.md

@@ -9,7 +9,7 @@
 </p>
 
 Revela 是一个 [OpenCode](https://opencode.ai) 插件，可以把你当前使用的 agent 变成 HTML 幻灯片生成器。
-在当前会话中启用它之后，agent 可以完成调研、结构设计、HTML 写作和自动 QA，并把结果输出到 `slides/*.html`。
+在当前会话中启用它之后，agent 可以完成调研、结构设计、HTML 写作和自动 QA，并把结果输出到 `decks/*.html`。
 
 **[在线演示 — AI 权力转移](https://cyber-dash-tech.github.io/revela/assets/html/ai-power-shift.html)** · 一份使用 Revela 生成的 5 页投资简报。
 
@@ -99,13 +99,13 @@ opencode
 然后直接给 agent 一个幻灯片任务，例如：
 
 ```text
-Create a 6-slide HTML deck on humanoid robotics supply chains. Use the summit design, cite the main market drivers, and save the result to slides/humanoid-robotics.html.
+Create a 6-slide HTML deck on humanoid robotics supply chains. Use the summit design, cite the main market drivers, and save the result to decks/humanoid-robotics.html.
 ```
 
 如果需要，把生成好的 HTML 导出为 PDF：
 
 ```text
-/revela pdf slides/humanoid-robotics.html
+/revela pdf decks/humanoid-robotics.html
 ```
 
 关闭 Revela，让当前 agent 回到普通模式：
@@ -175,7 +175,7 @@ Revela 会在主 agent 处理这些文件前，先透明地完成文本提取。
 
 ## 布局 QA 与合规检查
 
-每次 agent 写入 `slides/*.html` 时，Revela 都会自动在 `1920x1080` 分辨率下运行一轮基于 Puppeteer 的 QA。
+每次 agent 写入 `decks/*.html` 时，Revela 都会自动在 `1920x1080` 分辨率下运行一轮基于 Puppeteer 的 QA。
 报告会立刻反馈给 agent，用于继续修正布局或 design compliance 问题。
 
 当前 QA 维度如下：
@@ -313,7 +313,7 @@ Revela 会从 design 中提取允许使用的 CSS class vocabulary，并在 QA
 把生成好的 HTML deck 导出为 PDF：
 
 ```text
-/revela pdf slides/my-deck.html
+/revela pdf decks/my-deck.html
 ```
 
 Revela 会通过 Chrome / Chromium 渲染每一页 slide，并在同目录生成最终 PDF。

package/lib/commands/help.ts

@@ -7,6 +7,7 @@
 import { activeDesign } from "../design/designs"
 import { activeDomain } from "../domain/domains"
 import { ctx } from "../ctx"
+import pkg from "../../package.json"
 
 export async function handleHelp(
   send: (text: string) => Promise<void>,
@@ -16,7 +17,7 @@ export async function handleHelp(
   const status = ctx.enabled ? "enabled ✓" : "disabled"
   await send(
     `\`\`\`\n` +
-    `             R E V E L A\n` +
+    `             R E V E L A   v${pkg.version}\n` +
     `\`\`\`\n` +
     `**Status:** ${status}\n` +
     `🟠 **Design:** \`${design}\`\n` +

package/lib/commands/pdf.ts

@@ -4,7 +4,7 @@
  * Handler for `/revela pdf <file_path>` — exports an HTML slide deck to PDF.
  *
  * Output: same directory and base name as the input, with .pdf extension.
- * Example: slides/my-deck.html → slides/my-deck.pdf
+ * Example: decks/my-deck.html → decks/my-deck.pdf
  */
 
 import { resolve } from "path"
@@ -17,7 +17,7 @@ export async function handlePdf(
   if (!filePath) {
     await send(
       "**Usage:** `/revela pdf <file_path>`\n\n" +
-      "Example: `/revela pdf slides/my-deck.html`"
+      "Example: `/revela pdf decks/my-deck.html`"
     )
     return
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "OpenCode plugin that turns AI into an HTML slide deck generator",
   "type": "module",
   "main": "./index.ts",

package/plugin.ts

@@ -343,7 +343,7 @@ const server: Plugin = (async (pluginCtx) => {
     // Handles PDF and images — read tool succeeds with base64 attachment.
     // PDF: extract text, remove base64. Images: jimp compress.
     //
-    // Also handles: auto layout QA after writing slides/*.html
+    // Also handles: auto layout QA after writing decks/*.html
     "tool.execute.after": async (input, output) => {
       if (!ctx.enabled) return
 
@@ -360,11 +360,11 @@ const server: Plugin = (async (pluginCtx) => {
         return
       }
 
-      // ── Auto layout QA after writing slides/*.html ─────────────────────
+      // ── Auto layout QA after writing decks/*.html ─────────────────────
       if (input.tool === "write") {
         const filePath: string = input.args?.filePath ?? ""
-        // Only trigger for HTML files inside a slides/ directory
-        if (!filePath.match(/slides\/[^/]+\.html$/)) return
+        // Only trigger for HTML files inside a decks/ directory
+        if (!filePath.match(/decks\/[^/]+\.html$/)) return
 
         try {
           // Extract design's allowed class vocabulary for compliance checking

package/skill/SKILL.md

@@ -38,7 +38,7 @@ to Phase 1.5.
 
 Once you have the user's answers, **derive the deck slug** from the topic:
 lowercase, hyphens, no spaces (e.g. "AI Investment Shift" → `ai-investment-shift`).
-Tell the user: "I'll save this deck as `slides/{slug}.html`." They can correct the
+Tell the user: "I'll save this deck as `decks/{slug}.html`." They can correct the
 name at this point.
 
 ### Phase 1.5 — Deck Initialization & Resume Check
@@ -65,7 +65,7 @@ After confirming the deck slug, check whether this deck has been worked on befor
    - **c** → proceed to Phase 2 normally (full research)
 
 All subsequent file paths in this session use the confirmed slug:
-- Slides file: `slides/{slug}.html`
+- Slides file: `decks/{slug}.html`
 - Research dir: `researches/{slug}/`
 
 ### Phase 2 — Select Design
@@ -345,19 +345,19 @@ Then ask:
 Once the fetch is complete, generate the complete HTML file in one shot.
 
 - Output **only** the raw HTML — no markdown fences, no explanation before or after
-- Create a `slides/` directory in the current working directory if it doesn't already exist
-- Write the file to `slides/{slug}.html` using the deck slug confirmed in Phase 1.5
+- Create a `decks/` directory in the current working directory if it doesn't already exist
+- Write the file to `decks/{slug}.html` using the deck slug confirmed in Phase 1.5
 - The file must be completely self-contained (all CSS and JS inline)
 
 ### Phase 6 — Iterate
 
 After generating, briefly tell the user:
-- The filename you wrote (e.g. `slides/ai-future.html`)
+- The filename you wrote (e.g. `decks/ai-future.html`)
 - How to navigate (arrow keys / swipe)
 - One line invitation to request changes
 
 For change requests: re-generate the **entire** file (don't patch). Apply the
-change and silently overwrite the same `slides/{slug}.html` filename.
+change and silently overwrite the same `decks/{slug}.html` filename.
 
 ---
 
@@ -474,11 +474,11 @@ decorative fill patterns.
 
 | Topic | Filename |
 |-------|----------|
-| "AI in Healthcare" | `slides/ai-in-healthcare.html` |
-| "Q3 Sales Review" | `slides/q3-sales-review.html` |
-| "Intro to Python" | `slides/intro-to-python.html` |
+| "AI in Healthcare" | `decks/ai-in-healthcare.html` |
+| "Q3 Sales Review" | `decks/q3-sales-review.html` |
+| "Intro to Python" | `decks/intro-to-python.html` |
 
-Lowercase, hyphens, no spaces, `.html` extension. Always place files inside the `slides/` subdirectory.
+Lowercase, hyphens, no spaces, `.html` extension. Always place files inside the `decks/` subdirectory.
 
 ---
 

package/tools/qa.ts

@@ -5,7 +5,7 @@
  *
  * Exposed to the LLM so it can run layout checks after writing a slides file.
  * Also called automatically by the tool.execute.after hook in plugin.ts
- * when the LLM writes a file matching slides/*.html.
+ * when the LLM writes a file matching decks/*.html.
  */
 
 import { tool } from "@opencode-ai/plugin"
@@ -21,7 +21,7 @@ export default tool({
     "Checks for: canvas underfill (too much empty space), bottom whitespace, " +
     "left-right column asymmetry, element overflow, and card height variance. " +
     "Returns a structured report with specific issues and fix instructions. " +
-    "Call this after writing or editing any slides/*.html file to verify layout quality.",
+    "Call this after writing or editing any decks/*.html file to verify layout quality.",
   args: {
     file: tool.schema
       .string()