People

Your mail and calendar are mostly about people. Maisnie keeps one note per person in your vault, in Entities/People/, and links every mail thread and meeting to the people in it — but it never decides on its own who someone is. It proposes; you decide.

The connectors themselves still only link to a person you already have a note for (see connect your accounts). What this page covers is how those notes come to exist, gain addresses, and become one note when two of them turn out to be the same person.

Where you meet it

People, in the masthead, lists everyone Maisnie has met so far — search it by name or address. Open anyone to see their page: their addresses, when you were last in touch, and every mail thread and meeting they are in, newest first. On a mail thread or meeting page, a participant’s name links straight to their person page when Maisnie already knows who they are.

Whenever there is something to decide, Home shows a People to review card with how many are waiting, and a Review button that takes you there. It shows you one question at a time, in plain words, with the evidence underneath it — never a list to plough through.

What Maisnie proposes

Maisnie reads your mail threads and meetings and notices three kinds of thing. Each is shown to you as a question, with its evidence in plain words — which notes, how many of them, and when you last heard from that address — and the notes themselves, newest first.

• Someone new. An address that has turned up in at least two of your notes, used with a real name, that no person note has yet. “Add Dana Whitfield ([email protected]) to People?” You can change the name before the note is created.
• Another address for someone you have. A new address used under exactly the name of one of your people, where something besides the name agrees: it’s at the same domain as an address they already have, or it writes with the same people they do. This is always asked as a question and marked as less certain, because anyone can type any name into a mail program: “Is [email protected] also Dana Whitfield?”
• Two notes for one person. Two person notes that list the same address, or that carry the same full name, share an email domain, write with the same people, and never appear together in one conversation. “Are Tom Ferreira and Tomas Ferreira the same person?”

What it never proposes:

• A merge on a first name alone, or on any one-word name. Two Danas are two people.
• A person for an automated or shared mailbox: noreply@, notifications@, calendar-notification@, mailer-daemon@, support@, info@, a newsletter, and the like.
• A person whose “name” is really an email address, or who has no name at all.
• Anything you’ve already answered.

Names are compared the way a person would compare them: extra spaces, stray quotes around a name, and a relaying service’s “(via …)” suffix don’t make two names different, and neither does letter case in an address.

Deciding

Each proposal has the choices that fit it:

• Approve — create the person, add the address, or merge the two notes. For a merge, you choose which note to keep.
• Reject — no, and don’t ask again.
• Not the same person — for an address or a merge: these are different people, and Maisnie will never suggest putting them together again, however much more evidence turns up.

Every answer is final in the sense that matters: Maisnie never asks the same question twice. If you create a person and later delete their note, Maisnie won’t propose them again either.

What changes in your vault

Only person notes, and only the ones a decision is about. Your mail threads and meeting notes are never moved, rewritten or deleted — they’re the evidence, and they stay exactly as they arrived.

• Creating writes one new note in Entities/People/, named for the person. If a note with that name is already there, nothing is written and Maisnie says so; pick a different name.
• Adding an address changes two lines of that one note — its list of emails and the date it was last changed — and leaves everything else in it exactly as you wrote it.
• Merging keeps the note you chose and gives it the other note’s addresses, other names and sources. The other note stays where it is, with its own text, marked as merged and pointing at the one you kept, so any link to the old name still takes you to the right person.

Where your decisions are kept

In your vault, in a hidden folder: .maisnie/people/decisions.ndjson, one line per decision, only ever added to. Because it lives in the vault, copying or backing up the vault folder carries your decisions with it (see backup). Maisnie’s search and note pages never show this folder.

For a merge, that line also records both notes exactly as they were before, so a merge you regret can be put back by hand: copy each note’s earlier text back into its file.