@cyber-dash-tech/revela 0.18.3 → 0.18.4

package/README.md

@@ -2,7 +2,7 @@
 
 **English** | [中文](README.zh-CN.md)
 
-[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-688%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
+[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-691%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
 
 <p align="center">
   <img src="assets/img/logo.png" alt="Revela" width="560" />
@@ -34,7 +34,7 @@ To install globally, add the same entry to `~/.config/opencode/opencode.json`.
 Requirements:
 
 - The Codex CLI must be installed and the `codex` command must be available in your shell.
-- Your environment must be able to run `npx`; Revela uses `npx -y @cyber-dash-tech/revela@0.18.3 mcp` to start the MCP server.
+- Your environment must be able to run `npx`; Revela uses `npx -y @cyber-dash-tech/revela@0.18.4 mcp` to start the MCP server.
 - For interactive Review actions, `codex exec` must also work because the Review UI uses it for Comment/Apply Fix requests.
 
 Optional preflight:
@@ -55,11 +55,11 @@ npm_config_cache=/tmp/revela-npm-cache bun run smoke:mcp-pack
 Install Revela through the Codex Git marketplace:
 
 ```bash
-codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.18.3
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.18.4
 codex plugin add revela@revela
 ```
 
-The Git marketplace install provides the Codex plugin shell, skills, hooks, and MCP configuration. When Codex starts the Revela MCP server for the first time, it runs `npx -y @cyber-dash-tech/revela@0.18.3 mcp` so npm can fetch the published package and its dependencies.
+The Git marketplace install provides the Codex plugin shell, skills, hooks, and MCP configuration. When Codex starts the Revela MCP server for the first time, it runs `npx -y @cyber-dash-tech/revela@0.18.4 mcp` so npm can fetch the published package and its dependencies.
 
 You do not need to run `bun install` inside the Codex marketplace clone.
 

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | **中文**
 
-[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-688%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
+[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-691%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
 
 <p align="center">
   <img src="assets/img/logo.png" alt="Revela" width="560" />
@@ -34,7 +34,7 @@ Revela 可在 [OpenCode](https://opencode.ai) 和 Codex 中使用，把来源材
 环境要求：
 
 - 需要已安装 Codex CLI，并且 shell 中可以执行 `codex`。
-- 环境中需要可以执行 `npx`；Revela 会用 `npx -y @cyber-dash-tech/revela@0.18.3 mcp` 启动 MCP server。
+- 环境中需要可以执行 `npx`；Revela 会用 `npx -y @cyber-dash-tech/revela@0.18.4 mcp` 启动 MCP server。
 - 如果使用 Review UI 的 Comment 或 Apply Fix，需要 `codex exec` 可用。
 
 可选的安装前检查：
@@ -55,11 +55,11 @@ npm_config_cache=/tmp/revela-npm-cache bun run smoke:mcp-pack
 通过 Codex Git marketplace 安装 Revela：
 
 ```bash
-codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.18.3
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.18.4
 codex plugin add revela@revela
 ```
 
-Git marketplace 安装的是 Codex plugin 壳、skills、hooks 和 MCP 配置。Codex 第一次启动 Revela MCP server 时，会运行 `npx -y @cyber-dash-tech/revela@0.18.3 mcp`，由 npm 获取已发布 package 及其 dependencies。
+Git marketplace 安装的是 Codex plugin 壳、skills、hooks 和 MCP 配置。Codex 第一次启动 Revela MCP server 时，会运行 `npx -y @cyber-dash-tech/revela@0.18.4 mcp`，由 npm 获取已发布 package 及其 dependencies。
 
 不需要在 Codex marketplace clone 里运行 `bun install`。
 

package/lib/decks-state.ts

@@ -1651,6 +1651,7 @@ function isIgnorableSourceMaterial(path: string): boolean {
       normalized.startsWith("decks/") ||
       normalized.startsWith("researches/") ||
       normalized.startsWith("assets/") ||
+      normalized.startsWith(".revela/") ||
       normalized.startsWith(".opencode/"),
   )
 }

package/lib/document-materials/extract.ts

@@ -11,6 +11,7 @@ import { extractXlsx } from "../read-hooks/extractors/xlsx"
 import { hasDecksState, readDecksState, writeDecksState } from "../decks-state"
 import { computeSourceFingerprint, sourceMaterialMetadata, upsertSourceMaterial } from "../source-materials"
 import { recordWorkspaceAction } from "../workspace-state/actions"
+import { existingWorkspaceMetaPath, workspaceMetaPath } from "../workspace-meta"
 
 export type DocumentMaterial = {
   path: string
@@ -852,7 +853,7 @@ async function extractPdfImages(buf: Buffer, cacheDir: string, workspaceDir: str
 async function processPdfFile(filePath: string, workspaceDir: string): Promise<DocumentMaterialsResult> {
   const relativeSource = workspaceRelative(filePath, workspaceDir)
   const fingerprint = buildFingerprint(filePath)
-  const cacheDir = join(workspaceDir, ".opencode", "revela", "doc-materials", fingerprint)
+  const cacheDir = existingWorkspaceMetaPath(workspaceDir, "doc-materials", fingerprint)
   const manifestPath = join(cacheDir, "manifest.json")
 
   if (existsSync(manifestPath)) {
@@ -874,19 +875,21 @@ async function processPdfFile(filePath: string, workspaceDir: string): Promise<D
     }
   }
 
-  mkdirSync(join(cacheDir, "images"), { recursive: true })
-  mkdirSync(join(cacheDir, "tables"), { recursive: true })
+  const writeCacheDir = workspaceMetaPath(workspaceDir, "doc-materials", fingerprint)
+  const writeManifestPath = join(writeCacheDir, "manifest.json")
+  mkdirSync(join(writeCacheDir, "images"), { recursive: true })
+  mkdirSync(join(writeCacheDir, "tables"), { recursive: true })
 
   const buf = readFileSync(filePath)
   const text = await extractPdfText(buf)
-  const textPath = join(cacheDir, "text.txt")
+  const textPath = join(writeCacheDir, "text.txt")
   writeFileSync(textPath, `[Extracted from: ${basename(filePath)}]\n\n${text}`, "utf-8")
 
-  const images = await extractPdfImages(buf, cacheDir, workspaceDir)
-  const relativeManifestPath = workspaceRelative(manifestPath, workspaceDir)
+  const images = await extractPdfImages(buf, writeCacheDir, workspaceDir)
+  const relativeManifestPath = workspaceRelative(writeManifestPath, workspaceDir)
   const relativeTextPath = workspaceRelative(textPath, workspaceDir)
   const readViewPath = writeReadView({
-    cacheDir,
+    cacheDir: writeCacheDir,
     workspaceDir,
     source: relativeSource,
     type: "pdf",
@@ -905,7 +908,7 @@ async function processPdfFile(filePath: string, workspaceDir: string): Promise<D
     cache_status: "miss",
     source: relativeSource,
     type: "pdf",
-    cache_dir: workspaceRelative(cacheDir, workspaceDir),
+    cache_dir: workspaceRelative(writeCacheDir, workspaceDir),
     manifest_path: relativeManifestPath,
     text_path: relativeTextPath,
     read_view_path: readViewPath,
@@ -929,14 +932,14 @@ async function processPdfFile(filePath: string, workspaceDir: string): Promise<D
     tables: [],
   }
 
-  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8")
+  writeFileSync(writeManifestPath, JSON.stringify(manifest, null, 2), "utf-8")
   return result
 }
 
 async function processOfficeFile(filePath: string, workspaceDir: string, type: SupportedType): Promise<DocumentMaterialsResult> {
   const relativeSource = workspaceRelative(filePath, workspaceDir)
   const fingerprint = buildFingerprint(filePath)
-  const cacheDir = join(workspaceDir, ".opencode", "revela", "doc-materials", fingerprint)
+  const cacheDir = existingWorkspaceMetaPath(workspaceDir, "doc-materials", fingerprint)
   const manifestPath = join(cacheDir, "manifest.json")
 
   if (existsSync(manifestPath)) {
@@ -958,8 +961,10 @@ async function processOfficeFile(filePath: string, workspaceDir: string, type: S
     }
   }
 
-  mkdirSync(join(cacheDir, "images"), { recursive: true })
-  mkdirSync(join(cacheDir, "tables"), { recursive: true })
+  const writeCacheDir = workspaceMetaPath(workspaceDir, "doc-materials", fingerprint)
+  const writeManifestPath = join(writeCacheDir, "manifest.json")
+  mkdirSync(join(writeCacheDir, "images"), { recursive: true })
+  mkdirSync(join(writeCacheDir, "tables"), { recursive: true })
 
   const buf = readFileSync(filePath)
   const files = unzipSync(new Uint8Array(buf))
@@ -970,26 +975,26 @@ async function processOfficeFile(filePath: string, workspaceDir: string, type: S
       ? await extractDocx(buf)
       : await extractXlsx(buf)
 
-  const textPath = join(cacheDir, "text.txt")
+  const textPath = join(writeCacheDir, "text.txt")
   writeFileSync(textPath, `[Extracted from: ${basename(filePath)}]\n\n${text}`, "utf-8")
 
   const pptxAssets = type === "pptx"
-    ? extractPptxImages(files, cacheDir, workspaceDir)
+    ? extractPptxImages(files, writeCacheDir, workspaceDir)
     : null
   const images = type === "pptx"
     ? pptxAssets!.images
     : type === "docx"
-      ? extractDocxImages(files, cacheDir, workspaceDir)
-      : extractXlsxImages(files, cacheDir, workspaceDir)
+      ? extractDocxImages(files, writeCacheDir, workspaceDir)
+      : extractXlsxImages(files, writeCacheDir, workspaceDir)
   const slides = type === "pptx"
     ? extractPptxSlides(files, images, pptxAssets!.skipped_assets)
     : undefined
-  const relativeManifestPath = workspaceRelative(manifestPath, workspaceDir)
+  const relativeManifestPath = workspaceRelative(writeManifestPath, workspaceDir)
   const relativeTextPath = workspaceRelative(textPath, workspaceDir)
   const tables = extractTables(type, relativeTextPath)
   const skippedAssets = pptxAssets?.skipped_assets ?? []
   const readViewPath = writeReadView({
-    cacheDir,
+    cacheDir: writeCacheDir,
     workspaceDir,
     source: relativeSource,
     type,
@@ -1008,7 +1013,7 @@ async function processOfficeFile(filePath: string, workspaceDir: string, type: S
     cache_status: "miss",
     source: relativeSource,
     type,
-    cache_dir: workspaceRelative(cacheDir, workspaceDir),
+    cache_dir: workspaceRelative(writeCacheDir, workspaceDir),
     manifest_path: relativeManifestPath,
     text_path: relativeTextPath,
     read_view_path: readViewPath,
@@ -1032,7 +1037,7 @@ async function processOfficeFile(filePath: string, workspaceDir: string, type: S
     tables: result.tables ?? [],
   }
 
-  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8")
+  writeFileSync(writeManifestPath, JSON.stringify(manifest, null, 2), "utf-8")
   return result
 }
 

package/lib/material-intake.ts

@@ -3,6 +3,7 @@ import { basename, extname, isAbsolute, join, relative, resolve, sep } from "pat
 import { extractDocumentMaterials, type DocumentMaterialsResult } from "./document-materials/extract"
 import { sourceMaterialMetadata, sourceMaterialType } from "./source-materials"
 import type { SourceMaterial } from "./decks-state"
+import { existingWorkspaceMetaPath, workspaceMetaPath } from "./workspace-meta"
 
 export type MaterialIntakeStatus =
   | "scanned"
@@ -107,24 +108,28 @@ export interface CheckMaterialIntakeResult {
 }
 
 const DOC_EXTENSIONS = new Set([".pdf", ".docx", ".doc", ".xlsx", ".xls", ".pptx", ".ppt", ".csv", ".md", ".txt"])
-const EXCLUDE_DIRS = new Set(["node_modules", ".git", "dist", ".opencode", "researches", "revela-narrative", "designs", "domains"])
+const EXCLUDE_DIRS = new Set(["node_modules", ".git", "dist", ".opencode", ".revela", "researches", "revela-narrative", "designs", "domains"])
 const EXCLUDE_FILENAMES = new Set(["AGENTS.md", "DECKS.md", "README.md", "README.zh-CN.md"])
 const EXTRACTION_EXTENSIONS = new Set(["pdf", "ppt", "pptx", "doc", "docx", "xls", "xlsx"])
 const SUPPORTED_EXTRACTION_EXTENSIONS = new Set(["pdf", "pptx", "docx", "xlsx"])
 
 export function materialRegistryPath(workspaceRoot: string): string {
-  return join(workspaceRoot, ".opencode", "revela", "material-intake", "registry.json")
+  return workspaceMetaPath(workspaceRoot, "material-intake", "registry.json")
+}
+
+function existingMaterialRegistryPath(workspaceRoot: string): string {
+  return existingWorkspaceMetaPath(workspaceRoot, "material-intake", "registry.json")
 }
 
 export function readMaterialRegistry(workspaceRoot: string): MaterialRegistry {
-  const path = materialRegistryPath(workspaceRoot)
+  const path = existingMaterialRegistryPath(workspaceRoot)
   if (!existsSync(path)) return { version: 1, updatedAt: new Date(0).toISOString(), sources: [] }
   return JSON.parse(readFileSync(path, "utf-8")) as MaterialRegistry
 }
 
 export function writeMaterialRegistry(workspaceRoot: string, registry: MaterialRegistry): string {
   const path = materialRegistryPath(workspaceRoot)
-  mkdirSync(join(workspaceRoot, ".opencode", "revela", "material-intake"), { recursive: true })
+  mkdirSync(join(workspaceRoot, ".revela", "material-intake"), { recursive: true })
   writeFileSync(path, JSON.stringify({ ...registry, updatedAt: new Date().toISOString() }, null, 2), "utf-8")
   return workspaceRelative(path, workspaceRoot)
 }

package/lib/narrative-vault/constants.ts

@@ -1,5 +1,5 @@
 export const NARRATIVE_VAULT_DIR = "revela-narrative"
-export const NARRATIVE_VAULT_CACHE_DIR = ".opencode/revela/narrative-cache"
+export const NARRATIVE_VAULT_CACHE_DIR = ".revela/narrative-cache"
 
 export const NARRATIVE_VAULT_NODE_DIRS = ["claims", "evidence", "objections", "risks", "research-gaps"] as const
 

package/lib/narrative-vault/paths.ts

@@ -1,13 +1,18 @@
 import { existsSync } from "fs"
 import { join } from "path"
-import { NARRATIVE_VAULT_CACHE_DIR, NARRATIVE_VAULT_DIR } from "./constants"
+import { existingWorkspaceMetaPath, workspaceMetaPath } from "../workspace-meta"
+import { NARRATIVE_VAULT_DIR } from "./constants"
 
 export function narrativeVaultPath(workspaceRoot: string): string {
   return join(workspaceRoot, NARRATIVE_VAULT_DIR)
 }
 
 export function narrativeVaultCachePath(workspaceRoot: string): string {
-  return join(workspaceRoot, NARRATIVE_VAULT_CACHE_DIR)
+  return workspaceMetaPath(workspaceRoot, "narrative-cache")
+}
+
+export function existingNarrativeVaultCachePath(workspaceRoot: string): string {
+  return existingWorkspaceMetaPath(workspaceRoot, "narrative-cache")
 }
 
 export function hasNarrativeVault(workspaceRoot: string): boolean {

package/lib/runtime/index.ts

@@ -27,6 +27,7 @@ import { formatArtifactQaUserNotice, formatMarkdownQaUserNotice } from "../hook-
 import { deckPlanDesignDiagnostics, readDeckPlanArtifact, upsertDeckPlanSlideArtifact, type DeckPlanSlideUpsertInput } from "../narrative-state/deck-plan-artifact"
 import { extractDesignClasses } from "../design/designs"
 import { recordRenderedArtifact, workspaceRelative } from "../workspace-state/rendered-artifacts"
+import { existingWorkspaceMetaPath, workspaceMetaPath } from "../workspace-meta"
 import { checkMaterialIntake, extractMaterial, materialIntakeNoticeForCommand, prepareLocalMaterials, recordMaterialReview } from "../material-intake"
 import type { ReviewDeckOpenInput, ReviewDeckReadInput } from "./review"
 import pkg from "../../package.json"
@@ -414,7 +415,7 @@ export function checkDesignRulesReadiness(input: RuntimeWorkspaceInput = {}): De
 }
 
 function recordDesignRulesRead(workspaceRoot: string, designName: string, rules: string): void {
-  const markerPath = designRulesMarkerPath(workspaceRoot)
+  const markerPath = workspaceMetaPath(workspaceRoot, "codex-hooks", "design-rules-read.json")
   mkdirSync(dirname(markerPath), { recursive: true })
   writeFileSync(markerPath, JSON.stringify({
     designName,
@@ -424,7 +425,7 @@ function recordDesignRulesRead(workspaceRoot: string, designName: string, rules:
 }
 
 function designRulesMarkerPath(workspaceRoot: string): string {
-  return resolve(workspaceRoot, ".opencode", "revela", "codex-hooks", "design-rules-read.json")
+  return existingWorkspaceMetaPath(workspaceRoot, "codex-hooks", "design-rules-read.json")
 }
 
 function hashDesignRules(rules: string): string {

package/lib/workspace-meta.ts

@@ -0,0 +1,32 @@
+import { existsSync } from "fs"
+import { join } from "path"
+
+export const WORKSPACE_META_DIR = ".revela"
+export const LEGACY_WORKSPACE_META_DIR = ".opencode/revela"
+
+export function workspaceMetaPath(workspaceRoot: string, ...segments: string[]): string {
+  return join(workspaceRoot, WORKSPACE_META_DIR, ...segments)
+}
+
+export function legacyWorkspaceMetaPath(workspaceRoot: string, ...segments: string[]): string {
+  return join(workspaceRoot, LEGACY_WORKSPACE_META_DIR, ...segments)
+}
+
+export function existingWorkspaceMetaPath(workspaceRoot: string, ...segments: string[]): string {
+  const current = workspaceMetaPath(workspaceRoot, ...segments)
+  if (existsSync(current)) return current
+  const legacy = legacyWorkspaceMetaPath(workspaceRoot, ...segments)
+  return existsSync(legacy) ? legacy : current
+}
+
+export function workspaceMetaRelativePath(...segments: string[]): string {
+  return join(WORKSPACE_META_DIR, ...segments).replace(/\\/g, "/")
+}
+
+export function isWorkspaceMetaRelativePath(path: string): boolean {
+  const normalized = path.replace(/\\/g, "/").replace(/^\.\//, "")
+  return normalized === WORKSPACE_META_DIR ||
+    normalized.startsWith(`${WORKSPACE_META_DIR}/`) ||
+    normalized === ".opencode" ||
+    normalized.startsWith(".opencode/")
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "description": "OpenCode plugin for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",

package/plugin.ts

@@ -98,6 +98,7 @@ import { extractDesignClasses } from "./lib/design/designs"
 import { log, childLog } from "./lib/log"
 import { appendToolResult } from "./lib/tool-result"
 import { formatArtifactQaUserNotice, formatMarkdownQaUserNotice, formatStateGateUserNotice } from "./lib/hook-notifications"
+import { workspaceMetaPath, workspaceMetaRelativePath } from "./lib/workspace-meta"
 
 // OpenCode internal agent signatures — used to skip system prompt injection
 // for built-in system agents (title, summary, compaction).
@@ -712,7 +713,7 @@ const server: Plugin = (async (pluginCtx) => {
       if (input.tool === "write") {
         const filePath: string = (output.args as any)?.filePath ?? ""
         if (isDecksStatePath(filePath)) {
-          const blockedDir = join(workspaceRoot, ".opencode", "revela", "blocked-writes")
+          const blockedDir = workspaceMetaPath(workspaceRoot, "blocked-writes")
           mkdirSync(blockedDir, { recursive: true })
           const blockedPath = join(blockedDir, "DECKS-json-direct-write.blocked.md")
           const blocker = `${DECKS_STATE_FILE} is a controlled Revela state file. Use the revela-decks tool instead of write/apply_patch.`
@@ -738,9 +739,9 @@ Next step: use \`revela-decks\` with action \`init\`, \`upsertDeck\`, \`upsertSl
 
         const stateTargets = extractDecksStateTargetsFromPatch(patchText)
         if (stateTargets.length > 0) {
-          const blockedDir = join(workspaceRoot, ".opencode", "revela", "blocked-writes")
+          const blockedDir = workspaceMetaPath(workspaceRoot, "blocked-writes")
           mkdirSync(blockedDir, { recursive: true })
-          const blockedRelativePath = `.opencode/revela/blocked-writes/DECKS-json-direct-patch-${Date.now()}.blocked.md`
+          const blockedRelativePath = workspaceMetaRelativePath("blocked-writes", `DECKS-json-direct-patch-${Date.now()}.blocked.md`)
           const blocker = `${DECKS_STATE_FILE} is a controlled Revela state file. Use the revela-decks tool instead of write/apply_patch.`
           const blockedPatch = `*** Begin Patch
 *** Add File: ${blockedRelativePath}

package/plugins/revela/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "revela": {
       "command": "npx",
-      "args": ["-y", "@cyber-dash-tech/revela@0.18.3", "mcp"]
+      "args": ["-y", "@cyber-dash-tech/revela@0.18.4", "mcp"]
     }
   }
 }

package/plugins/revela/hooks/revela_guard.ts

@@ -22,7 +22,7 @@ export async function runPreWriteChecks(input: string): Promise<HookResult> {
     messages.push([
       "Revela narrative cache patches are blocked.",
       `Controlled cache target(s): ${cacheTargets.map((target) => `\`${target}\``).join(", ")}`,
-      "Edit `revela-narrative/**/*.md` instead; compile/cache files under `.opencode/revela/narrative-cache/` are regenerated.",
+      "Edit `revela-narrative/**/*.md` instead; compile/cache files under `.revela/narrative-cache/` are regenerated.",
     ].join("\n"))
   }
 
@@ -67,7 +67,7 @@ export function extractDeckHtmlPatchTargets(input: string): string[] {
 export function extractNarrativeCachePatchTargets(input: string): string[] {
   const targets = new Set<string>()
   for (const patch of patchPayloads(input)) {
-    const pattern = /(?:^\*\*\* Update File: |^\*\*\* Add File: |^\*\*\* Delete File: |^\*\*\* Move to: )([^\r\n]*\.opencode\/revela\/narrative-cache\/[^\r\n]+)\s*$/gm
+    const pattern = /(?:^\*\*\* Update File: |^\*\*\* Add File: |^\*\*\* Delete File: |^\*\*\* Move to: )([^\r\n]*(?:\.revela|\.opencode\/revela)\/narrative-cache\/[^\r\n]+)\s*$/gm
     let match: RegExpExecArray | null
     while ((match = pattern.exec(patch))) targets.add(match[1].trim())
   }

package/tools/workspace-scan.ts

@@ -13,7 +13,7 @@ const DOC_EXTENSIONS = new Set([
 
 // Directories to exclude from scanning
 const EXCLUDE_DIRS = new Set([
-  "node_modules", ".git", "dist", ".opencode",
+  "node_modules", ".git", "dist", ".opencode", ".revela",
   "researches",  // Exclude revela's own research output
   "revela-narrative", // Exclude canonical narrative vault source files
   "designs", "domains",  // Exclude revela plugin assets