@cyber-dash-tech/revela 0.7.6 → 0.7.8

package/README.md

@@ -140,7 +140,7 @@ Disable presentation mode when done:
 /revela init                     initialize or refresh workspace DECKS.json
 /revela review [slug]            review active deck readiness before writing HTML
 /revela remember <text>          save an explicit user/workflow preference
-/revela edit <target>            open visual comment editor for a deck slug or decks/*.html
+/revela edit [target]            open visual editor for active deck or a specific target
 
 /revela designs                  list installed designs
 /revela designs <name>           activate a design
@@ -591,13 +591,16 @@ A custom domain is a folder containing `INDUSTRY.md`.
 
 ## Visual Editing
 
-Open the visual editor for an existing deck by slug or workspace-relative HTML path:
+Open the visual editor for the active deck, or pass a slug / workspace-relative HTML path:
 
 ```text
+/revela edit
 /revela edit my-deck
 /revela edit decks/my-deck.html
 ```
 
+Without a target, `/revela edit` opens `DECKS.json.activeDeck`. If no active deck is set and there is exactly one deck in `DECKS.json`, it opens that deck.
+
 The editor opens in your browser. Use `Ctrl`/`Cmd` + click to reference deck elements, write a natural-language comment, then send it back to OpenCode. Revela sends a structured edit prompt that includes the deck file, slide context, selected element metadata, and your comment.
 
 LLM tool equivalent: `revela-edit` with `{ "target": "decks/my-deck.html" }`. This lets the agent open the same editor when you say things like “I want to edit @decks/my-deck.html”.

package/README.zh-CN.md

@@ -139,7 +139,7 @@ Create a 6-slide HTML deck on humanoid robotics supply chains. Cite the main mar
 /revela init                     初始化或刷新工作区 DECKS.json
 /revela review [slug]            写 HTML 前检查 active deck readiness
 /revela remember <text>          保存明确的用户/工作流偏好
-/revela edit <target>            为 deck slug 或 decks/*.html 打开可视化评论编辑器
+/revela edit [target]            打开 active deck 或指定 target 的可视化编辑器
 
 /revela designs                  列出已安装 design
 /revela designs <name>           激活某个 design
@@ -556,13 +556,16 @@ Prompt 注入规则：
 
 ## 可视化编辑
 
-可以通过 deck slug 或工作区相对 HTML 路径打开可视化编辑器：
+可以直接打开 active deck，也可以传入 deck slug 或工作区相对 HTML 路径：
 
 ```text
+/revela edit
 /revela edit my-deck
 /revela edit decks/my-deck.html
 ```
 
+不传 target 时，`/revela edit` 会打开 `DECKS.json.activeDeck`。如果没有 active deck，但 `DECKS.json` 里只有一个 deck，则打开这个唯一 deck。
+
 编辑器会在浏览器中打开。使用 `Ctrl`/`Cmd` + 点击 deck 元素来引用它们，写一段自然语言评论，然后发送回 OpenCode。Revela 会把 deck 文件、slide 上下文、选中元素 metadata 和你的评论整理成结构化 edit prompt。
 
 对应的 LLM tool：`revela-edit`，参数为 `{ "target": "decks/my-deck.html" }`。因此当你说“我要编辑 @decks/my-deck.html”时，agent 也可以主动打开同一个编辑器。

package/lib/commands/edit.ts

@@ -6,10 +6,6 @@ export async function handleEdit(
   send: (text: string) => Promise<void>,
 ): Promise<void> {
   const target = input.trim()
-  if (!target) {
-    await send("**Usage:** `/revela edit <deck-slug|decks/file.html>`\n\nExamples: `/revela edit investor-update`, `/revela edit decks/investor-update.html`")
-    return
-  }
 
   try {
     const result = openEditableDeck(target, {

package/lib/commands/help.ts

@@ -28,7 +28,7 @@ export async function handleHelp(
     `\`/revela disable\`             — disable slide generation mode\n` +
     `\`/revela init\`                — initialize or refresh workspace DECKS.json\n` +
     `\`/revela review [slug]\`       — review active deck readiness before writing HTML\n` +
-    `\`/revela edit <target>\`       — open visual comment editor for a deck slug or decks/*.html\n` +
+    `\`/revela edit [target]\`       — open visual editor for active deck or a specific target\n` +
     `\`/revela remember <text>\`     — save an explicit preference to DECKS.json\n` +
     `\`/revela designs\`             — list installed designs\n` +
     `\`/revela designs <name>\`      — activate a design\n` +

package/lib/edit/resolve-deck.ts

@@ -11,7 +11,7 @@ export interface EditableDeck {
 
 export function resolveEditableDeck(workspaceRoot: string, input: string): EditableDeck {
   const requested = input.trim()
-  if (!requested) throw new Error("Usage: /revela edit <deck-slug|decks/file.html>")
+  if (!requested) return resolveDefaultDeck(workspaceRoot)
 
   const slug = normalizeSlug(requested)
 
@@ -32,6 +32,32 @@ export function resolveEditableDeck(workspaceRoot: string, input: string): Edita
   return resolveDeckFile(workspaceRoot, slug, `decks/${slug}.html`, "fallback")
 }
 
+function resolveDefaultDeck(workspaceRoot: string): EditableDeck {
+  if (!hasDecksState(workspaceRoot)) {
+    throw new Error(`No ${DECKS_STATE_FILE} found. Use /revela edit <deck-slug|decks/file.html>.`)
+  }
+
+  const state = readDecksState(workspaceRoot)
+  const activeSlug = normalizeSlug(state.activeDeck || "")
+  if (activeSlug) {
+    const deck = state.decks[activeSlug]
+    if (!deck) throw new Error(`Active deck ${activeSlug} does not exist in ${DECKS_STATE_FILE}. Use /revela edit <target>.`)
+    return resolveDeckFile(workspaceRoot, deck.slug, deck.outputPath, "decks-state")
+  }
+
+  const decks = Object.values(state.decks)
+  if (decks.length === 1) {
+    const deck = decks[0]
+    return resolveDeckFile(workspaceRoot, deck.slug, deck.outputPath, "decks-state")
+  }
+
+  if (decks.length === 0) {
+    throw new Error(`${DECKS_STATE_FILE} has no decks. Use /revela edit <deck-slug|decks/file.html>.`)
+  }
+
+  throw new Error(`${DECKS_STATE_FILE} has multiple decks and no activeDeck. Use /revela edit <target>.`)
+}
+
 function resolvePathTarget(workspaceRoot: string, requested: string): EditableDeck {
   if (isAbsoluteLike(requested)) {
     throw new Error("/revela edit only accepts workspace-relative decks/*.html paths.")

package/lib/qa/checks.ts

@@ -618,7 +618,7 @@ function formatComplianceReport(report: QAReport): string {
     `## Static Design Compliance Report`,
     ``,
     `**File:** \`${report.file}\``,
-    `**Result:** WARNINGS — ${report.summary}`,
+    `**Result:** FAILED — ${report.summary}`,
     ``,
   ]
 
@@ -634,7 +634,8 @@ function formatComplianceReport(report: QAReport): string {
   lines.push(
     `### Action Required`,
     ``,
-    `Please fix the design vocabulary warnings above before continuing. These are static class-name checks, not layout QA failures.`,
+    `You must fix the design vocabulary errors above before continuing. These are static class-name checks, not layout QA failures.`,
+    `Do not leave unknown classes or custom class selectors in deck HTML.`,
     `- For **unknown HTML classes**, remove ad-hoc/test classes or replace them with classes from the active design's Layout Index or Component Index.`,
     `- For **novel CSS rules**, remove custom class selectors from \`<style>\`; use existing design components, or inline \`style=""\` for minor one-off positioning/sizing tweaks.`,
     `- If you need the correct class names, call \`revela-designs\` to read the relevant layout/component details.`,
@@ -652,7 +653,8 @@ function formatComplianceIssue(issue: LayoutIssue): string {
   const classAttr = typeof data.classAttr === "string" ? data.classAttr : ""
   const tag = typeof data.tag === "string" ? data.tag : ""
   const label = issue.sub ? `compliance/${issue.sub}` : "compliance"
-  const lines = [`- 🟡 **${label}**: \`${cls}\``]
+  const icon = issue.severity === "error" ? "🔴" : "🟡"
+  const lines = [`- ${icon} **${label}**: \`${cls}\``]
 
   lines.push(`  - Location: ${location}${line ? `, line ${line}` : ""}`)
   if (tag || classAttr) {

package/lib/qa/compliance.ts

@@ -157,7 +157,7 @@ export function runComplianceQA(htmlFilePath: string, vocabulary?: DesignClassVo
         issues.push({
           type: "compliance",
           sub: "unknown_class",
-          severity: "warning",
+          severity: "error",
           detail: `HTML uses CSS class \`${use.className}\` which is not defined in the active design. Replace it with a class from the Component Index or Layout Index.`,
           data: {
             class: use.className,
@@ -187,7 +187,7 @@ export function runComplianceQA(htmlFilePath: string, vocabulary?: DesignClassVo
       first.issues.push({
         type: "compliance",
         sub: "novel_css_rule",
-        severity: "warning",
+        severity: "error",
         detail: `<style> defines CSS class \`.${use.className}\` which is not part of the active design. Remove this custom rule and use the design's existing component styles. For minor adjustments, use inline \`style=""\` instead.`,
         data: {
           class: use.className,

package/package.json

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