pi-weave 0.1.18 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-weave",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "An agent-native knowledge workspace for your life and your code. Smart notepad + repository exploration, readable by humans and agents alike.",
   "type": "module",
   "sideEffects": false,

package/src/core/frontmatter.ts

@@ -242,12 +242,19 @@ function canonicalBlock(meta: NoteMeta): string[] {
 function replayBlock(meta: NoteMeta, frontMatter: NoteFrontMatter): string[] {
   /** Top-level keys the file declares, in any syntax — including frozen ones. */
   const declared = new Set<string>();
+  /** Values of declared scalar keys, unquoted, to detect defaulted fallbacks. */
+  const declaredValues = new Map<string, string>();
   /** Owned keys already re-rendered, so a duplicate key collapses to one line. */
   const rendered = new Set<string>();
   const out: string[] = [];
 
   for (const line of scanFrontMatter(frontMatter)) {
-    if (line.key !== null) declared.add(line.key);
+    if (line.key !== null) {
+      declared.add(line.key);
+      if (line.scalar) {
+        declaredValues.set(line.key, unquoteField(line.text.slice(line.text.indexOf(":") + 1).trim()));
+      }
+    }
     if (line.key === null || !line.scalar || !MANAGED.has(line.key)) {
       out.push(line.text); // carried verbatim — never interpreted, never reformatted
       continue;
@@ -260,8 +267,13 @@ function replayBlock(meta: NoteMeta, frontMatter: NoteFrontMatter): string[] {
     out.push(renderManaged(line.key as ManagedFrontMatterKey, meta));
   }
 
+  const dateVal = declaredValues.get("date");
+  const createdVal = declaredValues.get("created");
   for (const key of MANAGED_FRONT_MATTER_KEYS) {
     if (declared.has(key) || isDefaulted(key, meta)) continue;
+    if (key === "created" && (!declared.has("created") && !declared.has("date"))) continue;
+    if (key === "created" && dateVal !== undefined && meta.created === dateVal) continue;
+    if (key === "updated" && ((dateVal !== undefined && meta.updated === dateVal) || (createdVal !== undefined && meta.updated === createdVal))) continue;
     out.push(renderManaged(key, meta));
   }
   return out;
@@ -302,10 +314,14 @@ export function parseNoteFile(text: string): ParsedNoteFile {
   if (!title) {
     throw new Error("Front matter is missing required field: title");
   }
+  const createdRaw = parsed.fields.get("created") ?? parsed.fields.get("date");
+  const created = createdRaw ? unquoteField(createdRaw) : "";
+  const updatedRaw = parsed.fields.get("updated") ?? parsed.fields.get("date") ?? created;
+  const updated = updatedRaw ? unquoteField(updatedRaw) : "";
   const meta: NoteMeta = {
     title: unquoteField(title),
-    created: parsed.fields.get("created") ?? "",
-    updated: parsed.fields.get("updated") ?? "",
+    created,
+    updated,
     tags: parseTags(parsed.fields.get("tags") ?? "[]"),
     source: parseSource(parsed.fields.get("source") ?? "human"),
   };

package/src/core/graph/build.ts

@@ -160,15 +160,22 @@ function buildVaultSide(
     .filter((d) => d.length > 0)
     .sort();
   const notesIn = (dir: string): number => kept.filter((n) => n.slug.startsWith(`${dir}/`)).length;
+  const totalNotesIn = (dir: string): number => input.notes.filter((n) => n.slug.startsWith(`${dir}/`)).length;
   for (const dir of noteDirs) {
     const id = `vfolder:${dir}`;
     folderIds.set(dir, id);
+    const keptCount = notesIn(dir);
+    const totalCount = totalNotesIn(dir);
+    const folderDetail: Record<string, string> = { path: dir, notes: String(keptCount) };
+    if (totalCount > keptCount) {
+      folderDetail.warning = `${totalCount - keptCount} older note(s) in this folder omitted by note limit`;
+    }
     nodes.push({
       id,
       kind: "module",
       label: dir.split("/").pop() ?? dir,
       provenance: null,
-      detail: { path: dir, notes: String(notesIn(dir)) },
+      detail: folderDetail,
     });
     const parentDir = dir.split("/").slice(0, -1).join("/");
     const parent = folderIds.get(parentDir) ?? "vault";

package/src/core/index.ts

@@ -17,6 +17,7 @@ export { runDeepScan, type DeepScanOptions, type DeepScanResult, type SummarizeF
 export {
   addNote,
   appendToNote,
+  createFolder,
   deleteFolder,
   deleteNote,
   extractRawTail,

package/src/core/vault.ts

@@ -129,6 +129,14 @@ export async function getNote(root: string, slug: string): Promise<Note | null>
   }
   try {
     const { meta, body, frontMatter } = parseNoteFile(text);
+    if (!meta.updated || !meta.created) {
+      const st = await fs.stat(path).catch(() => null);
+      if (st) {
+        const mtime = st.mtime.toISOString();
+        if (!meta.updated) meta.updated = mtime;
+        if (!meta.created) meta.created = mtime;
+      }
+    }
     return { slug, ...meta, body, frontMatter };
   } catch {
     return null;
@@ -438,6 +446,24 @@ export async function deleteFolder(root: string, folder: string): Promise<VaultM
   });
 }
 
+/** Create a new vault folder. */
+export async function createFolder(root: string, folder: string): Promise<VaultMutationResult> {
+  const trimmed = folder.trim();
+  if (trimmed === "") return { ok: false, reason: "invalid" };
+  const rawParts = trimmed.split("/").map((p) => p.trim()).filter((p) => p.length > 0);
+  if (rawParts.length === 0 || rawParts.some((p) => p === "." || p === "..")) return { ok: false, reason: "invalid" };
+  const parts = rawParts.map(slugify).filter((p) => p.length > 0);
+  if (parts.length === 0) return { ok: false, reason: "invalid" };
+  const target = parts.join("/");
+  const to = resolveFolderPath(root, target);
+  if (to === null) return { ok: false, reason: "invalid" };
+  return withVaultLock(root, async () => {
+    if (await exists(to)) return { ok: false, reason: "collision" };
+    await fs.mkdir(to, { recursive: true });
+    return { ok: true, path: target };
+  });
+}
+
 async function listVaultEntries(root: string): Promise<{ files: string[]; folders: string[] }> {
   const dir = join(root, NOTES_DIR);
   const files: string[] = [];

package/src/web/client/api.ts

@@ -326,5 +326,6 @@ const folderUrl = (path: string, suffix = ""): string => `/api/folder/${path.spl
 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 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 });
 export const deleteFolder = (fetchImpl: FetchLike, path: string) => mutation(fetchImpl, folderUrl(path), "DELETE");