poe-code 3.0.184 → 3.0.186

package/packages/memory/dist/write.js

@@ -0,0 +1,76 @@
+import * as fs from "node:fs/promises";
+import path from "node:path";
+import { parseFrontmatter, serializeFrontmatter } from "./frontmatter.js";
+import { initMemory } from "./init.js";
+import { withLock } from "./lock.js";
+import { assertSafeRelPath, MEMORY_LOCK_RELPATH, MEMORY_PAGES_DIR_RELPATH } from "./paths.js";
+import { reconcile, snapshot } from "./reconcile.js";
+export async function writePage(root, relPath, body, opts) {
+    const pageRelPath = assertPageRelPath(relPath);
+    return withLock(root, async () => {
+        const before = await snapshot(root);
+        await fs.mkdir(path.dirname(path.join(root, pageRelPath)), { recursive: true });
+        await fs.writeFile(path.join(root, pageRelPath), serializeFrontmatter(opts.frontmatter ?? {}, body), "utf8");
+        return reconcile(root, before, "update", opts.reason);
+    });
+}
+export async function appendToPage(root, relPath, content, opts) {
+    const pageRelPath = assertPageRelPath(relPath);
+    return withLock(root, async () => {
+        const before = await snapshot(root);
+        const pagePath = path.join(root, pageRelPath);
+        await fs.mkdir(path.dirname(pagePath), { recursive: true });
+        const existing = await readMarkdownIfPresent(pagePath);
+        const parsed = existing === undefined ? { frontmatter: {}, body: "" } : parseFrontmatter(existing);
+        await fs.writeFile(pagePath, serializeFrontmatter(parsed.frontmatter, `${parsed.body}${content}`), "utf8");
+        return reconcile(root, before, "update", opts.reason);
+    });
+}
+export async function clearMemory(root) {
+    await withLock(root, async () => {
+        await removeChildren(root);
+        await initMemory(root);
+    });
+}
+async function removeChildren(directoryPath) {
+    for (const entryName of await fs.readdir(directoryPath)) {
+        if (entryName === MEMORY_LOCK_RELPATH) {
+            continue;
+        }
+        const entryPath = path.join(directoryPath, entryName);
+        const stat = await fs.stat(entryPath);
+        if (stat.isDirectory()) {
+            await removeDirectory(entryPath);
+            continue;
+        }
+        if (stat.isFile()) {
+            await fs.unlink(entryPath);
+        }
+    }
+}
+async function removeDirectory(directoryPath) {
+    await removeChildren(directoryPath);
+    await fs.rmdir(directoryPath);
+}
+function assertPageRelPath(relPath) {
+    const normalizedRelPath = assertSafeRelPath(relPath);
+    if (!normalizedRelPath.startsWith(`${MEMORY_PAGES_DIR_RELPATH}/`) ||
+        path.posix.extname(normalizedRelPath).toLowerCase() !== ".md") {
+        throw new Error(`Expected a markdown page path under "${MEMORY_PAGES_DIR_RELPATH}/".`);
+    }
+    return normalizedRelPath;
+}
+async function readMarkdownIfPresent(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}