@cyber-dash-tech/revela 0.9.0 → 0.11.0

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) })
+    }
+  },
+})

package/tools/pdf.ts

@@ -9,6 +9,7 @@ import { existsSync } from "fs"
 import { resolve } from "path"
 import { exportToPdf } from "../lib/pdf/export"
 import { assertExportQAPassed } from "../lib/qa/export-gate"
+import { recordRenderedArtifact, workspaceRelative } from "../lib/workspace-state/rendered-artifacts"
 
 export default tool({
   description:
@@ -35,8 +36,15 @@ export default tool({
     }
 
     try {
-      await assertExportQAPassed(filePath)
+      const root = directory || process.cwd()
+      await assertExportQAPassed(filePath, { workspaceRoot: root })
       const result = await exportToPdf(filePath)
+      recordRenderedArtifact(root, {
+        sourceHtmlPath: workspaceRelative(resolve(root), filePath),
+        outputPath: result.outputPath,
+        type: "pdf",
+        actor: "revela-pdf",
+      })
       return JSON.stringify({ ok: true, ...result }, null, 2)
     } catch (e: any) {
       return JSON.stringify({ ok: false, error: e?.message ?? String(e) })

package/tools/pptx.ts

@@ -7,7 +7,9 @@
 import { tool } from "@opencode-ai/plugin"
 import { existsSync } from "fs"
 import { resolve } from "path"
+import { assertDeckHtmlContractValid } from "../lib/deck-html/contract"
 import { exportToPptx } from "../lib/pptx/export"
+import { recordRenderedArtifact, workspaceRelative } from "../lib/workspace-state/rendered-artifacts"
 
 export default tool({
   description:
@@ -42,12 +44,20 @@ export default tool({
     const progress: string[] = []
 
     try {
+      const root = directory || process.cwd()
+      assertDeckHtmlContractValid(root, filePath)
       const result = await exportToPptx(filePath, {
         speakerNotes: normalizeSpeakerNotes(speakerNotes),
         onProgress: (event) => {
           progress.push(event.message)
         },
       })
+      recordRenderedArtifact(root, {
+        sourceHtmlPath: workspaceRelative(resolve(root), filePath),
+        outputPath: result.outputPath,
+        type: "pptx",
+        actor: "revela-pptx",
+      })
       return JSON.stringify({ ok: true, ...result, progress }, null, 2)
     } catch (e: any) {
       return JSON.stringify({ ok: false, error: e?.message ?? String(e), progress })

package/tools/research-save.ts

@@ -1,6 +1,8 @@
 import { tool } from "@opencode-ai/plugin"
 import { mkdirSync, writeFileSync } from "fs"
 import { join } from "path"
+import { hasDecksState, readDecksState, writeDecksState } from "../lib/decks-state"
+import { recordWorkspaceAction } from "../lib/workspace-state/actions"
 
 /**
  * Format today's date as YYYY-MM-DD
@@ -88,6 +90,19 @@ export default tool({
 
       writeFileSync(filePath, fileContent, "utf-8")
 
+      if (hasDecksState(workspaceDir)) {
+        const state = readDecksState(workspaceDir)
+        recordWorkspaceAction(state, {
+          type: "research.findings_saved",
+          actor: "revela-research-save",
+          inputs: { topic: topicKey, axis: fileKey, sourceCount: args.sources?.length ?? 0 },
+          outputs: { path: relPath, sources: args.sources ?? [] },
+          summary: `Saved research findings for ${topicKey}/${fileKey}.`,
+          nodeIds: [`finding:${relPath}`],
+        })
+        writeDecksState(workspaceDir, state)
+      }
+
       return JSON.stringify({ ok: true, path: relPath })
     } catch (e: any) {
       return JSON.stringify({ error: e.message || String(e) })

package/tools/workspace-scan.ts

@@ -3,6 +3,8 @@ import { readdirSync, statSync, existsSync } from "fs"
 import { join, relative, extname, resolve, sep, isAbsolute } from "path"
 import { sourceMaterialMetadata } from "../lib/source-materials"
 import type { SourceMaterial } from "../lib/decks-state"
+import { hasDecksState, readDecksState, writeDecksState } from "../lib/decks-state"
+import { recordWorkspaceAction } from "../lib/workspace-state/actions"
 
 const DOC_EXTENSIONS = new Set([
   ".pdf", ".docx", ".doc", ".xlsx", ".xls",
@@ -145,6 +147,19 @@ export default tool({
       const results: FileEntry[] = []
       scanDir(scanRoot, workspaceDir, results, maxDepth, 0)
 
+      if (hasDecksState(workspaceDir)) {
+        const state = readDecksState(workspaceDir)
+        recordWorkspaceAction(state, {
+          type: "workspace.scanned",
+          actor: "revela-workspace-scan",
+          inputs: { path: args.path, maxDepth },
+          outputs: { found: results.length, paths: results.map((file) => file.path) },
+          summary: `Scanned workspace documents and found ${results.length} file${results.length === 1 ? "" : "s"}.`,
+          nodeIds: results.map((file) => `source:${file.sourceMaterial.path}`),
+        })
+        writeDecksState(workspaceDir, state)
+      }
+
       if (results.length === 0) {
         return JSON.stringify({
           found: 0,