# Changelog (/en/docs/memo/changelog)

Notable changes to `@wirecat/cli-memo`, one section per version, newest
first. Versions follow [semantic versioning](https://semver.org/); before `1.0.0` a minor release may change
the API.

## 0.21.0 — 11.10.2026 [#0210--11102026]

### Fixed [#fixed]

* The hint after a search without the meaning model names the command that downloads it,
  `tg models text download e5-small`[↗](/llms.mdx/docs/tg/commands-personal/content.md#tg-models-text-download "Command reference: tg models text download"); it named a `memo models` command that does not exist.
* `memo projects context` finds a project by its key (`HRB`) or `project:<id>` as well as its id;
  a key gave an empty answer.

### Changed — may break scripts [#changed--may-break-scripts]

* **`memo search mail` and `memo search messages` show each hit as a reference, then who and when, then an
  excerpt.** For an email the second line names To, Cc and its Gmail labels, and the third its subject; the whole
  body comes back with `--full`. `--json` gives each email `email` (from, to, cc, bcc and reply-to with their
  `person:` references, labels, thread, read and starred) and an `excerpt` instead of the whole `text`; `--brief`
  keeps only reference, title, time, sender, excerpt and score. Mail search no longer answers `coverage`.
  Built on the shared library 0.251.0.

### Fixed [#fixed-1]

* **Mail import no longer files Cc addresses under To.** Mail imported before keeps them in both; search shows
  them in Cc only.

## 0.20.0 — 11.10.2026 [#0200--11102026]

### Added [#added]

* The guides in `docs/` follow the wirecat.dev tool layout: an overview, daily use, how memo works,
  recipes, troubleshooting, memories and a generated command reference (`pnpm generate`), written
  for readers who do not use a terminal every day.
* `memo commands [path] --json` lists the command tree and its options, as tg, max and drive do, so
  documentation and agents can check a command before running it.
* Every command has a description in `--help`, including organizations, projects, relationships,
  reminders and task listing.

## 0.19.0 — 11.10.2026 [#0190--11102026]

### Added [#added-1]

* `memo mcp` tells a connecting agent when to save: what happened is a fact (`facts_add`), what it
  concluded is a memory (`memories_add`), something to do is `actions_propose`, each with evidence,
  and only what will matter later. `memo search …` and `memo notes show` end their `--help` with
  the same hint for `memo facts add` and `memo memories add`.

### Changed [#changed]

* **Mail meaning search finds the email that holds the answer.** Mail is cut into pieces email by email again,
  with re-quoted text, greetings and signatures still left out; before, a piece spanned several emails of a thread
  and a hit named the newest of them. The first index run after the upgrade cuts stored mail again once and embeds
  it again. Built on the shared library 0.249.0.

### Fixed [#fixed-2]

* Release preparation stops if another session advances main while its version PR or local
  checks are running. Review the new main before retrying; stale preparation cannot merge a
  redundant version heading or dispatch an unverified source.

## 0.18.0 — 11.10.2026 [#0180--11102026]

### Fixed [#fixed-3]

* The source changelog has one 0.17.0 heading after release preparation raced with its feature
  merge. Vocabulary commands and the shared-store pin remain the same as 0.17.0.

## 0.17.0 — 11.10.2026 [#0170--11102026]

### Added [#added-2]

* **Owner-reviewed label creation:** `memo vocabulary create` requires the current preflight
  creation fingerprint. Similar labels are checked in the shared store, including implicit
  tagging; stale approvals fail. Exact aliases continue to reuse their canonical label.
  `vocabulary audit` discovers existing lexical synonyms with explicit work/output budgets and
  incomplete-scan reporting; it never accepts or merges them.

* **Mail search filters by read and starred state, and takes `label:`.** `memo search mail` accepts `is:unread`,
  `is:read`, `is:starred` and `label:` (the same as `mailbox:`), and `date:>=2026-01-01` as well as
  `date>=2026-01-01`. Built on the shared library 0.246.0.

## 0.16.0 — 11.10.2026 [#0160--11102026]

### Added [#added-3]

* **Project meetings and task dependencies.** `projects meetings list|link` requires the exact
  meeting provider/account and accepts a canonical project key or explicit alias. `tasks link|unlink`
  manages reviewed blocked-by/follow-up-of/related-to edges; `relations`, `readiness` and `ready` expose
  the shared task graph. Ready discovery claims nothing. MCP `task_relations`, `task_readiness` and
  `tasks_ready` are read-only. Built on the actual published shared library 0.242.0; new project keys
  use 3–4 characters and existing keys remain valid.

* **Canonical vocabulary discovery and reviewed aliases.** `vocabulary list|resolve|preflight` shows
  stable project/tag/topic IDs, explicit aliases and likely lexical label duplicates. Owner
  `vocabulary aliases add|remove` requires the current preview fingerprint. Read-only MCP tools
  `vocabulary_list`, `vocabulary_resolve` and `vocabulary_preflight` let an agent reuse the catalog;
  they cannot accept or change aliases. `facts_add` can attach its proposed fact to a canonical project.

## 0.15.0 — 11.10.2026 [#0150--11102026]

### Changed — may break scripts [#changed--may-break-scripts-1]

* **`memo mail <account> import` replaces `memo mail import --account <name>`; the old form is gone.** `<account>`
  is the name in `mail.accounts` and is required even when one account is configured: memo no longer falls back
  to the first. A missing or unknown name is an error that lists the configured ones. A mail import now takes the
  lock `memo import` and the timer take, so the two never run at once. `memo import` still imports every account.
* **`bin/mail-password <account>` requires the account**; without it the script prints its usage and the
  configured names instead of assuming `gmail`.

### Added [#added-4]

* **`memo search mail --account <address>`** searches one mail account; without it, every mail account. An
  address the store does not hold is `not_found` and lists the ones it does.

## 0.14.1 — 11.10.2026 [#0141--11102026]

### Fixed [#fixed-4]

* **npm installs the packages side by side again.** Built on `@wirecat/cli-messaging` 0.241.0, whose
  `@wirecat/cli-meetings` 0.4.2 accepts cli-core 0.20.0. With 0.240.0, npm put cli-messaging in a nested folder
  with a second copy of cli-core.

## 0.14.0 — 11.10.2026 [#0140--11102026]

### Changed — may break scripts [#changed--may-break-scripts-2]

* **On macOS memo keeps its files where it does on Linux**: `~/.config/cli-memo`, `~/.local/share/cli-memo` and
  `~/.cache/cli-memo` instead of `~/Library/…`. The first run moves the old folders there, with the shared store.
  While a messenger `serve` or an MCP server is running it prints one warning, keeps using the old folders for that
  run and tries again next time. Linux and Windows are unchanged. Built on `@wirecat/cli-messaging` 0.240.0.

## 0.13.0 — 11.10.2026 [#0130--11102026]

### Added [#added-5]

* **`mail.maxBodyChars` and `mail.maxAttachmentChars`** in the config set how much of an email body (default
  1,000,000 characters) and of one attachment's text (default 200,000) `memo mail import` keeps.
* **`memo facts add|list|show|accept|reverse`: what happened, with its evidence.** A fact is a fact, statement,
  question, decision or promise. Yours is accepted at once; an agent's waits as proposed. A decision with
  `--supersedes` ends the one it replaces once accepted; `reverse` ends an accepted decision. `memo mcp` offers
  `facts_add`, `facts_list` and `facts_show`.
* **Tasks of your own in a project.** `memo tasks add --project <key> --title <title> --type bug|feature|chore`
  makes one with no source. `--priority`, `--parent`, `--description` and `--assignee` work on any task;
  `memo tasks update <id>` changes them, `memo tasks list --project <key>` lists a project's tasks and
  `memo tasks close` closes one.

### Changed — may break scripts [#changed--may-break-scripts-3]

* **memo runs on `@wirecat/cli-messaging` 0.238.0**, store version 2: upgrading a store moves its kind-fact
  memories into facts and copies task assignments; older memo builds still open it.
* **Mail is searched by meaning thread by thread**, without re-quoted text: the first `memo mail import` after the
  upgrade cuts every thread again and embeds the mail once more. Search by words is unchanged.
* **A memory's kind `fact` is gone**: what happened is a fact now (`memo facts`). The store moved existing
  kind-fact memories into facts, evidence and links included.
* **`memo tasks assign` takes `--role` (assignee, reviewer or watcher) and no `--provider`/`--account`.** It
  writes the task's assignees, which `memo context` reads, instead of an `assigned-to` relation.

## 0.12.0 — 11.10.2026 [#0120--11102026]

### Added [#added-6]

* **`memo notes add --meeting <id> --provider <provider> --account <account>` writes a note about a meeting.**
  It takes the meeting's store id, as `memo tags add --meeting` does, and adds the same
  `meeting:<account id>/<meeting id>` subject beside any `--about`. A meeting the account does not hold is
  `not_found`.

### Changed — may break scripts [#changed--may-break-scripts-4]

* **memo runs on `@wirecat/cli-messaging` 0.235.0.**
* **Read and starred stay current.** `memo mail import` updates read and starred on mail it stored earlier, as
  the mailbox shows them now, without reading the mail again.
* **Generic IMAP accounts get flags.** Their messages record read and flagged, and a flagged one carries the
  `Starred` label, as a starred Gmail message does, so `search mail mailbox:starred` finds both.
* **Long emails are kept whole.** A body was cut at 20,000 characters; it is now kept up to 1,000,000, and the
  store cuts it into pieces for search.

## 0.11.0 — 11.10.2026 [#0110--11102026]

### Changed — may break scripts [#changed--may-break-scripts-5]

* **memo runs on `@wirecat/cli-messaging` 0.233.0.** An imported email's attachments are now found by meaning
  too: their text is cut into pieces and embedded after import, and tg/max `search conversations` answer a match
  in an attachment with its email.

## 0.10.0 — 11.10.2026 [#0100--11102026]

### Added [#added-7]

* **Gmail labels and stars reach the store.** `memo mail import` reads each message's labels (`X-GM-LABELS`) and
  flags: every label, Inbox, Important and Sent included, becomes a label mailbox with a plain name, a starred
  message also gets `Starred`, and new mail records read and starred. `search mail mailbox:important` finds them.
  Labels are replaced on every run, as Gmail's list is whole; folders keep the per-scan rule, and only folders
  decide whether missing mail was deleted. A label line the import cannot read leaves that message's labels as
  they were.

## 0.9.0 — 11.10.2026 [#090--11102026]

### Added [#added-8]

* **A meeting can be tagged and written about.** `memo tags add|remove --meeting <id>` with `--provider` and
  `--account` labels a stored meeting, `memo tags list --type meeting` lists them, and `memo notes add --about
  meeting:<account id>/<meeting id>` writes a note about one.
* **`memo memories`** — `add`, `list`, `show`, `search`, `confirm` and `stale` for what you and agents
  concluded, each with its evidence and a `personal` or `work` scope. Yours are confirmed at once; an agent's
  wait as proposed.
* **`memo actions`** — `propose`, `list`, `show`, `approve` and `reject`. Approving makes the action a task
  in the account that would act; nothing is sent.
* **`memo agents log`** — what agents did through the MCP servers, by tool and agent, never the arguments.
* **`memo mcp`** — an MCP server on stdio with `memories_add|list|show|search`, `actions_propose|list|show` and
  `agents_log`. What an agent writes is authored by `memo-mcp` and waits for you; every call is logged.

### Changed — may break scripts [#changed--may-break-scripts-6]

* **memo runs on `@wirecat/cli-messaging` 0.232.0.** `search mail` takes `to:`, `cc:`, `bcc:` (a person, as
  `from:`), `subject:` (words of the subject alone) and `mailbox:` (a folder or Gmail label).
* **`search` and `search all` help say what `search all` does not read** — people, memories, projects,
  organizations and decisions — and send a kind you know to its own search.

## 0.8.0 — 11.10.2026 [#080--11102026]

### Changed — may break scripts [#changed--may-break-scripts-7]

* **Mail goes into the store's mail tables.** `memo mail import` saves each email through cli-messaging's
  `store.mail` (0.231.0): threads, emails, To/CC/BCC, folders as mailboxes, and attachment text on its email.
  Ids stay the same, so a `msg:email/…` reference, tag or note made before still resolves. Mail saved as
  messages by earlier imports stays searchable and keeps its old deletion rule; it is read again into the
  mail tables as the window covers it. While both exist, `deleted` counts stored rows: a mail deleted at the
  source counts its email, its older message and any older attachment entry. An attachment is no longer its own
  entry: the import report drops `attachments[].locatorId`, and a note on an attachment entry stays on that older
  entry.
* **Tags, tasks and person context read the mail tables.** `tags list` keeps a tag on an email, `tasks add` takes an
  email's `msg:email/…` source, and a person's tasks and context include their mail.
* **Mail is embedded from the mail tables.** After saving, `memo mail import` embeds new mail's chunks (cli-messaging's
  `embedMail`), so tg and max `search conversations` keep finding mail by meaning. `--no-embed` and a missing model
  behave as before.

## 0.7.1 — 11.10.2026 [#071--11102026]

### Fixed [#fixed-5]

* Mail search, evidence bundles and person context also read email stored in dedicated mail tables.
  Older mail imports remain supported; search results list each email locator once.

## 0.7.0 — 11.10.2026 [#070--11102026]

### Changed [#changed-1]

* **memo runs on `@wirecat/cli-messaging` 0.226.0.** The store prunes its growing logs on open, at most once a
  day: agent tool calls older than 90 days are deleted, and a handled bot update older than 30 days loses its
  payload. Upgrade tg-cli and max-cli first, as all three share the store.
* **`organizations add --kind`, `projects add --type` and `--scope` take their allowed values from the store**
  and refuse any other value before the store is opened, naming the allowed ones.

### Fixed [#fixed-6]

* **`memo --version` prints the package's version.** It printed 0.4.0 since 0.5.0: the number lived in a file the
  release did not update. A test now fails when that file and `package.json` disagree.
* Package references, documentation and fixtures use the WireCat namespace throughout.

### Security [#security]

* **The old `messages.db` is deleted** when the store opens at its default path: the unencrypted file used
  before `wirecat.db`, with its `-wal` and `-shm`. One line on stderr names it. It is kept when
  `MESSAGING_STORE` is set, and while another process still has it open.

## 0.6.0 — 10.10.2026 [#060--10102026]

### Changed — may break callers [#changed--may-break-callers]

* **memo runs on `@wirecat/cli-messaging` 0.218.0 and `@wirecat/cli-core` 0.19.3**, the store in `wirecat.db`.
  The old `messages.db` is left as it is and not read: import notes and mail again, and run
  `memo folders add <path>` for each folder, since a folder id from the old store is not in the new one.
* **`memo entities` is replaced by `memo organizations` and `memo projects`** (`add`, `list`, `context`),
  as the store now keeps them apart; `tags --entity` is `--organization` or `--project`, and `entity:`
  references are not found. An organization is a company, team, family or community; a project has a key.
* **A file in a notes folder is `document:<id>`, a note written in memo `note:<id>`.** `notes show`,
  `tags --note`, `tasks add` and `--about` take either; a bare id is a written note's. Search evidence and
  links name a file's note by `document:`.

### Security [#security-1]

* Fast secret checks remain on PRs; source, production dependency and workflow security checks run before publication. Automatic Socket checks are disabled.

## 0.5.1 — 10.10.2026 [#051--10102026]

### Changed [#changed-2]

* **The project is now licensed under Apache License 2.0.** See `LICENSE` for the terms.

## 0.5.0 — 10.10.2026 [#050--10102026]

### Changed — may break callers [#changed--may-break-callers-1]

* **The package is `@wirecat/cli-memo` and its repository belongs to WireCatLabs.** Use this package for installations and updates.

## 0.4.0 — 09.10.2026 [#040--09102026]

### Changed — may break scripts [#changed--may-break-scripts-8]

* The shared store drops the copies kept for older versions (store version 28, cli-messaging 0.212.0).
  Notes, relations and entities written before the notes refactor are copied into their new tables once,
  during the upgrade. After it, an older tg, max or memo refuses the store with "upgrade this tool" —
  update all three together.

## 0.3.0 — 09.10.2026 [#030--09102026]

### Changed — may break scripts [#changed--may-break-scripts-9]

* Search commands now live under `search all|messages|mail|notes`, using the shared services and ranking.
  `search all` returns typed source hits and a separate `tasks` list for linked open work. The old
  `memo search <query>` and `memo notes search` paths are removed without aliases. Use `search notes --type`
  instead of `notes search --source`; `--all` and `--note-text` are no longer needed.

* Pin shared SDK 0.211.0 alongside Telegram/MAX. Legacy copied note task sources move to native note IDs
  without changing task IDs, account scope or closed states. Upgrade the coordinated tools together
  before opening the shared owner store.

### Fixed [#fixed-7]

* `search all` finds messages on a store that has not yet recorded the account it runs as, and asks the
  messenger's server the way `search messages` does. `search mail` with no mail imported answers an empty
  result with a note. Notes found by meaning must be as similar as conversations already have to be, so a
  rare word no longer returns every note.

### Added [#added-9]

* `tasks add note:<id> --provider <provider> --account <account>` creates tasks from native file or internal
  notes. Lists resolve the current note preview; deleted notes leave tasks intact. Confirmed note-about-person
  links and explicit assignments contribute to person context. Unified search includes tasks whose note matches.
  Repeated creation reuses the existing task of the same kind, including closed tasks.

## 0.2.1 — 08.10.2026 [#021--08102026]

* Pin cli-messaging 0.205.0 to match the coordinated Telegram/MAX release. Native notes, links and
  source references retain the same schema and behavior.

## 0.2.0 — 08.10.2026 [#020--08102026]

Notes are their own records in the shared store (cli-messaging 0.202.0, store versions 25–27), no longer
messages of a `notes` provider.

* `memo folders add|attach|list`: a folder of notes gets its id from the store, and each computer's
  config binds it to that computer's path and format (`obsidian` or `markdown`). `list` shows folders the
  store has from another computer. A folder imported before store version 25 moves its path into the
  config on the first run. Import refuses a folder with no id instead of inventing one.

* Import writes notes, their links and their file tags. A link to a note the folder has once is stored
  by the note's id; a name no note has stays as written and resolves to a person as soon as one by that
  name, alias or username exists. A moved file keeps its id, links and tags. A tag you added stays when
  the file stops stating it. What a computer last saw of
  each file is kept in memo's state folder, and only a changed file is opened — also to look for
  `memo-id`, which marks a file memo exported and keeps it out of the import.

* `memo notes add|edit|remove|list|show|export` for notes written here about messages, chats, contacts,
  people, entities, tasks and other notes; `--export [dir]` and `notes.export` write them as files that
  carry `memo-id` and are never overwritten once edited.

* `memo notes about`, `memo context` and `memo note` read saved links: notes about a person, notes
  linking them, notes linking a note about them. A full name found in a note's plain text is no longer
  listed as a guess. The old `people-notes.json` moves into the store as `about` links, once.

* `memo notes search` runs on the shared notes index: words and stems, the messages' query language,
  `--exact`, `--source`, `--folder` by path or id, and by meaning when e5-small is downloaded — `memo
  import` and `memo notes import` embed the notes (`--no-embed`, `notes.embed: false`). Each hit says what
  found it (`foundBy`), and a person a found note links is named. `memo search --all` covers notes;
  `--note-text` also retrieves authored note text.

* Entities and relationships are the owner's: `entities` and `relationships add|list|remove|confirm`
  no longer take `--provider`/`--account`. `memo tags add --note <id>` labels a note; `--person`,
  `--entity` and `--task` need no account. `--folder <id> [--path <subfolder>]` labels every note under a
  folder or subfolder, replacing `--chat` with `--provider notes`. `tags list` says whether a note's tag
  came from its file.

* Notes are read through a format: `obsidian` adds inline `#tags` and reads `[label](path.md)` links
  besides `[[wiki links]]`; `markdown` reads plain Markdown links. Links to `person:`, `msg:`, `note:`,
  `entity:`, `task:`, `chat:` and `contact:` references are recognised in both.

* Open tasks and explicit document-task assignments in person context; tasks add/list/close reuse the
  shared task service. Multiple matching accounts require explicit selection.

* CSV/TSV, PDF, DOCX, XLSX, ODT/ODS, PPTX and EPUB ingestion through shared extraction, with optional-engine and unsupported
  format reporting, file/text bounds, content hashes and page/row/cell provenance.

* Configurable Gmail/IMAP folder coverage, stable Message-ID identities, attachment text sources and
  bounded resumable email indexing. Partial listings never prove deletion; changed folder scopes skip deletion.

* Canonical-person/task/entity labels, manual organization/family/project relationships, selected-source
  unified retrieval, and cited evidence bundles/model proposals with explicit remote consent.

* Durable local task reminders with lease receipts, acknowledgement, stale-edit checks, snooze/cancel
  and automatic cancellation when a task closes. No outbound delivery or source-system mutation.

* `memo tags add|remove|list`: local labels on imported notes, emails, messages and folders/threads,
  addressed by note/folder IDs, message locators or an exact provider/account/chat. Labels are case-insensitive,
  shared with tg/MAX and preserve source files and mailboxes; deleted sources are hidden from listing.

* `memo notes search --tag <tag>` filters word and semantic results using shared tag eligibility,
  including labels on the note's folder.

## 0.1.2 — 07.10.2026 [#012--07102026]

* cli-messaging 0.166.0, matching the final tg and max release pins, including protected conversation
  preparation during search and history fetch.

## 0.1.1 — 07.10.2026 [#011--07102026]

* cli-messaging 0.164.0, matching tg and max source: person context now finds private dialogs with no
  recorded members, restoring the last message each way and direct messages in existing Telegram stores.

* The release workflow can dry-run a version already on npm, so packaging can be checked between
  releases. Publishing still refuses an existing version.

## 0.1.0 — 06.10.2026 [#010--06102026]

* The `memo` command, with `--version` and `--help`.
* `memo notes about <name>` (was `memo notes <name>`): notes about a person, notes that link them, and weak plain-name mentions, from
  Markdown folders given with `--folder` or `notes.folders` in the config.
* `memo mail import`: a Gmail account's All Mail into the shared message store through Himalaya, read only;
  Gmail thread and message ids, resumable with `--max`, and deletions at the source drop the stored text.
* `memo note`: the note about a person, kept per person of the shared store. Linking identities is
  `tg|max contacts link`, not a memo command.
* `memo notes import`: Markdown and text notes into the shared store as provider `notes`; edits kept as
  revisions, deleted notes lose their text. `memo notes search <text>`: notes by their words, with the
  people they link and the known people whose full name they mention (a guess).
* `notes.ignore` in the config and `--ignore`: files, folders or globs never read or stored.
* `memo import`: notes and mail in one run, incremental — notes keep a manifest of size, change time and
  content hash in the store, so unchanged files are not read and identical ones not saved. A lock stops two
  runs at once; a failing source does not stop the others.
* `memo auto on [--every 5m] | off | status`: a systemd user timer for `memo import`. The config's
  `auto: { enabled, every }` is the source; the timer follows a hand edit at its next run.
* `memo context <messenger>:<person>`: one answer about a person — cli-messaging's person context across
  every linked identity (mail included), the note about them and the notes naming them, with what was not
  read and why. Needs cli-messaging 0.150.0, which tg and max pin.
* Notes are embedded for search by meaning: `memo import` and `memo notes import` build each changed folder
  and embed new chunks with the local e5-small model, at most 600 a run, resuming next run; `--no-embed` and
  `notes.embed: false` skip it. `memo notes search` ranks by meaning and words together (`by` on each hit) and
  falls back to words when the model is missing.
* cli-messaging 0.153.0, as tg and max pin: a long note or mail is embedded in overlapping pieces, whole.