@cyber-dash-tech/revela 0.7.8 → 0.8.1

package/lib/commands/init.ts

@@ -16,9 +16,9 @@ export function buildInitPrompt({
 Goal:
 - Build or update ${DECKS_STATE_FILE}, the workspace-level machine-readable state file for slide deck work.
 - Use the \`revela-decks\` tool for state updates. Do not write or patch ${DECKS_STATE_FILE} directly.
-- Capture stable project context, available source materials, deck history, active deck specs, slide plans, and open questions for future sessions.
-- Do not treat initialization as permission to write a slide deck; each deck must pass a later readiness review.
-- ${DECKS_STATE_FILE} is the source of truth for Revela workspace state.
+- Capture stable project context, available source materials, the current deck spec, slide plan, and open questions for future sessions.
+- Do not treat initialization as permission to write a slide deck; the current deck must pass a later readiness review.
+- ${DECKS_STATE_FILE} is the source of truth for the single current workspace deck.
 
 Current state:
 - ${mode}
@@ -40,12 +40,12 @@ Workflow:
    - \`presentations/**/*.html\`
    - \`decks/**/*.pdf\`
    - \`slides/**/*.pdf\`
-   Run these searches only inside the current workspace root. These are generated/output decks, not necessarily source materials. Record stable history, themes, filenames, and obvious reuse opportunities without treating them as authoritative source data.
+   Run these searches only inside the current workspace root. These are generated/output decks, not necessarily source materials. If \`decks/\` contains exactly one HTML file, treat it as the current deck artifact. If \`decks/\` contains multiple HTML files, stop and ask the user to move extra decks to separate workspaces before adopting one.
 3. Select the files that look most relevant for future slide decks. Prioritize source decks, PDFs, Word docs, spreadsheets, CSVs, Markdown, text notes, and relevant existing generated decks.
 4. For selected PDF/PPTX/DOCX/XLSX files, call \`revela-extract-document-materials\` before deciding what to summarize.
 5. Read only the materials needed to form a conservative workspace memory. Do not exhaustively read every file if the workspace is large.
 6. Call \`revela-decks\` with action \`init\` to create ${DECKS_STATE_FILE} if needed.
-7. If this conversation already contains a concrete deck task, call \`revela-decks\` with action \`upsertDeck\` and later \`upsertSlides\` only for explicit deck spec information. Do not mark readiness ready during init.
+7. If this conversation already contains a concrete deck task, call \`revela-decks\` with action \`upsertDeck\` and later \`upsertSlides\` only for explicit deck spec information. Do not pass or ask for a deck key; the tool uses the workspace folder name internally. Do not mark readiness ready during init.
 8. Report what was initialized or updated and list any open questions.
 
 Memory rules:
@@ -54,6 +54,7 @@ Memory rules:
 - Do not infer personal preferences from one-off requests.
 - Do not store secrets, credentials, API keys, tokens, account details, or sensitive personal information.
 - Do not mark writeReadiness as ready during init unless the current deck has already passed an explicit \`revela-decks\` review.
+- Treat this workspace as a single deck project. If the user wants another deck, guide them to create another workspace/folder rather than adding a second deck record.
 - If new evidence conflicts with existing memory, preserve both briefly and add an Open Question instead of silently overwriting.
 
 Start now by scanning the workspace.`

package/lib/commands/review.ts

@@ -1,16 +1,12 @@
 import { DECKS_STATE_FILE } from "../decks-state"
 
 export function buildReviewPrompt({
-  slug,
   exists,
   workspaceRoot,
 }: {
-  slug?: string
   exists: boolean
   workspaceRoot?: string
 }): string {
-  const target = slug?.trim()
-  const deckTarget = target ? `the deck slug or output path matching \`${target}\`` : "the current active deck"
   const state = exists
     ? `${DECKS_STATE_FILE} exists. Read it through the revela-decks tool.`
     : `${DECKS_STATE_FILE} does not exist yet. Create it through the revela-decks tool if there is enough deck context.`
@@ -18,7 +14,7 @@ export function buildReviewPrompt({
   return `Review Revela deck write readiness.
 
 Goal:
-- Use ${DECKS_STATE_FILE} as the source of truth for whether ${deckTarget} is ready to be written to \`decks/*.html\`.
+- Use ${DECKS_STATE_FILE} as the source of truth for whether the current workspace deck is ready to be written to \`decks/*.html\`.
 - Preserve the deck spec for future sessions: every slide's content, layout, components, evidence, visuals, and production status.
 - Do not write, patch, or directly edit ${DECKS_STATE_FILE}. Use the \`revela-decks\` tool for all state changes.
 - Let \`revela-decks\` action \`review\` compute writeReadiness; do not manually set readiness to ready.
@@ -34,11 +30,11 @@ Workspace boundary rules:
 - For Glob/file searches, use the current workspace as the search root. Do not set the search root to a parent directory or home directory.
 
 Workflow:
-1. Call \`revela-decks\` with action \`read\` for ${deckTarget}.
-2. If no matching deck exists but the conversation contains enough deck context, call \`revela-decks\` action \`upsertDeck\` with slug, goal, outputPath, theme, requiredInputs, and researchPlan.
+1. Call \`revela-decks\` with action \`read\` for the current workspace deck.
+2. If no current deck exists but the conversation contains enough deck context, call \`revela-decks\` action \`upsertDeck\` with goal, outputPath, theme, requiredInputs, and researchPlan. Do not invent or ask for a deck key; the tool uses the workspace folder name internally.
 3. If a user-confirmed slide plan is available, call \`revela-decks\` action \`upsertSlides\` with every slide's title, purpose, layout, components, structured content, evidence, visuals, and status.
 4. Only set requiredInputs fields true when explicit conversation state, files read, research findings read, selected design, fetched layouts/components, or user confirmation supports them. Do not infer completion.
-5. Call \`revela-decks\` action \`review\` for the slug. The tool computes and writes \`writeReadiness\`.
+5. Call \`revela-decks\` action \`review\`. The tool computes and writes \`writeReadiness\` for the current workspace deck.
 6. Briefly report whether the deck is ready. If blocked, list the exact blockers returned by the tool.
 
 Minimum conditions for \`ready\`:
@@ -53,6 +49,7 @@ Minimum conditions for \`ready\`:
 
 Rules:
 - Do not write or overwrite \`decks/*.html\` during review.
+- Treat the workspace as one deck project. If the user wants another deck, tell them to use a separate workspace/folder.
 - Do not write, patch, or directly edit ${DECKS_STATE_FILE}; use \`revela-decks\`.
 - Do not store secrets, credentials, tokens, or sensitive personal information.
 - Do not add inferred user preferences to long-term preference state.

package/lib/decks-state.ts

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs"
-import { basename, dirname, join } from "path"
+import { basename, dirname, join, resolve } from "path"
 
 export const DECKS_STATE_FILE = "DECKS.json"
 
@@ -154,6 +154,29 @@ export function createEmptyDecksState(): DecksState {
   }
 }
 
+export function workspaceDeckSlug(workspaceRoot: string): string {
+  return normalizeSlug(basename(resolve(workspaceRoot)) || "deck") || "deck"
+}
+
+export function normalizeWorkspaceDeckState(state: DecksState, workspaceRoot: string): DecksState {
+  const normalized = normalizeDecksState(state)
+  const keys = Object.keys(normalized.decks)
+  if (keys.length !== 1) return normalized
+
+  const slug = workspaceDeckSlug(workspaceRoot)
+  const existingKey = keys[0]
+  if (existingKey === slug) {
+    normalized.activeDeck = slug
+    return normalized
+  }
+
+  const deck = createDeckSpec({ ...normalized.decks[existingKey], slug })
+  delete normalized.decks[existingKey]
+  normalized.decks[slug] = deck
+  normalized.activeDeck = slug
+  return normalized
+}
+
 export function defaultRequiredInputs(overrides?: Partial<RequiredInputs>): RequiredInputs {
   return {
     topicClarified: false,
@@ -210,6 +233,10 @@ export function readOrCreateDecksState(workspaceRoot: string): DecksState {
 export function upsertDeck(state: DecksState, input: Partial<DeckSpec> & { slug: string }): DecksState {
   const normalized = normalizeDecksState(state)
   const slug = normalizeSlug(input.slug)
+  const existingKey = currentDeckKey(normalized)
+  if (existingKey && slug !== existingKey && !normalized.decks[slug]) {
+    throw new Error(`${DECKS_STATE_FILE} already has a current deck (${existingKey}). Use a separate workspace for another deck.`)
+  }
   const existing = normalized.decks[slug]
   const next = createDeckSpec({ ...existing, ...input, slug })
   normalized.decks[slug] = next
@@ -220,6 +247,10 @@ export function upsertDeck(state: DecksState, input: Partial<DeckSpec> & { slug:
 export function upsertSlides(state: DecksState, slug: string, slides: SlideSpec[]): DecksState {
   const normalized = normalizeDecksState(state)
   const key = normalizeSlug(slug)
+  const existingKey = currentDeckKey(normalized)
+  if (existingKey && key !== existingKey && !normalized.decks[key]) {
+    throw new Error(`${DECKS_STATE_FILE} already has a current deck (${existingKey}). Use a separate workspace for another deck.`)
+  }
   const deck = normalized.decks[key] ?? createDeckSpec({ slug: key })
   const byIndex = new Map(deck.slides.map((slide) => [slide.index, slide]))
   for (const slide of normalizeSlides(slides)) byIndex.set(slide.index, slide)
@@ -231,7 +262,7 @@ export function upsertSlides(state: DecksState, slug: string, slides: SlideSpec[
 
 export function reviewDeckState(state: DecksState, slug?: string): { state: DecksState; result: DeckStateReadinessResult } {
   const normalized = normalizeDecksState(state)
-  const key = normalizeSlug(slug || normalized.activeDeck || "")
+  const key = normalizeSlug(slug || currentDeckKey(normalized) || "")
   const deck = key ? normalized.decks[key] : undefined
   if (!deck) {
     const missing = key || "active deck"
@@ -276,13 +307,14 @@ export function evaluateDeckStateWriteReadiness(state: DecksState, filePath: str
   const targetPath = normalizeDeckPath(filePath)
   const targetSlug = deckSlugFromPath(targetPath)
   const normalized = normalizeDecksState(state)
-  const deck = findDeckForTarget(normalized, targetPath, targetSlug)
+  const key = currentDeckKey(normalized)
+  const deck = key ? normalized.decks[key] : undefined
   if (!deck) {
     return {
       ready: false,
       slug: targetSlug,
-      blocker: `No deck in ${DECKS_STATE_FILE} matches ${targetPath}. Use revela-decks upsertDeck/upsertSlides, then review before writing.`,
-      blockers: [`No deck in ${DECKS_STATE_FILE} matches ${targetPath}.`],
+      blocker: currentDeckBlocker(normalized),
+      blockers: [currentDeckBlocker(normalized)],
     }
   }
 
@@ -324,16 +356,17 @@ export function extractDecksStateTargetsFromPatch(patchText: string): string[] {
 export function buildDecksStatePromptLayer(workspaceRoot: string, maxChars = 14000): string {
   if (!hasDecksState(workspaceRoot)) return ""
   const state = readDecksState(workspaceRoot)
-  const active = state.activeDeck ? state.decks[state.activeDeck] : undefined
+  const activeKey = currentDeckKey(state)
+  const active = activeKey ? state.decks[activeKey] : undefined
   const compact = {
     sourceOfTruth: DECKS_STATE_FILE,
-    activeDeck: state.activeDeck,
+    activeDeck: activeKey,
     workspace: state.workspace,
     deck: active,
   }
   let text = JSON.stringify(compact, null, 2)
   if (text.length > maxChars) text = text.slice(0, maxChars).trimEnd() + "\n[DECKS.json state truncated for prompt size.]"
-  return `---\n\n# Revela Workspace State From ${DECKS_STATE_FILE}\n\n\`\`\`json\n${text}\n\`\`\`\n\nRules for this state layer:\n- Treat ${DECKS_STATE_FILE} as the source of truth for deck specs, slide plans, and write readiness.\n- Do not edit ${DECKS_STATE_FILE} directly; use the revela-decks tool.\n- Before writing decks/*.html, the matching deck must have writeReadiness.status=ready and a complete slide spec.`
+  return `---\n\n# Revela Workspace State From ${DECKS_STATE_FILE}\n\n\`\`\`json\n${text}\n\`\`\`\n\nRules for this state layer:\n- Treat ${DECKS_STATE_FILE} as the source of truth for the single current deck's specs, slide plan, and write readiness.\n- The decks map is compatibility storage; operate only on the current workspace deck.\n- Do not edit ${DECKS_STATE_FILE} directly; use the revela-decks tool.\n- Before writing decks/*.html, the current deck must have writeReadiness.status=ready and a complete slide spec, and its outputPath must match the target file.`
 }
 
 function normalizeDecksState(input: DecksState): DecksState {
@@ -357,9 +390,26 @@ function normalizeDecksState(input: DecksState): DecksState {
     state.decks[normalizedSlug] = createDeckSpec({ ...deck, slug: normalizedSlug })
   }
   if (state.activeDeck && !state.decks[state.activeDeck]) state.activeDeck = undefined
+  if (!state.activeDeck) {
+    const keys = Object.keys(state.decks)
+    if (keys.length === 1) state.activeDeck = keys[0]
+  }
   return state
 }
 
+function currentDeckKey(state: DecksState): string | undefined {
+  if (state.activeDeck && state.decks[state.activeDeck]) return state.activeDeck
+  const keys = Object.keys(state.decks)
+  if (keys.length === 1) return keys[0]
+  return undefined
+}
+
+function currentDeckBlocker(state: DecksState): string {
+  const count = Object.keys(state.decks).length
+  if (count === 0) return `No current deck exists in ${DECKS_STATE_FILE}. Use revela-decks upsertDeck/upsertSlides/review before writing deck HTML.`
+  return `${DECKS_STATE_FILE} contains multiple deck records and no activeDeck. Select one current deck explicitly or move extra decks to separate workspaces.`
+}
+
 function computeDeckBlockers(deck: DeckSpec): string[] {
   const blockers: string[] = []
   if (!deck.goal.trim()) blockers.push("Deck goal is missing")
@@ -402,10 +452,6 @@ function normalizeSlides(slides: SlideSpec[]): SlideSpec[] {
     .sort((a, b) => a.index - b.index)
 }
 
-function findDeckForTarget(state: DecksState, targetPath: string, targetSlug: string): DeckSpec | undefined {
-  return Object.values(state.decks).find((deck) => normalizeDeckPath(deck.outputPath) === targetPath) ?? state.decks[normalizeSlug(targetSlug)]
-}
-
 function hasSlideContent(slide: SlideSpec): boolean {
   const content = slide.content ?? {}
   return Boolean(

package/lib/design/designs.ts

@@ -250,6 +250,20 @@ export function createDesignPackage(args: CreateDesignPackageArgs): CreateDesign
   }
 }
 
+function hasDataAttribute(html: string, attr: string, value: string): boolean {
+  const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+  return new RegExp(`${attr}\\s*=\\s*(["'])${escaped}\\1`).test(html)
+}
+
+function hasSlideRole(html: string, role: string): boolean {
+  const sectionRe = /<section\b[^>]*class\s*=\s*(["'])[^"']*\bslide\b[^"']*\1[^>]*>/gi
+  let match: RegExpExecArray | null
+  while ((match = sectionRe.exec(html)) !== null) {
+    if (hasDataAttribute(match[0], "data-slide-role", role)) return true
+  }
+  return false
+}
+
 /** Validate a local design package for the minimum Revela design contract. */
 export function validateDesignPackage(nameInput: string): ValidateDesignPackageResult {
   let name = nameInput
@@ -298,6 +312,12 @@ export function validateDesignPackage(nameInput: string): ValidateDesignPackageR
     if (!preview.includes('<section class="slide"')) errors.push("preview.html must include slide sections")
     if (!preview.includes("slide-qa=")) errors.push("preview.html slides must include slide-qa attributes")
     if (!preview.includes("slide-canvas")) errors.push("preview.html must include .slide-canvas")
+    if (!hasSlideRole(preview, "cover")) errors.push('preview.html must include a slide section with data-slide-role="cover"')
+    if (!hasSlideRole(preview, "closing")) errors.push('preview.html must include a slide section with data-slide-role="closing"')
+    const missingComponents = components.filter((component) => !hasDataAttribute(preview, "data-preview-component", component))
+    if (missingComponents.length > 0) {
+      errors.push(`preview.html must showcase every @component; missing: ${missingComponents.join(", ")}`)
+    }
   }
 
   return {

package/lib/edit/deck-state.ts

@@ -3,6 +3,8 @@ import { activeDesign } from "../design/designs"
 import { activeDomain } from "../domain/domains"
 import {
   defaultRequiredInputs,
+  DECKS_STATE_FILE,
+  normalizeWorkspaceDeckState,
   readOrCreateDecksState,
   reviewDeckState,
   upsertDeck,
@@ -19,7 +21,11 @@ export interface EditDeckStatePreflightResult {
 }
 
 export function ensureEditableDeckState(workspaceRoot: string, deck: EditableDeck): EditDeckStatePreflightResult {
-  let state = readOrCreateDecksState(workspaceRoot)
+  let state = normalizeWorkspaceDeckState(readOrCreateDecksState(workspaceRoot), workspaceRoot)
+  const active = state.activeDeck ? state.decks[state.activeDeck] : undefined
+  if (active && active.slug !== deck.slug && active.outputPath !== deck.file) {
+    throw new Error(`${DECKS_STATE_FILE} already points to ${active.outputPath}. Revela 0.8 expects one deck per workspace; move extra decks to a separate workspace.`)
+  }
   const existing = state.decks[deck.slug]
   const existingReady = existing?.writeReadiness?.status === "ready" && existing.writeReadiness.blockers.length === 0
   let changed = !existing || existing.outputPath !== deck.file
@@ -112,7 +118,7 @@ function safeActiveDesign(): string {
   try {
     return activeDesign()
   } catch {
-    return "summit"
+    return "aurora"
   }
 }
 

package/lib/edit/open.ts

@@ -14,6 +14,9 @@ export interface OpenEditableDeckResult {
   source: string
   stateNote: string
   preflightChanged: boolean
+  reusedSession: boolean
+  liveSession: boolean
+  openedBrowser: boolean
 }
 
 export interface OpenEditableDeckOptions {
@@ -21,6 +24,11 @@ export interface OpenEditableDeckOptions {
   sessionID: string
   workspaceRoot: string
   openBrowser?: boolean
+  openUrl?: (url: string) => void
+}
+
+export interface EnsureEditableDeckOpenResult extends OpenEditableDeckResult {
+  skippedReason?: "live-session"
 }
 
 export function openUrl(url: string): void {
@@ -41,6 +49,21 @@ export function openUrl(url: string): void {
 }
 
 export function openEditableDeck(target: string, options: OpenEditableDeckOptions): OpenEditableDeckResult {
+  return openEditableDeckInternal(target, options, { skipLiveSession: false })
+}
+
+export function ensureEditableDeckOpenForChange(
+  target: string,
+  options: OpenEditableDeckOptions,
+): EnsureEditableDeckOpenResult {
+  return openEditableDeckInternal(target, options, { skipLiveSession: true })
+}
+
+function openEditableDeckInternal(
+  target: string,
+  options: OpenEditableDeckOptions,
+  behavior: { skipLiveSession: boolean },
+): EnsureEditableDeckOpenResult {
   const deck = resolveEditableDeck(options.workspaceRoot, target)
   const preflight = ensureEditableDeckState(options.workspaceRoot, deck)
   if (!preflight.readiness.ready) {
@@ -55,13 +78,14 @@ export function openEditableDeck(target: string, options: OpenEditableDeckOption
   }
 
   const editServer = startEditServer()
-  const token = editServer.createSession({
+  const session = editServer.getOrCreateSession({
     client: options.client,
     sessionID: options.sessionID,
     deck,
   })
-  const url = `${editServer.baseUrl}/edit?token=${encodeURIComponent(token)}`
-  if (options.openBrowser !== false) openUrl(url)
+  const url = `${editServer.baseUrl}/edit?token=${encodeURIComponent(session.token)}`
+  const shouldOpen = options.openBrowser !== false && !(behavior.skipLiveSession && session.live)
+  if (shouldOpen) (options.openUrl ?? openUrl)(url)
 
   const source = deck.source === "decks-state" ? "DECKS.json" : deck.source === "file-path" ? "file path" : "fallback path"
   const stateNote = preflight.changed ? "Deck state was prepared in DECKS.json before opening the editor." : "Deck state is ready in DECKS.json."
@@ -72,5 +96,9 @@ export function openEditableDeck(target: string, options: OpenEditableDeckOption
     source,
     stateNote,
     preflightChanged: preflight.changed,
+    reusedSession: session.reused,
+    liveSession: session.live,
+    openedBrowser: shouldOpen,
+    skippedReason: behavior.skipLiveSession && session.live ? "live-session" : undefined,
   }
 }

package/lib/edit/resolve-deck.ts

@@ -1,6 +1,6 @@
-import { existsSync } from "fs"
-import { basename, relative, resolve, sep } from "path"
-import { DECKS_STATE_FILE, hasDecksState, isDeckHtmlPath, readDecksState } from "../decks-state"
+import { existsSync, readdirSync } from "fs"
+import { relative, resolve, sep } from "path"
+import { DECKS_STATE_FILE, isDeckHtmlPath, workspaceDeckSlug } from "../decks-state"
 
 export interface EditableDeck {
   slug: string
@@ -9,68 +9,29 @@ export interface EditableDeck {
   source: "decks-state" | "fallback" | "file-path"
 }
 
-export function resolveEditableDeck(workspaceRoot: string, input: string): EditableDeck {
-  const requested = input.trim()
-  if (!requested) return resolveDefaultDeck(workspaceRoot)
-
-  const slug = normalizeSlug(requested)
-
-  if (hasDecksState(workspaceRoot)) {
-    const state = readDecksState(workspaceRoot)
-    const deck = state.decks[requested] ?? (slug ? state.decks[slug] : undefined)
-    if (deck) {
-      return resolveDeckFile(workspaceRoot, deck.slug, deck.outputPath, "decks-state")
-    }
-  }
-
-  if (looksLikePath(requested)) {
-    return resolvePathTarget(workspaceRoot, requested)
-  }
-
-  if (!slug) throw new Error("Deck target must be a deck slug or decks/*.html path.")
-
-  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>.`)
+export function resolveEditableDeck(workspaceRoot: string, input = ""): EditableDeck {
+  if (input.trim()) {
+    throw new Error("/revela edit no longer accepts a target. It opens the only HTML deck in decks/.")
   }
 
-  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 htmlFiles = listDeckHtmlFiles(workspaceRoot)
+  if (htmlFiles.length === 0) {
+    throw new Error("No deck HTML found in decks/. Generate a deck first.")
   }
-
-  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>.`)
+  if (htmlFiles.length > 1) {
+    throw new Error("This workspace contains multiple deck HTML files. Revela 0.8 expects one deck per workspace. Move extra decks to separate workspaces.")
   }
 
-  throw new Error(`${DECKS_STATE_FILE} has multiple decks and no activeDeck. Use /revela edit <target>.`)
+  return resolveDeckFile(workspaceRoot, workspaceDeckSlug(workspaceRoot), htmlFiles[0], "file-path")
 }
 
-function resolvePathTarget(workspaceRoot: string, requested: string): EditableDeck {
-  if (isAbsoluteLike(requested)) {
-    throw new Error("/revela edit only accepts workspace-relative decks/*.html paths.")
-  }
-
-  const normalized = normalizePath(requested).replace(/^\.\//, "")
-  if (!isDeckHtmlPath(normalized)) {
-    throw new Error("/revela edit file paths must point to decks/*.html.")
-  }
-
-  const slug = normalizeSlug(basename(normalized, ".html"))
-  if (!slug) throw new Error("Deck target must be a deck slug or decks/*.html path.")
-  return resolveDeckFile(workspaceRoot, slug, normalized, "file-path")
+function listDeckHtmlFiles(workspaceRoot: string): string[] {
+  const dir = resolve(workspaceRoot, "decks")
+  if (!existsSync(dir)) return []
+  return readdirSync(dir, { withFileTypes: true })
+    .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".html"))
+    .map((entry) => `decks/${entry.name}`)
+    .sort((a, b) => a.localeCompare(b))
 }
 
 function resolveDeckFile(
@@ -93,7 +54,7 @@ function resolveDeckFile(
   }
 
   return {
-    slug: normalizeSlug(slug),
+    slug,
     file: workspaceRelative(root, absoluteFile),
     absoluteFile,
     source,
@@ -107,19 +68,3 @@ function isInside(root: string, target: string): boolean {
 function workspaceRelative(root: string, target: string): string {
   return relative(root, target).split(sep).join("/")
 }
-
-function looksLikePath(value: string): boolean {
-  return value.includes("/") || value.includes("\\") || value.endsWith(".html")
-}
-
-function isAbsoluteLike(value: string): boolean {
-  return value.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(value)
-}
-
-function normalizePath(value: string): string {
-  return value.replace(/\\/g, "/")
-}
-
-function normalizeSlug(value: string): string {
-  return value.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "")
-}