grounder 0.4.0 → 0.6.0

package/dist/vault/list-handoffs.js

@@ -1,30 +1,47 @@
-import { readdir } from "node:fs/promises";
+import { stat } from "node:fs/promises";
 import path from "node:path";
-/**
- * Lists handoff markdown files under `logsDir`, newest filename first.
- * Returns absolute paths. Missing or empty dirs yield `[]`.
- */
-export async function listHandoffs(logsDir, options = {}) {
-    let entries;
-    try {
-        entries = await readdir(logsDir);
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            return [];
+import { vaultRelativePath } from "../util/path.js";
+import { listMarkdownFiles } from "./list-markdown.js";
+function rankHandoffPaths(mdPaths, logsDir) {
+    const ranked = mdPaths.map((filePath) => ({
+        filePath,
+        name: path.basename(filePath),
+        rel: vaultRelativePath(logsDir, filePath),
+    }));
+    ranked.sort((a, b) => {
+        if (a.name !== b.name) {
+            return a.name < b.name ? 1 : -1;
         }
-        throw error;
-    }
-    const paths = entries
-        .filter((name) => name.endsWith(".md"))
-        .sort((a, b) => (a < b ? 1 : a > b ? -1 : 0))
-        .map((name) => path.join(logsDir, name));
-    if (options.limit === undefined) {
-        return paths;
+        return a.rel < b.rel ? 1 : a.rel > b.rel ? -1 : 0;
+    });
+    return ranked.map((entry) => entry.filePath);
+}
+function applyLimit(paths, limit) {
+    if (limit === undefined) {
+        return [...paths];
     }
-    if (options.limit <= 0) {
+    if (limit <= 0) {
         return [];
     }
-    return paths.slice(0, options.limit);
+    return paths.slice(0, limit);
+}
+/**
+ * Lists handoff markdown files under `logsDir` recursively, newest basename
+ * first (timestamp-prefixed names sort correctly), with each entry's mtime
+ * attached. Same basename in different subfolders ties break by
+ * vault-relative path descending. Missing or empty dirs yield `[]`.
+ *
+ * Ranking never reads mtime (filenames already sort correctly), so this
+ * stats only the paths a `limit` actually keeps, not the whole bucket.
+ */
+export async function listHandoffsDetailed(logsDir, options = {}) {
+    const mdPaths = await listMarkdownFiles(logsDir);
+    const paths = applyLimit(rankHandoffPaths(mdPaths, logsDir), options.limit);
+    return Promise.all(paths.map(async (filePath) => ({ path: filePath, mtimeMs: (await stat(filePath)).mtimeMs })));
+}
+/** Same ranking as {@link listHandoffsDetailed}, paths only (no stat calls). */
+export async function listHandoffs(logsDir, options = {}) {
+    const mdPaths = await listMarkdownFiles(logsDir);
+    return applyLimit(rankHandoffPaths(mdPaths, logsDir), options.limit);
 }
 //# sourceMappingURL=list-handoffs.js.map

package/dist/vault/list-handoffs.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-handoffs.js","sourceRoot":"","sources":["../../src/vault/list-handoffs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAA+B,EAAE;IAEjC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"list-handoffs.js","sourceRoot":"","sources":["../../src/vault/list-handoffs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAavD,SAAS,gBAAgB,CAAC,OAA0B,EAAE,OAAe;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxC,QAAQ;QACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,GAAG,EAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC1C,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,UAAU,CAAC,KAAwB,EAAE,KAAyB;IACrE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,UAA+B,EAAE;IAEjC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAA+B,EAAE;IAEjC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/dist/vault/list-markdown.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recursively lists `*.md` files under `rootDir` (absolute paths).
+ * Missing dirs yield `[]`. Does not follow directory symlinks (`Dirent`
+ * type checks); plain files that are symlinks to `.md` are included when
+ * `isFile()` reports true.
+ */
+export declare function listMarkdownFiles(rootDir: string): Promise<string[]>;
+//# sourceMappingURL=list-markdown.d.ts.map

package/dist/vault/list-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-markdown.d.ts","sourceRoot":"","sources":["../../src/vault/list-markdown.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B1E"}

package/dist/vault/list-markdown.js

@@ -0,0 +1,35 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Recursively lists `*.md` files under `rootDir` (absolute paths).
+ * Missing dirs yield `[]`. Does not follow directory symlinks (`Dirent`
+ * type checks); plain files that are symlinks to `.md` are included when
+ * `isFile()` reports true.
+ */
+export async function listMarkdownFiles(rootDir) {
+    const results = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return;
+            }
+            throw error;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                results.push(full);
+            }
+        }
+    }
+    await walk(rootDir);
+    return results;
+}
+//# sourceMappingURL=list-markdown.js.map

package/dist/vault/list-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-markdown.js","sourceRoot":"","sources":["../../src/vault/list-markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,IAAI,CAAC,GAAW;QAC7B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/vault/list-notes.d.ts

@@ -2,14 +2,23 @@ export interface ListNotesOptions {
     /** Max paths to return (newest first). Omit to return all. */
     limit?: number;
 }
+/** One note with the mtime already used to rank it (see {@link listNotesDetailed}). */
+export interface NoteEntry {
+    path: string;
+    mtimeMs: number;
+}
 /**
- * Lists note markdown files under `notesDir`, newest mtime first.
- * Returns absolute paths. Missing or empty dirs yield `[]`.
- * Ties break by filename descending for stable output.
+ * Lists note markdown files under `notesDir` recursively, newest mtime first,
+ * with each entry's mtime attached — the same stat this module already does
+ * internally to rank notes, just not thrown away after sorting. Missing or
+ * empty dirs yield `[]`. Ties break by vault-relative path descending for
+ * stable output.
  *
- * Filename-descending alone is a viable alternative for notes (timestamp
- * prefixes, like `listHandoffs`), but this intentionally matches `listPlans`
- * for consistency across list commands.
+ * Matches {@link listPlans} sorting for consistency across list commands
+ * (filename-descending alone is viable for timestamp-prefixed notes, like
+ * {@link listHandoffs}).
  */
+export declare function listNotesDetailed(notesDir: string, options?: ListNotesOptions): Promise<NoteEntry[]>;
+/** Same ranking as {@link listNotesDetailed}, paths only. */
 export declare function listNotes(notesDir: string, options?: ListNotesOptions): Promise<string[]>;
 //# sourceMappingURL=list-notes.d.ts.map

package/dist/vault/list-notes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-notes.d.ts","sourceRoot":"","sources":["../../src/vault/list-notes.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB"}
+{"version":3,"file":"list-notes.d.ts","sourceRoot":"","sources":["../../src/vault/list-notes.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,EAAE,CAAC,CAyBtB;AAED,6DAA6D;AAC7D,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/vault/list-notes.js

@@ -1,44 +1,40 @@
-import { readdir, stat } from "node:fs/promises";
-import path from "node:path";
+import { stat } from "node:fs/promises";
+import { vaultRelativePath } from "../util/path.js";
+import { listMarkdownFiles } from "./list-markdown.js";
 /**
- * Lists note markdown files under `notesDir`, newest mtime first.
- * Returns absolute paths. Missing or empty dirs yield `[]`.
- * Ties break by filename descending for stable output.
+ * Lists note markdown files under `notesDir` recursively, newest mtime first,
+ * with each entry's mtime attached — the same stat this module already does
+ * internally to rank notes, just not thrown away after sorting. Missing or
+ * empty dirs yield `[]`. Ties break by vault-relative path descending for
+ * stable output.
  *
- * Filename-descending alone is a viable alternative for notes (timestamp
- * prefixes, like `listHandoffs`), but this intentionally matches `listPlans`
- * for consistency across list commands.
+ * Matches {@link listPlans} sorting for consistency across list commands
+ * (filename-descending alone is viable for timestamp-prefixed notes, like
+ * {@link listHandoffs}).
  */
-export async function listNotes(notesDir, options = {}) {
-    let entries;
-    try {
-        entries = await readdir(notesDir);
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            return [];
-        }
-        throw error;
-    }
-    const mdNames = entries.filter((name) => name.endsWith(".md"));
-    const withMtime = await Promise.all(mdNames.map(async (name) => {
-        const filePath = path.join(notesDir, name);
+export async function listNotesDetailed(notesDir, options = {}) {
+    const mdPaths = await listMarkdownFiles(notesDir);
+    const withMtime = await Promise.all(mdPaths.map(async (filePath) => {
         const { mtimeMs } = await stat(filePath);
-        return { filePath, name, mtimeMs };
+        return { filePath, rel: vaultRelativePath(notesDir, filePath), mtimeMs };
     }));
     withMtime.sort((a, b) => {
         if (a.mtimeMs !== b.mtimeMs) {
             return b.mtimeMs - a.mtimeMs;
         }
-        return a.name < b.name ? 1 : a.name > b.name ? -1 : 0;
+        return a.rel < b.rel ? 1 : a.rel > b.rel ? -1 : 0;
     });
-    const paths = withMtime.map((entry) => entry.filePath);
+    const entries = withMtime.map((entry) => ({ path: entry.filePath, mtimeMs: entry.mtimeMs }));
     if (options.limit === undefined) {
-        return paths;
+        return entries;
     }
     if (options.limit <= 0) {
         return [];
     }
-    return paths.slice(0, options.limit);
+    return entries.slice(0, options.limit);
+}
+/** Same ranking as {@link listNotesDetailed}, paths only. */
+export async function listNotes(notesDir, options = {}) {
+    return (await listNotesDetailed(notesDir, options)).map((entry) => entry.path);
 }
 //# sourceMappingURL=list-notes.js.map

package/dist/vault/list-notes.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-notes.js","sourceRoot":"","sources":["../../src/vault/list-notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,UAA4B,EAAE;IAE9B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"list-notes.js","sourceRoot":"","sources":["../../src/vault/list-notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAavD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3E,CAAC,CAAC,CACH,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7F,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,UAA4B,EAAE;IAE9B,OAAO,CAAC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC"}

package/dist/vault/list-plans.d.ts

@@ -2,10 +2,19 @@ export interface ListPlansOptions {
     /** Max paths to return (newest first). Omit to return all. */
     limit?: number;
 }
+/** One plan with the mtime already used to rank it (see {@link listPlansDetailed}). */
+export interface PlanEntry {
+    path: string;
+    mtimeMs: number;
+}
 /**
- * Lists plan markdown files under `plansDir`, newest mtime first.
- * Returns absolute paths. Missing or empty dirs yield `[]`.
- * Ties break by filename descending for stable output.
+ * Lists plan markdown files under `plansDir` recursively, newest mtime first,
+ * with each entry's mtime attached — the same stat this module already does
+ * internally to rank plans, just not thrown away after sorting. Missing or
+ * empty dirs yield `[]`. Ties break by vault-relative path descending for
+ * stable output.
  */
+export declare function listPlansDetailed(plansDir: string, options?: ListPlansOptions): Promise<PlanEntry[]>;
+/** Same ranking as {@link listPlansDetailed}, paths only. */
 export declare function listPlans(plansDir: string, options?: ListPlansOptions): Promise<string[]>;
 //# sourceMappingURL=list-plans.d.ts.map

package/dist/vault/list-plans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-plans.d.ts","sourceRoot":"","sources":["../../src/vault/list-plans.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB"}
+{"version":3,"file":"list-plans.d.ts","sourceRoot":"","sources":["../../src/vault/list-plans.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,EAAE,CAAC,CAyBtB;AAED,6DAA6D;AAC7D,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/vault/list-plans.js

@@ -1,40 +1,36 @@
-import { readdir, stat } from "node:fs/promises";
-import path from "node:path";
+import { stat } from "node:fs/promises";
+import { vaultRelativePath } from "../util/path.js";
+import { listMarkdownFiles } from "./list-markdown.js";
 /**
- * Lists plan markdown files under `plansDir`, newest mtime first.
- * Returns absolute paths. Missing or empty dirs yield `[]`.
- * Ties break by filename descending for stable output.
+ * Lists plan markdown files under `plansDir` recursively, newest mtime first,
+ * with each entry's mtime attached — the same stat this module already does
+ * internally to rank plans, just not thrown away after sorting. Missing or
+ * empty dirs yield `[]`. Ties break by vault-relative path descending for
+ * stable output.
  */
-export async function listPlans(plansDir, options = {}) {
-    let entries;
-    try {
-        entries = await readdir(plansDir);
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            return [];
-        }
-        throw error;
-    }
-    const mdNames = entries.filter((name) => name.endsWith(".md"));
-    const withMtime = await Promise.all(mdNames.map(async (name) => {
-        const filePath = path.join(plansDir, name);
+export async function listPlansDetailed(plansDir, options = {}) {
+    const mdPaths = await listMarkdownFiles(plansDir);
+    const withMtime = await Promise.all(mdPaths.map(async (filePath) => {
         const { mtimeMs } = await stat(filePath);
-        return { filePath, name, mtimeMs };
+        return { filePath, rel: vaultRelativePath(plansDir, filePath), mtimeMs };
     }));
     withMtime.sort((a, b) => {
         if (a.mtimeMs !== b.mtimeMs) {
             return b.mtimeMs - a.mtimeMs;
         }
-        return a.name < b.name ? 1 : a.name > b.name ? -1 : 0;
+        return a.rel < b.rel ? 1 : a.rel > b.rel ? -1 : 0;
     });
-    const paths = withMtime.map((entry) => entry.filePath);
+    const entries = withMtime.map((entry) => ({ path: entry.filePath, mtimeMs: entry.mtimeMs }));
     if (options.limit === undefined) {
-        return paths;
+        return entries;
     }
     if (options.limit <= 0) {
         return [];
     }
-    return paths.slice(0, options.limit);
+    return entries.slice(0, options.limit);
+}
+/** Same ranking as {@link listPlansDetailed}, paths only. */
+export async function listPlans(plansDir, options = {}) {
+    return (await listPlansDetailed(plansDir, options)).map((entry) => entry.path);
 }
 //# sourceMappingURL=list-plans.js.map

package/dist/vault/list-plans.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-plans.js","sourceRoot":"","sources":["../../src/vault/list-plans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,UAA4B,EAAE;IAE9B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"list-plans.js","sourceRoot":"","sources":["../../src/vault/list-plans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAavD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3E,CAAC,CAAC,CACH,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7F,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,UAA4B,EAAE;IAE9B,OAAO,CAAC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC"}

package/dist/vault/search.d.ts

@@ -0,0 +1,55 @@
+/** One line-level match inside a markdown file. */
+export interface SearchLineHit {
+    line: number;
+    matchedTerm: string;
+    snippet: string;
+}
+/** Matches grouped by file, after ranking and per-file dedupe. */
+export interface SearchFileHit {
+    filePath: string;
+    mtimeMs: number;
+    topicsMatch: boolean;
+    hits: SearchLineHit[];
+    /** Distinct matching terms (original spelling), longest first. */
+    matchedTerms: string[];
+}
+export interface SearchOptions {
+    /** Project vault root — searched recursively for `*.md`. */
+    rootDir: string;
+    /** Primary query phrase. */
+    query: string;
+    /** Extra keyword variants (deduped with query). */
+    terms?: readonly string[];
+    /** Max distinct files in the result (default 10). */
+    limit?: number;
+    /**
+     * Cap stored line snippets per file during scan (default 50; hard-capped at
+     * 50). Does not abort the tree walk; ranking still uses full hit counts.
+     */
+    maxHits?: number;
+    /** Context lines around each match (default 1). */
+    context?: number;
+    /** Max line hits kept per file after grouping (default 1). */
+    maxHitsPerFile?: number;
+    /** Exclude files with mtime before this date. */
+    since?: Date;
+}
+export interface SearchOutcome {
+    query: string;
+    terms: string[];
+    /** How many files each term matched (keyed by lowercased term). */
+    termHitCounts: Record<string, number>;
+    totalMatchCount: number;
+    totalFileCount: number;
+    files: SearchFileHit[];
+    truncated: boolean;
+}
+/**
+ * Case-insensitive markdown scan under `rootDir`.
+ * Frontmatter `topics:` matches boost file ranking; body and frontmatter lines
+ * both contribute line hits. Files rank by relevance (distinct terms, hit
+ * density, filename/path terms, topics; demotes search dogfood when query is
+ * unrelated), then archive, recency, folder. Pure fs — no index, no deps.
+ */
+export declare function searchVault(options: SearchOptions): Promise<SearchOutcome>;
+//# sourceMappingURL=search.d.ts.map

package/dist/vault/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/vault/search.ts"],"names":[],"mappings":"AAKA,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,kEAAkE;IAClE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAsUD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA8LhF"}