@hyperframes/studio-server 0.8.82 → 0.8.83

package/dist/index.js

@@ -22,18 +22,21 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-FTDTO3QP.js";
+} from "./chunk-HWBORC2U.js";
 import {
   ProxyCapacityError,
   ProxyTranscodeError,
   resolveProxy
-} from "./chunk-G6IIFKXY.js";
+} from "./chunk-EL3UQI46.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
+  folderGone,
   isInHiddenOrVendorDir,
+  isProjectRootMissing,
   isProxyVariantRequest,
   isSafePath,
+  mkdirWithinProject,
   pinWithinProject,
   probeAssetCodec,
   probeMediaMetadata,
@@ -43,7 +46,7 @@ import {
   resolveProxyVariantRequest,
   resolveWithinProject,
   walkDir
-} from "./chunk-TJQ76IEA.js";
+} from "./chunk-WQ2WF2YJ.js";
 import {
   STUDIO_MANUAL_EDITS_PATH,
   createStudioManualEditsRenderBodyScript,
@@ -64,15 +67,7 @@ import { join as join2 } from "path";
 // src/helpers/hfIdPersist.ts
 import { ensureHfIds } from "@hyperframes/parsers/hf-ids";
 import { createHash } from "crypto";
-import {
-  closeSync,
-  constants,
-  fstatSync,
-  mkdirSync,
-  openSync,
-  readFileSync,
-  writeFileSync
-} from "fs";
+import { closeSync, constants, fstatSync, openSync, readFileSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
 
 // src/helpers/atomicFile.ts
@@ -123,7 +118,7 @@ function stampProjectHfIds(projectDir) {
     next[file] = hash;
   }
   try {
-    mkdirSync(dirname(recordPath), { recursive: true });
+    mkdirWithinProject(projectDir, dirname(recordPath));
     writeFileSync(recordPath, JSON.stringify(next));
   } catch {
   }
@@ -408,7 +403,6 @@ import {
   readlinkSync,
   writeFileSync as writeFileSync5,
   writeSync,
-  mkdirSync as mkdirSync4,
   unlinkSync as unlinkSync2,
   rmSync as rmSync3,
   statSync as statSync3,
@@ -469,7 +463,7 @@ import { spawn } from "child_process";
 import {
   existsSync,
   writeFileSync as writeFileSync2,
-  mkdirSync as mkdirSync2,
+  mkdirSync,
   lstatSync as lstatSync2,
   mkdtempSync,
   renameSync,
@@ -558,7 +552,7 @@ function isWaveformCacheDirectory(cacheDir) {
 function writeWaveformCache(cachePath, peaks) {
   const cacheDir = dirname2(cachePath);
   try {
-    mkdirSync2(cacheDir, { mode: 448 });
+    mkdirSync(cacheDir, { mode: 448 });
   } catch (error) {
     if (!(error instanceof Error && "code" in error && error.code === "EEXIST")) throw error;
   }
@@ -585,7 +579,7 @@ import { tmpdir } from "os";
 import { basename, join as join4 } from "path";
 import { FFPROBE_PATH_ENV, findFfBinary as findFfBinary2 } from "@hyperframes/parsers/ff-binaries";
 var VIDEO_EXT = /\.(mp4|webm|mov|mkv|avi|m4v|mxf|mts|m2ts|ts)$/i;
-var AUDIO_EXT = /\.(mp3|wav|ogg|m4a|aac)$/i;
+var AUDIO_EXT = /\.(mp3|wav|ogg|m4a|aac|flac)$/i;
 var defaultRunner = spawnSync;
 var FFPROBE_MISSING = "not checked: ffprobe was not found. Install FFmpeg or set HYPERFRAMES_FFPROBE_PATH.";
 function validateUploadedMedia(filePath, runner = defaultRunner) {
@@ -644,7 +638,7 @@ function validateUploadedMediaBuffer(fileName, buffer, runner = defaultRunner) {
 }
 
 // src/helpers/backupJournal.ts
-import { mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
 import { Buffer as Buffer2 } from "buffer";
 import { join as join5, relative as relative2 } from "path";
 var DEFAULT_KEEP_PER_FILE = 10;
@@ -666,13 +660,14 @@ function snapshotBeforeWrite(projectDir, absPath, options = {}) {
     const content = readFileSync3(absPath);
     const relativePath = relative2(projectDir, absPath);
     const backupDir = join5(projectDir, ".hyperframes", "backup");
-    mkdirSync3(backupDir, { recursive: true });
+    mkdirWithinProject(projectDir, backupDir);
     const backupKey = backupKeyForPath(relativePath);
     const backupPath = nextBackupPath(backupDir, backupKey);
     writeFileSync4(backupPath, content);
     pruneBackups(backupDir, backupKey, options.keepPerFile ?? DEFAULT_KEEP_PER_FILE);
     return { backupPath };
   } catch (error) {
+    if (isProjectRootMissing(error)) throw error;
     if (error && typeof error === "object" && "code" in error && (error.code === "ENOENT" || error.code === "EISDIR")) {
       return { backupPath: null };
     }
@@ -711,6 +706,15 @@ function pruneBackups(backupDir, backupKey, keepPerFile) {
   }
 }
 
+// src/helpers/projectDirMissing.ts
+var PROJECT_DIR_MISSING = { error: "not found", why: "project_dir_missing" };
+var projectDirMissing = (c) => c.json(PROJECT_DIR_MISSING, 404);
+function replaceWithProjectDirMissing(c, hostHeaders) {
+  hostHeaders.delete("content-type");
+  c.res = void 0;
+  c.res = Response.json(PROJECT_DIR_MISSING, { status: 404, headers: hostHeaders });
+}
+
 // src/helpers/fileVersion.ts
 import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
 var RECEIPT_TTL_MS = 1e4;
@@ -905,6 +909,7 @@ import { existsSync as existsSync2, readFileSync as readFileSync5 } from "fs";
 import { randomUUID as randomUUID3 } from "crypto";
 import { dirname as dirname3, relative as relative3, resolve as resolve2, sep as sep2 } from "path";
 import { parseHTML } from "linkedom";
+import { ProjectRootMissingError } from "@hyperframes/core";
 var CompositionInsertionError = class extends Error {
   constructor(message, status) {
     super(message);
@@ -934,6 +939,7 @@ function positiveAttribute(root, ...names) {
 }
 function canonicalProjectPath(projectDir, candidate) {
   if (!candidate) {
+    if (folderGone(projectDir)) throw new ProjectRootMissingError(projectDir);
     throw new CompositionInsertionError("Composition source escapes the project", 400);
   }
   if (!existsSync2(candidate)) {
@@ -1186,10 +1192,8 @@ async function resolveProjectPath(c, adapter, route, opts) {
   if (!project) {
     return { error: c.json({ error: "not found" }, 404) };
   }
-  if (!existsSync3(project.dir)) {
-    return {
-      error: c.json({ error: "not found", why: "project_dir_missing" }, 404)
-    };
+  if (folderGone(project.dir)) {
+    return { error: projectDirMissing(c) };
   }
   const filePath = requestSubPath(c.req.url, `projects/:id/${route}`);
   if (filePath.includes("\0")) {
@@ -1393,9 +1397,8 @@ async function parseMutationBody(c) {
   }
   return { target: body.target, body };
 }
-function ensureDir(filePath) {
-  const dir = dirname4(filePath);
-  if (!existsSync3(dir)) mkdirSync4(dir, { recursive: true });
+function ensureDir(projectDir, filePath) {
+  mkdirWithinProject(projectDir, dirname4(filePath));
 }
 function generateCopyPath(projectDir, originalPath) {
   const ext = originalPath.includes(".") ? "." + originalPath.split(".").pop() : "";
@@ -2645,7 +2648,7 @@ function registerFileRoutes(api, adapter) {
     let backup = { backupPath: null };
     let overwrote;
     if (createOnly) {
-      ensureDir(res.absPath);
+      ensureDir(res.project.dir, res.absPath);
       let fd;
       try {
         fd = openSync2(res.absPath, "wx");
@@ -2727,7 +2730,7 @@ function registerFileRoutes(api, adapter) {
   api.post("/projects/:id/files/*", async (c) => {
     const res = await resolveProjectFile(c, adapter);
     if ("error" in res) return res.error;
-    ensureDir(res.absPath);
+    ensureDir(res.project.dir, res.absPath);
     const body = Buffer.from(await c.req.arrayBuffer());
     try {
       writeFileSync5(res.absPath, body, { flag: "wx" });
@@ -3268,7 +3271,7 @@ function registerFileRoutes(api, adapter) {
     if (existsSync3(newAbs)) {
       return c.json({ error: "already exists" }, 409);
     }
-    ensureDir(newAbs);
+    ensureDir(res.project.dir, newAbs);
     renameSync2(res.absPath, newAbs);
     const updatedFiles = updateReferences(res.project.dir, res.filePath, body.newPath);
     return c.json({ ok: true, path: body.newPath, updatedReferences: updatedFiles });
@@ -3289,7 +3292,7 @@ function registerFileRoutes(api, adapter) {
     if (!destAbs) {
       return c.json({ error: "forbidden" }, 403);
     }
-    ensureDir(destAbs);
+    ensureDir(project.dir, destAbs);
     try {
       writeFileSync5(destAbs, readFileSync6(srcAbs), { flag: "wx" });
     } catch (error) {
@@ -3310,12 +3313,14 @@ function registerFileRoutes(api, adapter) {
     async (c) => {
       const project = await adapter.resolveProject(c.req.param("id"));
       if (!project) return c.json({ error: "not found" }, 404);
+      if (folderGone(project.dir)) return projectDirMissing(c);
       const subDir = c.req.query("dir") ?? "";
       const targetDir = subDir ? resolveWithinProject(project.dir, subDir) : project.dir;
       if (!targetDir) return c.json({ error: "forbidden" }, 403);
-      if (subDir && !existsSync3(targetDir)) mkdirSync4(targetDir, { recursive: true });
       const formData = await c.req.formData();
+      mkdirWithinProject(project.dir, targetDir);
       const result = await processUploadedFiles(formData, targetDir, project.dir);
+      if (folderGone(project.dir)) return projectDirMissing(c);
       return c.json(
         {
           ok: true,
@@ -4134,6 +4139,7 @@ ${etag}`;
         if (err instanceof ProxyCapacityError) {
           return c.text(err.message, 503, { "Retry-After": "5" });
         }
+        if (isProjectRootMissing(err)) throw err;
         const message = err instanceof ProxyTranscodeError ? err.message : "proxy transcode failed";
         return c.text(message, 502);
       }
@@ -4235,7 +4241,7 @@ function registerLintRoutes(api, adapter) {
 
 // src/routes/render.ts
 import { streamSSE } from "hono/streaming";
-import { existsSync as existsSync6, readFileSync as readFileSync10, mkdirSync as mkdirSync5, unlinkSync as unlinkSync3, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync10, unlinkSync as unlinkSync3, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
 import { join as join11 } from "path";
 import { VALID_CANVAS_RESOLUTIONS } from "@hyperframes/parsers";
 import { formatRenderOutputTimestamp, parseFps } from "@hyperframes/core";
@@ -4288,6 +4294,7 @@ function registerRenderRoutes(api, adapter) {
     let composition;
     if (typeof body.composition === "string" && body.composition.length > 0) {
       if (!resolveWithinProject(project.dir, body.composition)) {
+        if (folderGone(project.dir)) return projectDirMissing(c);
         return c.json({ error: "composition path must be within the project directory" }, 400);
       }
       composition = body.composition;
@@ -4302,7 +4309,7 @@ function registerRenderRoutes(api, adapter) {
     const now = /* @__PURE__ */ new Date();
     const jobId = `${project.id}_${formatRenderOutputTimestamp(now)}`;
     const rendersDir = adapter.rendersDir(project);
-    if (!existsSync6(rendersDir)) mkdirSync5(rendersDir, { recursive: true });
+    mkdirWithinProject(project.dir, rendersDir);
     const ext = FORMAT_EXT[format] ?? ".mp4";
     const outputPath = join11(rendersDir, `${jobId}${ext}`);
     const jobState = adapter.startRender({
@@ -4683,7 +4690,6 @@ import {
   closeSync as closeSync3,
   fstatSync as fstatSync3,
   openSync as openSync3,
-  mkdirSync as mkdirSync6,
   readFileSync as readFileSync12,
   readdirSync as readdirSync5,
   renameSync as renameSync3,
@@ -4900,7 +4906,8 @@ function registerThumbnailRoutes(api, adapter) {
         headers: { "Content-Type": contentType, "Cache-Control": "no-cache" }
       });
     }
-    if (url.searchParams.get("cached") === "1") return c.body(null, 404);
+    if (url.searchParams.get("cached") === "1")
+      return c.body(null, 204, { "Cache-Control": "no-cache" });
     try {
       const buffer = await thumbnailGenerationCoordinator.acquire(
         cachePath,
@@ -4926,7 +4933,7 @@ function registerThumbnailRoutes(api, adapter) {
           if (afterGeneration?.project.dir !== project.dir || !inputsUnchanged(afterGeneration.signature) || !inputsUnchanged(createProjectSignature(project.dir))) {
             return generated;
           }
-          mkdirSync6(cacheDir, { recursive: true });
+          mkdirWithinProject(project.dir, cacheDir);
           writeThumbnailAtomically(cachePath, generated);
           return generated;
         }
@@ -4945,6 +4952,7 @@ function registerThumbnailRoutes(api, adapter) {
       if (err instanceof DOMException && err.name === "AbortError") {
         return new Response(null, { status: 499 });
       }
+      if (isProjectRootMissing(err)) throw err;
       const msg = err instanceof Error ? err.message : String(err);
       return c.json({ error: `Thumbnail generation failed: ${msg}` }, 500);
     }
@@ -5139,6 +5147,7 @@ function registerRegistryRoutes(api, adapter) {
     }
     const project = await adapter.resolveProject(c.req.param("id"));
     if (!project) return c.json({ error: "Project not found" }, 404);
+    if (folderGone(project.dir)) return projectDirMissing(c);
     const body = await c.req.json().catch(() => null);
     if (!body?.blockName) {
       return c.json({ error: "blockName is required" }, 400);
@@ -5147,6 +5156,7 @@ function registerRegistryRoutes(api, adapter) {
       const result = await adapter.installRegistryBlock({ project, blockName: body.blockName });
       return c.json(result);
     } catch (err) {
+      if (isProjectRootMissing(err)) return projectDirMissing(c);
       const message = err instanceof Error ? err.message : "Install failed";
       return c.json({ error: message }, 500);
     }
@@ -5253,7 +5263,7 @@ function registerSelectionRoutes(api, adapter) {
 
 // src/routes/media.ts
 import { streamSSE as streamSSE2 } from "hono/streaming";
-import { existsSync as existsSync8, mkdirSync as mkdirSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { basename as basename2, dirname as dirname6, extname as extname2, join as join14, posix } from "path";
 var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([
   ".mp4",
@@ -5410,8 +5420,8 @@ function registerMediaRoutes(api, adapter, options = {}) {
           return c.json({ error: "forbidden" }, 403);
         }
       }
-      mkdirSync7(dirname6(outputPath), { recursive: true });
-      if (backgroundOutputPath) mkdirSync7(dirname6(backgroundOutputPath), { recursive: true });
+      mkdirWithinProject(project.dir, dirname6(outputPath));
+      if (backgroundOutputPath) mkdirWithinProject(project.dir, dirname6(backgroundOutputPath));
       const jobId = makeJobId(project.id, mediaJobs);
       const state = adapter.startBackgroundRemoval({
         project,
@@ -5499,7 +5509,7 @@ import {
   existsSync as existsSync11,
   lstatSync as lstatSync4,
   statSync as statSync10,
-  mkdirSync as mkdirSync11,
+  mkdirSync as mkdirSync5,
   readdirSync as readdirSync7,
   readFileSync as readFileSync19,
   realpathSync,
@@ -5584,7 +5594,7 @@ import { dirname as dirname8, join as join19 } from "path";
 
 // src/history/historyId.ts
 import { randomUUID as randomUUID6 } from "crypto";
-import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync15, statSync as statSync8, writeFileSync as writeFileSync7 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync2, readFileSync as readFileSync15, statSync as statSync8, writeFileSync as writeFileSync7 } from "fs";
 import { basename as basename3, join as join17, resolve as resolve7 } from "path";
 var ID_PATH = join17(".hyperframes", "history-id");
 var ID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
@@ -5632,7 +5642,7 @@ function projectHistoryId(projectDir, historyRoot) {
     );
   if (!id || existsSync10(join17(historyRoot, id)) && !isRecordedFolder(join17(historyRoot, id), folder)) {
     id = randomUUID6();
-    mkdirSync8(join17(dir, ".hyperframes"), { recursive: true });
+    mkdirWithinProject(dir, join17(dir, ".hyperframes"));
     writeFileSync7(join17(dir, ID_PATH), `${id}
 `);
   }
@@ -5647,13 +5657,13 @@ var HistoryIdError = class extends Error {
 };
 function recordProject(historyDir, dir, folder) {
   const record = { dir, ino: folder.ino, born: folder.birthtimeMs, dev: folder.dev };
-  mkdirSync8(historyDir, { recursive: true });
+  mkdirSync2(historyDir, { recursive: true });
   replaceFileAtomically(join17(historyDir, "project.json"), JSON.stringify(record), 420);
 }
 
 // src/history/ownerLock.ts
 import { randomUUID as randomUUID7 } from "crypto";
-import { linkSync, mkdirSync as mkdirSync9, readFileSync as readFileSync16, rmSync as rmSync5, writeFileSync as writeFileSync8 } from "fs";
+import { linkSync, mkdirSync as mkdirSync3, readFileSync as readFileSync16, rmSync as rmSync5, writeFileSync as writeFileSync8 } from "fs";
 import { join as join18 } from "path";
 var HistoryBusyError = class extends Error {
   constructor(pid) {
@@ -5715,7 +5725,7 @@ function evictDeadOwner(file) {
 async function takeHistoryOwnership(home, waitMs) {
   const file = join18(home, "owner.pid");
   const deadline = Date.now() + waitMs;
-  mkdirSync9(home, { recursive: true });
+  mkdirSync3(home, { recursive: true });
   for (; ; ) {
     if (claim(file)) {
       let held = true;
@@ -5737,6 +5747,22 @@ var DAY_MS = 24 * 60 * 60 * 1e3;
 var KEEP_GONE_PROJECT_HISTORY_MS = 14 * DAY_MS;
 var PRUNED_PREFIX = ".pruned-";
 var LAST_PRUNE_FILE = ".last-prune";
+function listProjectHistories(historyRoot) {
+  return namesIn(historyRoot).filter(isHistoryId).flatMap((id) => {
+    const home = join19(historyRoot, id);
+    const projectDir = readRecord(home)?.dir;
+    if (typeof projectDir !== "string" || readId(projectDir) !== id) return [];
+    return [{ id, projectDir, lastUsedMs: lastUsed(home) }];
+  });
+}
+function namesIn(historyRoot) {
+  try {
+    return readdirSync6(historyRoot);
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+}
 async function pruneGoneProjectHistories(historyRoot, options = {}) {
   return (await pruneWithin(historyRoot, options)).pruned;
 }
@@ -5749,13 +5775,7 @@ async function pruneWithin(historyRoot, {
   measure = true
 }) {
   const started = performance.now();
-  let names;
-  try {
-    names = readdirSync6(historyRoot);
-  } catch (error) {
-    if (error.code === "ENOENT") return { pruned: [], finished: true };
-    throw error;
-  }
+  const names = namesIn(historyRoot);
   const pruned = [];
   for (const name of names) {
     if (performance.now() - started >= budgetMs) return { pruned, finished: false };
@@ -5869,7 +5889,7 @@ function pruneGoneProjectHistoriesDaily(historyRoot, now, { onError, budgetMs }
 }
 
 // src/history/historyLog.ts
-import { closeSync as closeSync5, constants as constants4, mkdirSync as mkdirSync10, openSync as openSync5, readFileSync as readFileSync18, writeSync as writeSync2 } from "fs";
+import { closeSync as closeSync5, constants as constants4, mkdirSync as mkdirSync4, openSync as openSync5, readFileSync as readFileSync18, writeSync as writeSync2 } from "fs";
 import { dirname as dirname9 } from "path";
 var START = "start";
 function parseRecord(line) {
@@ -5922,7 +5942,7 @@ function writeLog(file, log) {
     ...log.entries.map((entry) => ({ type: "entry", entry })),
     ...[...log.pins].map((id) => ({ type: "pin", id, pinned: true }))
   ];
-  mkdirSync10(dirname9(file), { recursive: true });
+  mkdirSync4(dirname9(file), { recursive: true });
   replaceFileAtomically(file, records.map((r) => `${JSON.stringify(r)}
 `).join(""), 420);
 }
@@ -6170,7 +6190,7 @@ var Engine = class {
   }
   saveStatCache() {
     const files = JSON.stringify(Object.fromEntries(this.tracked));
-    mkdirSync11(this.home, { recursive: true });
+    mkdirSync5(this.home, { recursive: true });
     replaceFileAtomically(join20(this.home, "stat.json"), files, 420);
   }
   /**
@@ -6884,6 +6904,21 @@ function registerHistoryRoutes(api, adapter) {
 // src/createStudioApi.ts
 function createStudioApi(adapter) {
   const api = new Hono();
+  api.use(async function answerProjectDirMissingAfterErrorHandlers(c, next) {
+    const hostHeaders = new Headers(c.res.headers);
+    await next();
+    if (isProjectRootMissing(c.error)) replaceWithProjectDirMissing(c, hostHeaders);
+  });
+  api.use("/projects/:id/*", async function answerProjectDirMissingForVanishedFolder(c, next) {
+    const hostHeaders = new Headers(c.res.headers);
+    const dirBeforeRoute = await Promise.resolve().then(() => adapter.resolveProject(c.req.param("id"))).then(
+      (project) => project?.dir,
+      () => void 0
+    );
+    await next();
+    if (c.res.status >= 403 && dirBeforeRoute && folderGone(dirBeforeRoute))
+      replaceWithProjectDirMissing(c, hostHeaders);
+  });
   registerProjectRoutes(api, adapter);
   registerFileRoutes(api, adapter);
   registerPreviewRoutes(api, adapter);
@@ -6980,9 +7015,10 @@ function numericAttribute(element, name) {
 
 // src/helpers/previewDocumentStore.ts
 import { createHash as createHash8 } from "crypto";
-import { mkdirSync as mkdirSync12, readFileSync as readFileSync20, readdirSync as readdirSync8, rmSync as rmSync7 } from "fs";
+import { readFileSync as readFileSync20, readdirSync as readdirSync8, rmSync as rmSync7 } from "fs";
 import { join as join21 } from "path";
-function createPreviewDocumentStore(dir, salt) {
+function createPreviewDocumentStore(projectDir, salt) {
+  const dir = join21(projectDir, ".hyperframes", "preview");
   const fileFor = (key) => join21(dir, `${createHash8("sha256").update(`${salt}
 ${key}`).digest("hex").slice(0, 32)}.html`);
   return {
@@ -6995,7 +7031,7 @@ ${key}`).digest("hex").slice(0, 32)}.html`);
     },
     write(key, html) {
       try {
-        mkdirSync12(dir, { recursive: true });
+        mkdirWithinProject(projectDir, dir);
         const file = fileFor(key);
         replaceFileAtomically(file, html, 420);
         for (const name of readdirSync8(dir)) {
@@ -7109,6 +7145,7 @@ export {
   historyCache,
   identifyFileWrite,
   isSafePath,
+  listProjectHistories,
   openProjectHistory,
   parseSourceDocument,
   patchElementInHtml,