promptslide 0.3.15 → 0.3.16

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.16](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.15...promptslide-v0.3.16) (2026-08-28)
+
+
+### Bug Fixes
+
+* **cli:** guard deck sync against stale slides ([#103](https://github.com/prompticeu/promptslide/issues/103)) ([f8dddc9](https://github.com/prompticeu/promptslide/commit/f8dddc9fe4177c37dbae729d1efc8971aa46ed92))
+
 ## [0.3.15](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.14...promptslide-v0.3.15) (2026-04-09)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptslide",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "description": "CLI and slide engine for PromptSlide presentations",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,6 +24,7 @@
   ],
   "scripts": {
     "build": "tsup",
+    "test": "node --test test/*.test.mjs",
     "prepublishOnly": "npm run build"
   },
   "license": "MIT",

package/src/commands/add.mjs

@@ -21,6 +21,7 @@ import {
   addSlideToDeckConfig,
   replaceDeckConfig
 } from "../utils/deck-config.mjs"
+import { collectRegistrySlideSlugs, partitionDeckSlides } from "../utils/deck-sync.mjs"
 import { confirm, closePrompts } from "../utils/prompts.mjs"
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -164,9 +165,15 @@ export async function add(args) {
       }
     }
   } else if (item.type === "deck" && item.meta?.slides) {
+    const registrySlideSlugs = collectRegistrySlideSlugs(resolved.items)
+    const { available, missing } = partitionDeckSlides(item.meta.slides, registrySlideSlugs)
+    if (missing.length > 0) {
+      console.log(`  ${yellow("⚠")} Skipped ${missing.length} slide(s) listed in the deck but not included in this version:`)
+      console.log(`    ${dim(missing.map(s => s.slug).join(", "))}`)
+    }
     const shouldReplace = await confirm("  Replace entire deck-config.ts with this deck?", true)
     if (shouldReplace) {
-      const slides = item.meta.slides.map(s => ({
+      const slides = available.map(s => ({
         componentName: s.componentName || toPascalCase(s.slug),
         importPath: `@/slides/${s.slug}`,
         steps: s.steps,
@@ -179,7 +186,7 @@ export async function add(args) {
       console.log(`  ${green("✓")} Replaced ${cyan("deck-config.ts")} ${dim(`(${slides.length} slides)`)}`)
     } else {
       // Append individual slides
-      for (const s of item.meta.slides) {
+      for (const s of available) {
         const componentName = s.componentName || toPascalCase(s.slug)
         const importPath = `@/slides/${s.slug}`
         const updated = addSlideToDeckConfig(cwd, { componentName, importPath, steps: s.steps })

package/src/commands/clone.mjs

@@ -8,6 +8,7 @@ import { hexToOklch } from "../utils/colors.mjs"
 import { closePrompts } from "../utils/prompts.mjs"
 import { fetchRegistryItem, resolveRegistryDependencies, writeLockfile } from "../utils/registry.mjs"
 import { toPascalCase, replaceDeckConfig } from "../utils/deck-config.mjs"
+import { collectRegistrySlideSlugs, partitionDeckSlides } from "../utils/deck-sync.mjs"
 import { ensureTsConfig } from "../utils/tsconfig.mjs"
 
 const __filename = fileURLToPath(import.meta.url)
@@ -158,7 +159,13 @@ export async function clone(args) {
 
   // 6. Generate deck-config.ts
   if (item.meta?.slides) {
-    const slides = item.meta.slides.map(s => ({
+    const registrySlideSlugs = collectRegistrySlideSlugs(resolved.items)
+    const { available, missing } = partitionDeckSlides(item.meta.slides, registrySlideSlugs)
+    if (missing.length > 0) {
+      console.log(`  ${yellow("!")} Skipped ${missing.length} slide(s) listed in the deck but not included in this version:`)
+      console.log(`    ${dim(missing.map(s => s.slug).join(", "))}`)
+    }
+    const slides = available.map(s => ({
       componentName: s.componentName || toPascalCase(s.slug),
       importPath: `@/slides/${s.slug}`,
       steps: s.steps,

package/src/commands/create.mjs

@@ -9,6 +9,7 @@ import { hexToOklch, isValidHex } from "../utils/colors.mjs"
 import { prompt, confirm, closePrompts } from "../utils/prompts.mjs"
 import { fetchRegistryItem, resolveRegistryDependencies, writeLockfile } from "../utils/registry.mjs"
 import { toPascalCase, replaceDeckConfig } from "../utils/deck-config.mjs"
+import { collectRegistrySlideSlugs, partitionDeckSlides } from "../utils/deck-sync.mjs"
 import { ensureTsConfig } from "../utils/tsconfig.mjs"
 
 const __filename = fileURLToPath(import.meta.url)
@@ -221,7 +222,13 @@ export async function create(args) {
 
     // Reconstruct deck-config.ts from deckConfig metadata
     if (fromItem.meta?.slides) {
-      const slides = fromItem.meta.slides.map(s => ({
+      const registrySlideSlugs = collectRegistrySlideSlugs(resolved.items)
+      const { available, missing } = partitionDeckSlides(fromItem.meta.slides, registrySlideSlugs)
+      if (missing.length > 0) {
+        console.log(`  ${yellow("⚠")} Skipped ${missing.length} slide(s) listed in the deck but not included in this version:`)
+        console.log(`    ${dim(missing.map(s => s.slug).join(", "))}`)
+      }
+      const slides = available.map(s => ({
         componentName: s.componentName || toPascalCase(s.slug),
         importPath: `@/slides/${s.slug}`,
         steps: s.steps,

package/src/commands/publish.mjs

@@ -5,9 +5,10 @@ import { fileURLToPath } from "node:url"
 import { bold, green, cyan, red, yellow, dim } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
 import { captureSlideAsDataUri, isPlaywrightAvailable, createCaptureSession } from "../utils/export.mjs"
-import { publishToRegistry, registryItemExists, fetchRegistryItem, searchRegistry, updateLockfileItem, updateLockfilePublishConfig, readLockfile, writeLockfile, hashContent, detectPackageManager, requestUploadTokens, uploadBinaryToBlob, assetFileToSlug, detectAssetDepsInContent, readDeckMeta, updateDeckMeta, readItemMeta, updateItemMeta } from "../utils/registry.mjs"
+import { publishToRegistry, registryItemExists, fetchRegistryItem, searchRegistry, updateLockfileItem, updateLockfilePublishConfig, readLockfile, writeLockfile, hashContent, detectPackageManager, requestUploadTokens, uploadBinaryToBlob, assetFileToSlug, detectAssetDepsInContent, readDeckMeta, updateDeckMeta, readItemMeta, updateItemMeta, pruneMissingLockfileItems } from "../utils/registry.mjs"
 import { prompt, confirm, select, closePrompts } from "../utils/prompts.mjs"
 import { parseDeckConfig } from "../utils/deck-config.mjs"
+import { selectSlidesForPublish } from "../utils/deck-sync.mjs"
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const CLI_VERSION = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8")).version
@@ -412,7 +413,7 @@ export async function publish(args) {
   console.log()
 
   if (args[0] === "--help" || args[0] === "-h") {
-    console.log(`  ${bold("Usage:")} promptslide publish ${dim("[file] [--type slide|layout|deck|theme]")}`)
+    console.log(`  ${bold("Usage:")} promptslide publish ${dim("[file] [--type slide|layout|deck|theme] [--all]")}`)
     console.log()
     console.log(`  Publish a slide, layout, or entire deck to the registry.`)
     console.log()
@@ -421,6 +422,9 @@ export async function publish(args) {
     console.log(`    promptslide publish --type layout`)
     console.log(`    promptslide publish --type deck`)
     console.log()
+    console.log(`  ${bold("Options:")}`)
+    console.log(`    --all    Include slide files not referenced by deck-config.ts in a deck publish`)
+    console.log()
     process.exit(0)
   }
 
@@ -433,6 +437,7 @@ export async function publish(args) {
 
   // Determine file to publish
   let typeOverride = null
+  const includeUnreferencedSlides = args.includes("--all")
   const typeIdx = args.indexOf("--type")
   if (typeIdx !== -1 && args[typeIdx + 1]) {
     typeOverride = args[typeIdx + 1]
@@ -538,9 +543,23 @@ export async function publish(args) {
       : []
 
     const slidesDir = join(cwd, "src", "slides")
-    const slideEntries = existsSync(slidesDir)
+    const slideFilesOnDisk = existsSync(slidesDir)
       ? readdirSync(slidesDir).filter(f => f.endsWith(".tsx") || f.endsWith(".ts"))
       : []
+    const slideSelection = selectSlidesForPublish(
+      slideFilesOnDisk,
+      deckConfig.slides,
+      includeUnreferencedSlides
+    )
+    if (slideSelection.missing.length > 0) {
+      console.error(`  ${red("Error:")} deck-config.ts references slide files that do not exist:`)
+      console.error(`    ${slideSelection.missing.join(", ")}`)
+      console.error(`  ${dim("Restore the files or remove their entries from deck-config.ts before publishing.")}`)
+      console.log()
+      closePrompts()
+      process.exit(1)
+    }
+    const slideEntries = slideSelection.selected
 
     // Discover shared source files (src/components/, src/lib/, etc.)
     const sharedSources = discoverSharedSources(cwd)
@@ -555,12 +574,14 @@ export async function publish(args) {
     console.log(`    Slides:  ${slideEntries.length}`)
     if (sharedSources.length) console.log(`    Shared:  ${sharedSources.length} ${dim("(bundled with deck)")}`)
     console.log(`    Total:   ${totalItems} items`)
-    // Info if there are slide files on disk not referenced in deck-config.ts
-    const deckConfigSlideCount = deckConfig.slides.length
-    if (deckConfigSlideCount !== slideEntries.length) {
+    if (slideSelection.unreferenced.length > 0) {
       console.log()
-      console.log(`  ${dim("ℹ")} deck-config.ts has ${deckConfigSlideCount} slides, ${slideEntries.length} slide files on disk`)
-      console.log(`    ${dim("All slides are published. Only deck-config slides appear in the deck preview.")}`)
+      if (includeUnreferencedSlides) {
+        console.log(`  ${yellow("!")} Including ${slideSelection.unreferenced.length} slide file(s) not referenced by deck-config.ts because --all was set:`)
+      } else {
+        console.log(`  ${dim("ℹ")} Skipping ${slideSelection.unreferenced.length} slide file(s) not referenced by deck-config.ts:`)
+      }
+      console.log(`    ${dim(slideSelection.unreferenced.join(", "))}`)
     }
     if (deckConfig.transition) {
       console.log(`    Transition: ${deckConfig.transition}${deckConfig.directionalTransition ? " (directional)" : ""}`)
@@ -612,6 +633,11 @@ export async function publish(args) {
 
     // Read lockfile for skip-if-unchanged
     const lock = readLockfile(cwd)
+    const prunedLockItems = pruneMissingLockfileItems(cwd, lock)
+    if (prunedLockItems.length > 0) {
+      writeLockfile(cwd, lock)
+      console.log(`  ${dim("Pruned missing files from lockfile:")} ${prunedLockItems.join(", ")}`)
+    }
     let published = 0
     let skipped = 0
     let failed = 0

package/src/commands/pull.mjs

@@ -20,6 +20,7 @@ import {
   addSlideToDeckConfig,
   replaceDeckConfig
 } from "../utils/deck-config.mjs"
+import { collectRegistrySlideSlugs, partitionDeckSlides } from "../utils/deck-sync.mjs"
 import { confirm, closePrompts } from "../utils/prompts.mjs"
 
 export async function pull(args) {
@@ -174,9 +175,15 @@ export async function pull(args) {
 
   // Update deck-config.ts
   if (deckItem.type === "deck" && deckItem.meta?.slides) {
+    const registrySlideSlugs = collectRegistrySlideSlugs(resolved.items)
+    const { available, missing } = partitionDeckSlides(deckItem.meta.slides, registrySlideSlugs)
+    if (missing.length > 0) {
+      console.log(`  ${yellow("!")} Skipped ${missing.length} slide(s) listed in the deck but not included in this version:`)
+      console.log(`    ${dim(missing.map(s => s.slug).join(", "))}`)
+    }
     const shouldReplace = await confirm("  Replace deck-config.ts with pulled deck config?", true)
     if (shouldReplace) {
-      const slides = deckItem.meta.slides.map(s => ({
+      const slides = available.map(s => ({
         componentName: s.componentName || toPascalCase(s.slug),
         importPath: `@/slides/${s.slug}`,
         steps: s.steps,
@@ -189,7 +196,7 @@ export async function pull(args) {
       console.log(`  ${green("+")} Replaced ${cyan("deck-config.ts")} ${dim(`(${slides.length} slides)`)}`)
     } else {
       // Append individual slides
-      for (const s of deckItem.meta.slides) {
+      for (const s of available) {
         const componentName = s.componentName || toPascalCase(s.slug)
         const importPath = `@/slides/${s.slug}`
         const updated = addSlideToDeckConfig(cwd, { componentName, importPath, steps: s.steps, section: s.section })

package/src/utils/deck-sync.mjs

@@ -0,0 +1,78 @@
+/**
+ * Return the slide slugs backed by files in a resolved registry dependency set.
+ * Only registry-provided files count; scaffold files already present in a target
+ * directory must not make stale deck metadata look valid.
+ *
+ * @param {object[]} items
+ * @returns {Set<string>}
+ */
+export function collectRegistrySlideSlugs(items) {
+  const slugs = new Set()
+
+  for (const item of items ?? []) {
+    for (const file of item.files ?? []) {
+      const target = String(file.target ?? "")
+        .replaceAll("\\", "/")
+        .replace(/^\.\//, "")
+      const path = String(file.path ?? "")
+        .replaceAll("\\", "/")
+        .replace(/^\.\//, "")
+      const fullPath = `${target.replace(/\/?$/, "/")}${path}`.replace(/\/+/g, "/")
+      const match = fullPath.match(/^src\/slides\/(.+)\.tsx?$/)
+      if (match) slugs.add(match[1])
+    }
+  }
+
+  return slugs
+}
+
+/**
+ * Split deck metadata into entries backed by registry files and stale entries.
+ * Array order is preserved so generated deck configs match the published order.
+ *
+ * @param {object[]} slides
+ * @param {Set<string>} availableSlugs
+ * @returns {{ available: object[], missing: object[] }}
+ */
+export function partitionDeckSlides(slides, availableSlugs) {
+  const available = []
+  const missing = []
+
+  for (const slide of slides ?? []) {
+    if (availableSlugs.has(slide.slug)) available.push(slide)
+    else missing.push(slide)
+  }
+
+  return { available, missing }
+}
+
+/**
+ * Select slide files for deck publishing. By default, only files referenced by
+ * deck-config.ts are included. The opt-in flag retains the legacy publish-all
+ * behavior for users who intentionally publish scratch or library slides.
+ *
+ * @param {string[]} slideEntries
+ * @param {{ slug: string }[]} configuredSlides
+ * @param {boolean} includeUnreferenced
+ * @returns {{ selected: string[], unreferenced: string[], missing: string[] }}
+ */
+export function selectSlidesForPublish(
+  slideEntries,
+  configuredSlides,
+  includeUnreferenced = false
+) {
+  const filesBySlug = new Map(slideEntries.map(file => [file.replace(/\.tsx?$/, ""), file]))
+  const configuredSlugs = new Set(configuredSlides.map(slide => slide.slug))
+  const unreferenced = slideEntries.filter(
+    file => !configuredSlugs.has(file.replace(/\.tsx?$/, ""))
+  )
+  const missing = configuredSlides.map(slide => slide.slug).filter(slug => !filesBySlug.has(slug))
+  const selected = includeUnreferenced
+    ? [...slideEntries]
+    : configuredSlides.flatMap(slide => {
+        const file = filesBySlug.get(slide.slug)
+        return file ? [file] : []
+      })
+
+  return { selected, unreferenced, missing }
+}

package/src/utils/registry.mjs

@@ -150,6 +150,29 @@ export function removeLockfileItem(cwd, slug) {
   writeLockfile(cwd, lock)
 }
 
+/**
+ * Remove lockfile entries whose tracked files have all disappeared locally.
+ * Entries with no files (such as the deck manifest) are retained.
+ *
+ * @param {string} cwd
+ * @param {{ items?: Record<string, { files?: Record<string, string> }> }} lock
+ * @returns {string[]} Removed item slugs
+ */
+export function pruneMissingLockfileItems(cwd, lock) {
+  const removed = []
+  lock.items ||= {}
+
+  for (const [slug, item] of Object.entries(lock.items)) {
+    const paths = Object.keys(item.files ?? {})
+    if (paths.length > 0 && paths.every(path => !existsSync(join(cwd, path)))) {
+      delete lock.items[slug]
+      removed.push(slug)
+    }
+  }
+
+  return removed
+}
+
 /**
  * Build common auth headers for registry API requests.
  * @param {{ token: string, organizationId?: string }} auth