Function staleNotes

staleNotes(
vault: Vault,
args: { folder?: string; limit?: number; stale_days?: number },
): Promise<StaleNotesResponse>
List notes not edited in stale_days days — the v3.10 forgetting-aware "what's gone stale in my vault?" surface. Lets an agent proactively flag (or refresh) aged facts rather than recalling them as if current (the Memora frontier — see computeStaleness in src/staleness.ts).

Cheap: a single metadata pass over vault.listMarkdown() mtimes — NO readNote (so it's not a whole-vault content scan). Sorted oldest-first so the most-stale notes surface at the top.
Parameters
- vault: Vault
  The vault.
- args: { folder?: string; limit?: number; stale_days?: number }
  All optional. stale_days (default DEFAULT_STALE_DAYS = 365), limit (default 50), folder restricts the scan.
Returns Promise<StaleNotesResponse>
{ stale_days, scanned_notes, matches }, matches oldest-first.
Example
```
const r = await staleNotes(vault, { stale_days: 180, limit: 20 });
for (const n of r.matches) console.log(`${n.path} — ${n.age_days}d old`);
```
- Defined in tools/read.ts:392