pi-weave 0.3.12 → 0.3.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-weave",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "Local-first Markdown memory and knowledge graph for Pi and OpenCode: preserve decisions, recall sessions, and explore notes with code.",
   "type": "module",
   "sideEffects": false,

package/src/core/index.ts

@@ -64,6 +64,9 @@ export {
   getNote,
   listNotes,
   moveNote,
+  moveHtmlArtifact,
+  renameHtmlArtifact,
+  deleteHtmlArtifact,
   parseHtmlArtifact,
   renameFolder,
   readVault,

package/src/core/vault.ts

@@ -764,6 +764,80 @@ export async function moveNote(root: string, slug: string, folder: string | null
   });
 }
 
+/**
+ * Move a standalone HTML artifact to an existing vault folder, or to the vault
+ * root with `null`. Notes that link to it by path follow it, as they do a note.
+ */
+export async function moveHtmlArtifact(root: string, slug: string, folder: string | null): Promise<VaultMutationResult> {
+  const from = resolveHtmlPath(root, slug);
+  if (from === null) return { ok: false, reason: "invalid" };
+  const targetDir = folder === null ? join(root, NOTES_DIR) : resolveFolderPath(root, folder);
+  if (targetDir === null || !(await isDirectory(targetDir))) return { ok: false, reason: "missing" };
+  const target = folder === null ? basename(slug) : `${folder}/${basename(slug)}`;
+  const to = resolveHtmlPath(root, target)!;
+  return withVaultLock(root, async () => {
+    if (!(await exists(from))) return { ok: false, reason: "missing" };
+    if (from === to) return { ok: true, slug };
+    if (await exists(to)) return { ok: false, reason: "collision" };
+    await fs.rename(from, to);
+    await repointBacklinks(root, new Map([[slug, target]]));
+    return { ok: true, slug: target };
+  });
+}
+
+/**
+ * Rename a standalone HTML artifact in place. The new name sets the file name
+ * (slugified, extension kept) and the title the workspace shows, which lives
+ * in a leading `<!-- --- title: ... --- -->` comment or in `<title>`; a file
+ * with neither takes its title from the file name. Links follow the file.
+ */
+export async function renameHtmlArtifact(root: string, slug: string, name: string): Promise<VaultMutationResult> {
+  const from = resolveHtmlPath(root, slug);
+  const title = name.trim().replace(/\.html?$/i, "").trim();
+  if (from === null || title === "") return { ok: false, reason: "invalid" };
+  const ext = /\.html?$/i.exec(slug)![0];
+  const parent = slug.split("/").slice(0, -1).join("/");
+  const target = [...(parent === "" ? [] : [parent]), `${slugify(title)}${ext}`].join("/");
+  const to = resolveHtmlPath(root, target)!;
+  return withVaultLock(root, async () => {
+    let text: string;
+    try {
+      text = await fs.readFile(from, "utf8");
+    } catch {
+      return { ok: false, reason: "missing" };
+    }
+    if (from !== to && await exists(to)) return { ok: false, reason: "collision" };
+    await fs.writeFile(from, retitleHtml(text, title), "utf8");
+    if (from === to) return { ok: true, slug };
+    await fs.rename(from, to);
+    await repointBacklinks(root, new Map([[slug, target]]));
+    return { ok: true, slug: target };
+  });
+}
+
+/** Set the title `parseHtmlArtifact` reads, leaving every other byte alone. */
+function retitleHtml(text: string, title: string): string {
+  const comment = /<!--[\s\S]*?---\n([\s\S]*?)\n---[\s\S]*?-->/m.exec(text);
+  if (comment !== null && /^title:.*$/m.test(comment[1]!)) {
+    // `-->` would close the comment early.
+    const fields = comment[1]!.replace(/^title:.*$/m, () => `title: ${quoteField(title.replace(/-->/g, "->"))}`);
+    return text.slice(0, comment.index) + comment[0].replace(comment[1]!, () => fields) + text.slice(comment.index + comment[0].length);
+  }
+  const escaped = title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return text.replace(/(<title\b[^>]*>)[\s\S]*?(<\/title>)/i, (_, open: string, close: string) => `${open}${escaped}${close}`);
+}
+
+/** Permanently delete one standalone HTML artifact. */
+export async function deleteHtmlArtifact(root: string, slug: string): Promise<VaultMutationResult> {
+  const path = resolveHtmlPath(root, slug);
+  if (path === null) return { ok: false, reason: "invalid" };
+  return withVaultLock(root, async () => {
+    if (!(await exists(path))) return { ok: false, reason: "missing" };
+    await fs.unlink(path);
+    return { ok: true };
+  });
+}
+
 /** Permanently delete one note. */
 export async function deleteNote(root: string, slug: string): Promise<VaultMutationResult> {
   const path = resolveNotePath(root, slug);
@@ -789,12 +863,12 @@ export async function renameFolder(root: string, folder: string, name: string):
     if (!(await isDirectory(from))) return { ok: false, reason: "missing" };
     if (from !== to && await exists(to)) return { ok: false, reason: "collision" };
     if (from === to) return { ok: true, path: target };
-    // Every note under the folder changes slug, so the whole subtree's
-    // backlinks move with it — collected before the rename, while the old
-    // paths still exist.
+    // Every note and HTML file under the folder changes slug, so the whole
+    // subtree's backlinks move with it — collected before the rename, while
+    // the old paths still exist. HTML slugs keep their extension.
     const moved = (await listNoteFiles(root))
-      .filter((f) => isMarkdown(f) && f.startsWith(`${folder}/`))
-      .map((f) => f.slice(0, -".md".length));
+      .filter((f) => f.startsWith(`${folder}/`))
+      .map((f) => isMarkdown(f) ? f.slice(0, -".md".length) : f);
     await fs.rename(from, to);
     await moveHistoryFolder(root, folder, target);
     await repointBacklinks(root, new Map(moved.map((s) => [s, `${target}/${s.slice(folder.length + 1)}`])));

package/src/core/view/tree.ts

@@ -273,8 +273,8 @@ export function treeRows(model: GraphModel, state: TreeState): TreeRow[] {
 export function treeEmptyHint(model: GraphModel): string | null {
   const vault = model.nodes.find((n) => n.kind === "vault");
   if (!vault) return null;
-  // no notes and no repository
-  const hasNotes = model.nodes.some((n) => n.kind === "note");
+  // nothing in the vault (no note, HTML file or folder) and no repository
+  const hasNotes = model.nodes.some((n) => n.kind === "note" || n.id.startsWith("artifact:") || n.id.startsWith("vfolder:"));
   const hasRepo = model.nodes.some((n) => n.kind === "repository");
   if (!hasNotes && !hasRepo) return "no notes yet — add one with the weave_note tool";
   return null;

package/src/web/client/api.ts

@@ -411,6 +411,7 @@ function mutation(fetchImpl: FetchLike, url: string, method: string, body?: unkn
 
 const noteUrl = (slug: string, suffix = ""): string => `/api/note/${encodeURIComponent(slug)}${suffix}`;
 const folderUrl = (path: string, suffix = ""): string => `/api/folder/${path.split("/").map(encodeURIComponent).join("/")}${suffix}`;
+const artifactUrl = (path: string, suffix = ""): string => `/api/artifact/${path.split("/").map(encodeURIComponent).join("/")}${suffix}`;
 
 /**
  * `POST /api/note/:slug` — save the note's Markdown body. No revision
@@ -421,6 +422,9 @@ export const saveNote = (fetchImpl: FetchLike, slug: string, body: string, raw =
   mutation(fetchImpl, noteUrl(slug), "POST", raw ? { body, raw: true } : { body });
 export const renameNote = (fetchImpl: FetchLike, slug: string, name: string) => mutation(fetchImpl, noteUrl(slug, "/rename"), "POST", { name });
 export const moveNote = (fetchImpl: FetchLike, slug: string, folder: string | null) => mutation(fetchImpl, noteUrl(slug, "/move"), "POST", { folder });
+export const moveArtifact = (fetchImpl: FetchLike, slug: string, folder: string | null) => mutation(fetchImpl, artifactUrl(slug, "/move"), "POST", { folder });
+export const renameArtifact = (fetchImpl: FetchLike, slug: string, name: string) => mutation(fetchImpl, artifactUrl(slug, "/rename"), "POST", { name });
+export const deleteArtifact = (fetchImpl: FetchLike, slug: string) => mutation(fetchImpl, artifactUrl(slug), "DELETE");
 export const deleteNote = (fetchImpl: FetchLike, slug: string) => mutation(fetchImpl, noteUrl(slug), "DELETE");
 export const createFolder = (fetchImpl: FetchLike, path: string) => mutation(fetchImpl, folderUrl(path), "POST");
 export const renameFolder = (fetchImpl: FetchLike, path: string, name: string) => mutation(fetchImpl, folderUrl(path, "/rename"), "POST", { name });