@cyber-dash-tech/revela 0.9.0 → 0.10.0

package/package.json

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

package/plugin.ts

@@ -46,6 +46,8 @@ import {
 import { handlePdf } from "./lib/commands/pdf"
 import { buildPptxNotesPrompt, handlePptx, parsePptxArgs, resolvePptxDeck } from "./lib/commands/pptx"
 import { handleEdit } from "./lib/commands/edit"
+import { handleInspect } from "./lib/commands/inspect"
+import { handleRefine } from "./lib/commands/refine"
 import { ensureEditableDeckOpenForChange } from "./lib/edit/open"
 import { hasLiveEditorSessionForFile } from "./lib/edit/server"
 import { handleDesignsPreview } from "./lib/commands/designs-preview"
@@ -80,6 +82,8 @@ 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 workspaceScanTool from "./tools/workspace-scan"
 import extractDocumentMaterialsTool from "./tools/extract-document-materials"
 import qaTool from "./tools/qa"
@@ -332,6 +336,14 @@ const server: Plugin = (async (pluginCtx) => {
         } as any)
         return
       }
+      if (sub === "refine") {
+        if (param) {
+          await send("`/revela refine` does not accept a target. It opens the only HTML deck in `decks/`.")
+          throw new Error("__REVELA_REFINE_USAGE_HANDLED__")
+        }
+        await handleRefine({ client, sessionID, workspaceRoot }, send)
+        throw new Error("__REVELA_REFINE_HANDLED__")
+      }
       if (sub === "edit") {
         if (param) {
           await send("`/revela edit` no longer accepts a target. It opens the only HTML deck in `decks/`.")
@@ -340,6 +352,14 @@ const server: Plugin = (async (pluginCtx) => {
         await handleEdit({ client, sessionID, workspaceRoot }, send)
         throw new Error("__REVELA_EDIT_HANDLED__")
       }
+      if (sub === "inspect") {
+        if (param) {
+          await send("`/revela inspect` does not accept a target. It opens the only HTML deck in `decks/`.")
+          throw new Error("__REVELA_INSPECT_USAGE_HANDLED__")
+        }
+        await handleInspect({ client, sessionID, workspaceRoot }, send)
+        throw new Error("__REVELA_INSPECT_HANDLED__")
+      }
       if (sub === "designs" && !param) {
         await handleDesignsList(send)
         throw new Error("__REVELA_DESIGNS_LIST_HANDLED__")
@@ -438,6 +458,8 @@ 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-workspace-scan": workspaceScanTool,
       "revela-extract-document-materials": extractDocumentMaterialsTool,
       "revela-qa": qaTool,

package/skill/SKILL.md

@@ -261,12 +261,17 @@ A 6-slide deck might be: Cover → Background → Content × 3 → Closing.
 An 8-slide deck might be: Cover → TOC → Background → Content × 3 → Summary → Closing.
 Never skip Cover, Background, or Closing regardless of deck length.
 
-**Every `<section class="slide">` must include a `slide-qa` attribute.** Set
-`slide-qa="true"` for content-heavy layouts (those marked ✓ in the Layout Index
-QA column of the active design). Set `slide-qa="false"` for structural or sparse
-layouts (cover, TOC, closing, quote, summary, etc.). When unsure, use `"false"`.
+**Every `<section class="slide">` must include `slide-qa` and
+`data-slide-index` attributes.** Set `slide-qa="true"` for content-heavy layouts
+(those marked ✓ in the Layout Index QA column of the active design). Set
+`slide-qa="false"` for structural or sparse layouts (cover, TOC, closing, quote,
+summary, etc.). When unsure, use `"false"`.
 
-Example: `<section class="slide" slide-qa="true" data-index="0">`
+`data-slide-index` is the canonical 1-based slide identity. It must match the
+corresponding `DECKS.json` `slides[].index` value. Do not use 0-based
+`data-index` as slide identity.
+
+Example: `<section class="slide" slide-qa="true" data-slide-index="1">`
 
 The export QA path treats this as deck metadata. It is consumed when PDF/PPTX
 export runs preflight checks.

package/tools/decks.ts

@@ -1,5 +1,6 @@
 import { tool } from "@opencode-ai/plugin"
 import {
+  applyEvidenceCandidates,
   createDeckSpec,
   DECKS_STATE_FILE,
   normalizeWorkspaceDeckState,
@@ -25,7 +26,7 @@ export default tool({
     "It stores active deck specs, per-slide content/layout/components, and computes write readiness.",
   args: {
     action: tool.schema
-      .enum(["read", "init", "upsertDeck", "upsertSlides", "review", "remember"])
+      .enum(["read", "init", "upsertDeck", "upsertSlides", "review", "applyEvidenceCandidates", "remember"])
       .describe("Action to perform on DECKS.json."),
     summary: tool.schema.boolean().optional().describe("For read: return a compact summary instead of full state."),
     goal: tool.schema.string().optional().describe("For upsertDeck: deck goal."),
@@ -116,6 +117,7 @@ export default tool({
       status: tool.schema.enum(["planned", "ready", "written", "qa_passed", "qa_failed"]).optional().describe("Slide production status."),
       notes: tool.schema.string().optional().describe("Implementation notes for this slide."),
     })).optional().describe("For upsertSlides: complete or partial slide specs."),
+    candidateIds: tool.schema.array(tool.schema.string()).optional().describe("For applyEvidenceCandidates: candidate IDs returned by revela-decks review to explicitly bind proposed evidenceDraft records into slide evidence."),
   },
   async execute(args, context) {
     try {
@@ -175,11 +177,19 @@ export default tool({
       }
 
       if (args.action === "review") {
-        const reviewed = reviewDeckState(state)
+        const reviewed = reviewDeckState(state, undefined, { workspaceRoot })
         writeDecksState(workspaceRoot, reviewed.state)
         return JSON.stringify({ ok: true, path: DECKS_STATE_FILE, result: reviewed.result }, null, 2)
       }
 
+      if (args.action === "applyEvidenceCandidates") {
+        const candidateIds = args.candidateIds ?? []
+        if (candidateIds.length === 0) return JSON.stringify({ ok: false, error: "candidateIds are required for applyEvidenceCandidates" })
+        const applied = applyEvidenceCandidates(state, candidateIds, { workspaceRoot })
+        writeDecksState(workspaceRoot, applied.state)
+        return JSON.stringify({ ok: true, path: DECKS_STATE_FILE, result: applied.result }, null, 2)
+      }
+
       if (args.action === "remember") {
         const memory = args.memory?.trim()
         if (!memory) return JSON.stringify({ ok: false, error: "memory is required for remember" })

package/tools/inspection-context.ts

@@ -0,0 +1,22 @@
+import { tool } from "@opencode-ai/plugin"
+import { compileInspectionContext } from "../lib/inspection-context/compile"
+import { normalizeWorkspaceDeckState, readOrCreateDecksState } from "../lib/decks-state"
+
+export default tool({
+  description:
+    "Compile Revela's current DECKS.json into structured inspection context for debugging and future Evidence Inspector flows. " +
+    "This is read-only: it does not write artifacts, mutate DECKS.json, or generate user-facing files.",
+  args: {
+    slug: tool.schema.string().optional().describe("Optional deck slug to compile. Defaults to the active workspace deck."),
+  },
+  async execute(args, context) {
+    try {
+      const workspaceRoot = context.directory ?? process.cwd()
+      const state = normalizeWorkspaceDeckState(readOrCreateDecksState(workspaceRoot), workspaceRoot)
+      const inspectionContext = compileInspectionContext(state, args.slug)
+      return JSON.stringify({ ok: true, inspectionContext }, null, 2)
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e.message || String(e) })
+    }
+  },
+})

package/tools/inspection-result.ts

@@ -0,0 +1,63 @@
+import { tool } from "@opencode-ai/plugin"
+import { completeInspectRequest } from "../lib/inspect/requests"
+import type { InspectionResult } from "../lib/inspection-context/result"
+
+const evidenceSourceItemSchema = tool.schema.object({
+  source: tool.schema.string().describe("Human-readable source label."),
+  sourcePath: tool.schema.string().optional(),
+  findingsFile: tool.schema.string().optional(),
+  location: tool.schema.string().optional(),
+  page: tool.schema.string().optional(),
+  url: tool.schema.string().optional(),
+  quote: tool.schema.string().optional(),
+  caveat: tool.schema.string().optional(),
+})
+
+export default tool({
+  description:
+    "Submit the final structured Evidence Inspector result for a pending /revela inspect request. " +
+    "Use only when responding to an inspection prompt. This updates the local browser inspector; it does not mutate DECKS.json or deck files.",
+  args: {
+    requestId: tool.schema.string().describe("Pending inspection request id from the inspection prompt."),
+    result: tool.schema.object({
+      version: tool.schema.number().describe("Must be 1."),
+      status: tool.schema.enum(["success", "no_match"]),
+      selectedText: tool.schema.string().optional(),
+      slide: tool.schema.object({
+        index: tool.schema.number(),
+        title: tool.schema.string(),
+      }).optional(),
+      matchConfidence: tool.schema.enum(["none", "low", "medium", "high"]),
+      cards: tool.schema.object({
+        purpose: tool.schema.object({
+          status: tool.schema.enum(["clear", "weak", "misplaced", "unknown"]),
+          role: tool.schema.string().optional(),
+          rationale: tool.schema.string(),
+          whyItMatters: tool.schema.string(),
+        }),
+        source: tool.schema.object({
+          status: tool.schema.enum(["supported", "weak", "unsupported", "not_needed", "unknown"]),
+          matchedClaim: tool.schema.string().optional(),
+          sources: tool.schema.array(evidenceSourceItemSchema),
+          warnings: tool.schema.array(tool.schema.string()),
+          gaps: tool.schema.array(tool.schema.string()),
+          caveats: tool.schema.array(tool.schema.string()),
+          rationale: tool.schema.string(),
+        }),
+      }),
+      stale: tool.schema.object({
+        stale: tool.schema.boolean(),
+        reason: tool.schema.string().optional(),
+      }).optional(),
+    }).describe("Final structured inspector result to render in the browser."),
+  },
+  async execute(args) {
+    try {
+      if (args.result.version !== 1) throw new Error("Inspection result version must be 1.")
+      const request = completeInspectRequest(args.requestId, args.result as InspectionResult)
+      return JSON.stringify({ ok: true, requestId: request.requestId, status: request.status })
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e.message || String(e) })
+    }
+  },
+})