@cyber-dash-tech/revela 0.17.5 → 0.17.7

package/lib/runtime/story.ts

@@ -0,0 +1,53 @@
+import { resolve } from "path"
+import { loadStoryMap } from "../commands/narrative"
+import { formatNarrativeMap, type NarrativeMap } from "../narrative-state/map"
+import type { formatVaultDiagnosticReport } from "../narrative-vault"
+
+export interface StoryReadInput {
+  workspaceRoot?: string
+  format?: "map" | "markdown"
+}
+
+export type StoryReadResult =
+  | {
+    ok: true
+    narrativeHash: string
+    map: NarrativeMap
+    markdown?: string
+    diagnostics: ReturnType<typeof formatVaultDiagnosticReport>
+    diagnosticsMarkdown: string
+  }
+  | {
+    ok: false
+    error: string
+    guidance: string
+    diagnostics?: ReturnType<typeof formatVaultDiagnosticReport>
+    diagnosticsMarkdown: string
+  }
+
+export function storyRead(input: StoryReadInput = {}): StoryReadResult {
+  const loaded = loadStoryMap(root(input.workspaceRoot))
+  if (!loaded.ok) {
+    return {
+      ok: false,
+      error: loaded.error,
+      guidance: "Run `/revela init` first to initialize `revela-narrative/`, then retry Story reading.",
+      diagnostics: loaded.diagnosticsReport,
+      diagnosticsMarkdown: loaded.diagnosticsMarkdown,
+    }
+  }
+
+  const map = loaded.map
+  return {
+    ok: true,
+    narrativeHash: map.snapshot.narrativeHash,
+    map,
+    markdown: input.format === "markdown" ? formatNarrativeMap(map) : undefined,
+    diagnostics: loaded.diagnosticsReport,
+    diagnosticsMarkdown: loaded.diagnosticsMarkdown,
+  }
+}
+
+function root(workspaceRoot: string | undefined): string {
+  return resolve(workspaceRoot || process.cwd())
+}

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.17.5",
+  "version": "0.17.7",
   "description": "OpenCode plugin for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",
+  "bin": {
+    "revela": "./bin/revela.ts"
+  },
   "exports": {
     ".": "./index.ts"
   },
   "files": [
+    "bin/",
     "plugin.ts",
     "lib/",
+    "plugins/revela/",
     "tools/",
     "skill/",
     "designs/aurora/DESIGN.md",

package/plugin.ts

@@ -11,7 +11,7 @@
  * 5. experimental.chat.system.transform: inject three-layer prompt when enabled
  * 6. chat.message: intercept @-referenced / pasted binary files → extract text → replace FilePart with TextPart
  * 7. tool.execute.before: intercept read on DOCX/PPTX/XLSX → preRead()
- * 8. tool.execute.after: intercept read on PDF/images → postRead(); run static compliance after deck writes/patches/edits
+ * 8. tool.execute.after: intercept read on PDF/images → postRead(); run static compliance after deck writes/patches/edits unless Review Apply Fix suppresses it
  */
 
 import type { Plugin } from "@opencode-ai/plugin"
@@ -47,6 +47,7 @@ import { buildPptxNotesPrompt, handlePptx, parsePptxArgs, resolvePptxDeck } from
 import { handleRefine } from "./lib/commands/refine"
 import { formatArtifactQAReport, runArtifactQA } from "./lib/qa/artifact"
 import { ensureRefineDeckOpenForChange } from "./lib/refine/open"
+import { shouldSuppressReviewApplyFixArtifactQa } from "./lib/refine/qa-suppression"
 import { handleDesignsPreview } from "./lib/commands/designs-preview"
 import {
   parseDesignsNewArgs,
@@ -81,6 +82,7 @@ import decksTool from "./tools/decks"
 import designsAuthorTool from "./tools/designs-author"
 import designsTool from "./tools/designs"
 import domainsTool from "./tools/domains"
+import deckFoundationTool from "./tools/deck-foundation"
 import mediaBatchSaveTool from "./tools/media-batch-save"
 import mediaSaveTool from "./tools/media-save"
 import researchImagesListTool from "./tools/research-images-list"
@@ -147,6 +149,7 @@ const server: Plugin = (async (pluginCtx) => {
 
   async function runPostWriteArtifactQA(filePath: string, output: any, sessionID = ""): Promise<boolean> {
     if (!isDeckHtmlPath(filePath)) return true
+    if (shouldSuppressReviewApplyFixArtifactQa({ workspaceRoot, file: filePath, sessionID })) return false
 
     try {
       let vocabulary
@@ -586,6 +589,7 @@ const server: Plugin = (async (pluginCtx) => {
     tool: {
       "revela-decks": decksTool,
       "revela-designs": designsTool,
+      "revela-deck-foundation": deckFoundationTool,
       "revela-designs-author": designsAuthorTool,
       "revela-domains": domainsTool,
       "revela-media-batch-save": mediaBatchSaveTool,
@@ -785,7 +789,7 @@ Next step: use \`revela-decks\` with action \`init\`, \`upsertDeck\`, \`upsertSl
     // PDF: extract text, remove base64. Images: jimp compress.
     //
     // Also reports writes/patches blocked by the DECKS.json state gate and
-    // runs artifact QA before opening Refine after successful deck changes.
+    // runs artifact QA before opening Refine after successful deck changes, except Review Apply Fix comments.
     "tool.execute.after": async (input, output) => {
       // ── Post-read processing ───────────────────────────────────────────
       if (input.tool === "read") {

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

@@ -0,0 +1,37 @@
+{
+  "name": "revela",
+  "version": "0.1.0+codex.20260523122203",
+  "description": "Use Revela in Codex to build trusted, traceable narrative decision artifacts from local sources and research.",
+  "author": {
+    "name": "cyber-dash-tech",
+    "url": "https://github.com/cyber-dash-tech"
+  },
+  "repository": "https://github.com/cyber-dash-tech/revela",
+  "license": "MIT",
+  "keywords": [
+    "narrative",
+    "presentations",
+    "research",
+    "evidence",
+    "codex"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "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.",
+    "developerName": "cyber-dash-tech",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use Revela to initialize this workspace.",
+      "Use Revela to make a deck from the narrative.",
+      "Use Revela to review this deck artifact."
+    ],
+    "brandColor": "#2563EB"
+  }
+}

package/plugins/revela/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "revela": {
+      "command": "bun",
+      "args": [
+        "--eval",
+        "const fs = await import('fs');\nconst path = await import('path');\nconst { pathToFileURL } = await import('url');\nconst candidates = [];\nconst home = process.env.HOME || '';\nconst marketplaceNames = ['revela', 'revela-local'];\ncandidates.push(path.resolve(process.cwd(), 'bin/revela.ts'));\nconst configPath = path.join(home, '.codex', 'config.toml');\nif (fs.existsSync(configPath)) {\n  const text = fs.readFileSync(configPath, 'utf-8');\n  const sections = text.split(/\\n(?=\\s*\\[)/);\n  for (const marketplaceName of marketplaceNames) {\n    const section = sections.find((item) => item.trimStart().startsWith(`[marketplaces.${marketplaceName}]`));\n    const match = section?.match(/^\\s*source\\s*=\\s*\"([^\"]+)\"/m);\n    if (match) candidates.push(path.join(match[1], 'bin/revela.ts'));\n  }\n}\nfor (const marketplaceName of marketplaceNames) {\n  const cacheRoot = path.join(home, '.codex', 'plugins', 'cache', marketplaceName, 'revela');\n  if (fs.existsSync(cacheRoot)) {\n    for (const version of fs.readdirSync(cacheRoot).sort().reverse()) candidates.push(path.join(cacheRoot, version, 'bin/revela.ts'));\n  }\n}\nconst cli = candidates.find((candidate) => fs.existsSync(candidate));\nif (!cli) {\n  console.error(`Could not locate Revela CLI. Checked: ${candidates.join(', ')}`);\n  process.exit(1);\n}\nprocess.env.REVELA_CLI_COMMAND = 'mcp';\nawait import(pathToFileURL(cli).href);"
+      ]
+    }
+  }
+}

package/plugins/revela/assets/README.md

@@ -0,0 +1,2 @@
+Revela Codex plugin assets live here. Add logo, icon, and screenshots before packaging a published plugin.
+

package/plugins/revela/hooks/hooks.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "apply_patch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun ${PLUGIN_ROOT}/hooks/revela_guard.ts",
+            "statusMessage": "Checking Revela controlled files"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "apply_patch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun ${PLUGIN_ROOT}/hooks/revela_post_write_notice.ts",
+            "statusMessage": "Checking Revela QA reminders"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/revela/hooks/revela_guard.ts

@@ -0,0 +1,10 @@
+const input = await new Response(Bun.stdin.stream()).text()
+
+if (input.includes("DECKS.json")) {
+  console.error("Revela controls DECKS.json. Use Revela MCP/runtime tools or file-native narrative files instead of direct DECKS.json patches.")
+  process.exit(2)
+}
+
+process.exit(0)
+
+export {}

package/plugins/revela/hooks/revela_post_write_notice.ts

@@ -0,0 +1,18 @@
+const input = await new Response(Bun.stdin.stream()).text()
+const notices: string[] = []
+
+if (/revela-narrative\/.*\.md/.test(input)) {
+  notices.push("Revela narrative Markdown changed. Run `revela_markdown_qa` and `revela_compile_narrative` before treating the graph as usable.")
+}
+
+if (/decks\/.*\.html/.test(input)) {
+  notices.push("Revela deck HTML changed. Run `revela_run_deck_qa` before review or export.")
+}
+
+if (notices.length > 0) {
+  console.error(notices.join("\n"))
+}
+
+process.exit(0)
+
+export {}