note

note: Time-Bound Reminders & Tasks in the Vault

Notes are the lightweight, ephemeral cousin of full wiki pages. Use them for "ping Carol about the demo tomorrow", "review red-team PR by Friday", "buy a new charger". They live for 7 days, then auto-expire.

User identity: [email protected]. Vault root: ~/digital-brain/.

---

Vault Layout

• Notes folder: wiki/notes/ (create if missing)
• Notes index: wiki/notes/_index.md (create if missing — table of active notes only)
• Wiki index: wiki/index.md — has a ## Meta section; add [[notes/_index|Active Notes]] there once
• Log: wiki/log.md — append a note entry at the TOP after every add/done
• Hot cache: wiki/hot.md — touch ONLY if the note's due is within 24h

---

Invocation Forms

Form	Action
/note <free-text>	add (default kind = reminder)
/note task <free-text>	add with note_kind: task
/note reminder <free-text>	add with note_kind: reminder (explicit)
/note list	show active (non-expired, open) notes
/note done <id-or-slug>	mark a note as done
/note clear	manually sweep expired notes (auto on every invocation)

If $ARGUMENTS is empty, show the forms and ask which one.

---

Parsing /note [kind] <tail>

1. Kind. If the first tail token (case-insensitive) is task or reminder, consume it and set note_kind. Otherwise default note_kind: reminder.
2. Due time (by <when> / tomorrow / today HH:MM / <weekday> / in <N>h|d).
   • by 18:00 or by 6pm → today at that time (or tomorrow if already past)
   • tomorrow [HH:MM] → tomorrow at the given time or 09:00
   • next <weekday> → next occurrence of that weekday at 09:00
   • in 3h / in 2d → relative from now
   • If nothing specified: default due = today 18:00 (or tomorrow 09:00 if it's already past 18:00).
3. Assignee (@<Person>). Default assignee: me. If @Name appears, resolve via wiki/entities/people/_index.md:
   • If a person with that first-name alias or full-name match exists → assignee: "<Full Name>" and wikilink [[Full Name]] in the body.
   • If not, apply the flywheel rule (see "Cross-Reference Rule" below): file the person first via the ppl skill with best-guess role, then link.
4. Title. The remaining text after stripping kind / by … / @Name is the title. Trim to ≤ 80 chars; full text stays in the body.

---

add Workflow

1. Auto-sweep expired first (see "Expiration" below). Cheap — one glob over wiki/notes/*.md.
2. Resolve fields per parsing above. Compute:
   • created = now (ISO YYYY-MM-DD HH:MM, local time)
   • expires = created date + 7 days (date only, YYYY-MM-DD)
   • slug = lowercase title, non-alphanum → -, trimmed to 40 chars
   • note_id = <YYYY-MM-DD>-<HHMM>-<slug>
3. Ensure folder + index exist. Create wiki/notes/ and wiki/notes/_index.md from the template below if missing.
4. Write wiki/notes/<note_id>.md from the Note Page Template.
5. Update _index.md: add a row to the matching section (Active Tasks / Active Reminders). Notes with status: expired or done are NEVER in _index.md — the index is the working set.
6. Update wiki/index.md once: under ## Meta, ensure a bullet - [[notes/_index|Active Notes]] - active tasks and reminders (7-day TTL) exists. If already present, skip.
7. Hot cache: if due is within the next 24h (compute against now), append a one-liner under ## Active Threads in wiki/hot.md. Format: - ⏰ <due time> — <title> — [[notes/<note_id>]].
8. Log: append at the TOP of wiki/log.md (under the header):

   ## [YYYY-MM-DD HH:MM] note add | <note_id>
   - Kind: <task|reminder>
   - Due: <YYYY-MM-DD HH:MM>
   - Expires: <YYYY-MM-DD>
   - Assignee: <name>
   - Location: wiki/notes/<note_id>.md
   

9. Confirm: print Filed <kind> [[notes/<note_id>]] — due <due>, expires <expires>.

---

list Workflow

1. Auto-sweep expired.
2. Read wiki/notes/_index.md. Render the two tables (Active Tasks, Active Reminders).
3. Sort each table by due ascending. Mark rows with due ≤ now + 4h as 🔥.
4. Print total count + earliest due.

---

done <id-or-slug> Workflow

1. Match against filenames in wiki/notes/ and slug portions. If ambiguous, list candidates and ask.
2. Update the note file: status: done, append a ## Closed section with timestamp.
3. Remove the row from _index.md.
4. Log: ## [YYYY-MM-DD HH:MM] note done | <note_id>.

---

clear Workflow

1. Run the auto-sweep (the same one every invocation runs). It's safe to run explicitly.
2. Print how many notes were flipped to expired and which.

---

Expiration (the 7-day rule)

Every invocation of /note, /sync, and /sup runs this sweep BEFORE doing anything else:

for each wiki/notes/*.md where status == "open":
    if today > expires:
        set status: expired
        bump updated to today
        remove the row from _index.md
        (do NOT delete the file — keep for history)

Expired notes are invisible to /sync and /sup. They stay on disk for retrospection but never resurface in dashboards. If the user wants something back after 7 days, they re-create it — that's the design.

The sweep is idempotent and cheap; never skip it.

---

Templates

Note Page Template

---
type: note
note_kind: <task|reminder>
title: "<title>"
created: <YYYY-MM-DD HH:MM>
due: <YYYY-MM-DD HH:MM>
expires: <YYYY-MM-DD>
status: open
assignee: "<Full Name or me>"
linear: ""
tags:
  - note
  - <note_kind>
related:
  - "[[notes/_index|Active Notes]]"
---

# <title>

<full free-text body from the /note input, with any [[Person]] wikilinks resolved>

## Source

- /note invocation at <YYYY-MM-DD HH:MM>

_index.md Template

---
type: meta
title: "Active Notes"
updated: <YYYY-MM-DD>
tags: [meta, index, notes]
status: evergreen
related:
  - "[[index]]"
  - "[[hot]]"
---

# Active Notes

7-day TTL. Expired notes drop off this index automatically; they remain on disk under `wiki/notes/` for history.

Add via `/note <text>` or `/note task <text>`. Mark done via `/note done <id>`.

---

## Active Tasks

| ID  | Title | Assignee | Due | Linear |
| --- | ----- | -------- | --- | ------ |

## Active Reminders

| ID  | Title | Due |
| --- | ----- | --- |

---

Cross-Reference Rule

If the input mentions a person (either as @Name or in free text matching an existing alias in wiki/entities/people/_index.md), wikilink them in the note body. If the name doesn't resolve, apply the flywheel: file them via ppl with best-guess role and a > [!todo] Confirm role callout, THEN link. Never emit a phantom [[Name]] to a non-existent page.

---

Examples

/note review red-team PR by friday @Alice

• kind: reminder (default)
• due: next Friday 09:00
• assignee: Alice Smith (resolved from alias Alice)
• title: review red-team PR
• file: wiki/notes/2026-05-13-1430-review-red-team-pr.md
• hot.md: not touched (Friday > 24h away from a Wednesday)

/note task ship BigCustomer retro by tomorrow 12:00

• kind: task
• due: 2026-05-14 12:00
• assignee: me
• file: wiki/notes/2026-05-13-1430-ship-bigcustomer-retro.md
• hot.md: touched (due within 24h)

/note list

• Renders the two tables from _index.md, sorted by due, 🔥 on anything due in next 4h.

/note done 2026-05-13-1430-review-red-team-pr

• Sets status: done. Drops row from _index.md. Logs.

---

Don'ts

• Don't ever delete a note file — only flip status. History matters.
• Don't write a note without a due — always default to today 18:00 / tomorrow 09:00.
• Don't write to wiki/hot.md unless due is within 24h.
• Don't link to a person who isn't filed — file them first or skip the link.
• Don't put expired or done notes in _index.md — the index is the working set only.