From dce9960c87673a1afc236150d18ef49e38b8a792 Mon Sep 17 00:00:00 2001 From: Viacheslav Ptsarev Date: Tue, 20 Oct 2026 20:56:09 +0200 Subject: [PATCH] docs: adopt Memo selected annotation workflow --- .../reviews/2026-10-20-memo083-annotations.md | 63 +++++++++++++++ docs/tasks.json | 2 +- tools.json | 11 +-- translations/memo/changelog.es.md | 25 +++++- translations/memo/changelog.ru.md | 25 +++++- translations/memo/commands.es.md | 81 ++++++++++++++++++- translations/memo/commands.ru.md | 81 ++++++++++++++++++- translations/memo/mcp.es.md | 16 +++- translations/memo/mcp.ru.md | 28 +++++-- translations/memo/recipes.es.md | 58 +++++++++++++ translations/memo/recipes.ru.md | 58 +++++++++++++ translations/memo/security.es.md | 12 ++- translations/memo/security.ru.md | 12 ++- translations/sources.json | 20 ++--- 14 files changed, 454 insertions(+), 38 deletions(-) create mode 100644 docs/reviews/2026-10-20-memo083-annotations.md diff --git a/docs/reviews/2026-10-20-memo083-annotations.md b/docs/reviews/2026-10-20-memo083-annotations.md new file mode 100644 index 00000000..b13110b0 --- /dev/null +++ b/docs/reviews/2026-10-20-memo083-annotations.md @@ -0,0 +1,63 @@ +# Memo selected annotation workflow review + +Status: published Memo0.83 is independently verified and adopted locally; portal deployment and +production verification remain pending. + +## Reader outcome and source + +The reader can retain selected aliases, facts and generic links, inspect explicit destination +bindings and understand the owner-only restore boundary. The format does not include notes, +specialized meeting memberships, tasks, memories, labels or findings and cannot justify a live reset. + +- Native implementation and guides: [Memo #356](https://github.com/WireCatLabs/cli-memo/pull/356), + feature source31650f12238a149a83896cdc94653da09c2c2429; released source + 5a2a5b2b594bbf9454ac27e1eb43721d036f8c9e, release run39454675571. +- Shared runtime: published Core0.374 and Base0.47.4; immutable registry and validated artifacts match. +- [Independent installed SDK reproduction](https://github.com/WireCatLabs/cli-testing/tree/91787332f0943f6eba9657e312abf4088ae0d2df/performance/projects/restore) + verifies different destination IDs, source/preview byte preservation, historical proposed state, + stale preview refusal and repeat refusal. This is not an extraction-quality score. +- Memo's605 tests pass under coverage. Independent installed Memo0.83 CLI and actual stdio MCP + acceptance pass with the published dependency graph. The npm/validated Memo tarballs match SHA-256 + 8df6a8f5c2d290c32e88a21b65f92f30f4bfa29446f3f033164078912d728852. + +## Prose and reference review + +The complete current recipe, MCP and security guides were read in English, Russian and Spanish. +Changed command reference sections and the person-reference option were checked against the native +generated command tree. The existing technical reference and historical changelog remain in English +where the localized pages already explain that choice; task instructions are localized. + +| Page | Locales | Review result | +| --- | --- | --- | +| recipes | EN/RU/ES | Explains the outcome, prepared target, explicit references, omitted facets, private new file, exact check fingerprint, rollback and repeat refusal; links back to project review | +| MCP | EN/RU/ES | Exactly two reading tools, no restore tool; bounded reads and audit entry remain distinct; local example requests translated | +| security | EN/RU/ES | Note exports and annotation exports described separately; restore preserves historical state and does not newly confirm proposals | +| commands | EN/RU/ES | Three leaves, budget value names, required target/bindings/fingerprint, file effects and JSON projections match the command tree | +| changelog | EN/RU/ES | Technical source notes retained; no historical section rewritten | + +Editorial corrections include an obsolete claim that only note export writes files, untranslated +MCP example requests, inconsistent Russian words for findings and unclear wording for omitted +meeting-project memberships. Executable fences, reference values and incoming anchors are preserved. +The projects task mapping now includes the existing recipe page. + +The native release also includes earlier permission-guide corrections. Retire the five fixed guide +overrides only when their content is included in the adopted release; verify index, how-it-works, +memories and usage against the already deployed corrections rather than silently dropping them. + +## Validation and remaining delivery + +- Published0.83 source and validated/registry bytes match; independent CLI and actual stdio MCP checks pass. +- Five native guide overrides are retired. The four unchanged guide/README bodies match their earlier + fixed source exactly; security includes the native export correction and retains the permission guidance. +- All five released command contracts were freshly captured with network blocked. Strict documentation + validation reports1415 reference entries, zero gaps and zero invalid examples;144 syntax illustrations + remain marked for manual review. The projects task mapping includes the recipe. +- Lint passes with the same three existing warnings, typechecking passes and325 unit cases pass. +- Source-preview mobile checks pass15 HTML pages and15 Markdown twins across EN/RU/ES at390px, + including the new leaves/tools, selected-annotation anchor, old security anchor and configuration links. + The preview source is the exact released commit. The existing Sidebar React key warning remains; + no page errors or horizontal overflow were observed. The owned development server was stopped. +- PR checks, deployment and verification of the changed public routes remain pending. + +No UI behavior or route is changed by this task. Reader verification supplements the existing shared +browser coverage rather than adding repeated permanent layout cases. diff --git a/docs/tasks.json b/docs/tasks.json index ed4404d5..08ad8e56 100644 --- a/docs/tasks.json +++ b/docs/tasks.json @@ -128,7 +128,7 @@ }, { "id": "memo-people", - "pages": ["memo/people.md", "memo/mail.md"], + "pages": ["memo/people.md", "memo/mail.md", "memo/recipes.md"], "families": { "memo": ["context", "organizations", "projects", "relationships", "vocabulary", "mail"] } diff --git a/tools.json b/tools.json index 60e3b775..b4b87e89 100644 --- a/tools.json +++ b/tools.json @@ -61,14 +61,7 @@ "ru": "Заметки, почта и сообщения в одном месте для вашего ИИ-агента: поиск, теги, люди и память, на вашем компьютере.", "es": "Tus notas, correo y mensajes en un solo lugar para tu agente de IA: búsqueda, etiquetas, personas y recuerdos, en tu ordenador." }, - "docsRef": "v0.82.0", - "profile": false, - "guideRefs": { - "index": "a46159857442f2008324001468b440f009ea9b8c", - "security": "a46159857442f2008324001468b440f009ea9b8c", - "how-it-works": "a46159857442f2008324001468b440f009ea9b8c", - "memories": "a46159857442f2008324001468b440f009ea9b8c", - "usage": "a46159857442f2008324001468b440f009ea9b8c" - } + "docsRef": "v0.83.0", + "profile": false } ] diff --git a/translations/memo/changelog.es.md b/translations/memo/changelog.es.md index 853e9161..f27c6545 100644 --- a/translations/memo/changelog.es.md +++ b/translations/memo/changelog.es.md @@ -8,7 +8,30 @@ la API. Las notas técnicas exactas de las nuevas versiones se conservan en inglés; las instrucciones de uso están traducidas en sus guías. -## Unreleased +## 0.83.0 — 20.10.2026 + +### Added + +- `memo projects evidence --contact person:` (MCP `project_evidence` `contact`) searches the person's stored name and + keeps the `person:` reference on the lane; an unknown id is refused with `not_found` instead of searched as text, + and a person with no stored name is refused with `validation_error` rather than searched under an identity's name. +- **`projects annotations export|check|restore`** retains selected project aliases, facts and generic + links, with explicit external bindings and historical state. Export writes a new private file from + read-only source access; preview checks an existing explicit target; owner-only restore requires its + exact fingerprint and refuses populated/conflicting targets. Notes, meeting memberships, tasks, + memories, labels and findings remain omitted, so this selected format is not a full project backup. +- **`project_annotations_snapshot` and `project_annotations_preview` MCP tools** read the same bounded + selected graph and destination conflicts. Restore is not exposed through MCP. Calls keep the normal + audit record, and schema, file reading, reference policy and transactions come from shared Core. + +### Fixed + +- MCP connection instructions distinguish direct proposed records, configurable project decisions and + owner-only meeting findings and annotation restoration. +- Guides consistently distinguish proposed memories and direct facts from project proposals that an + agent can decide with a recorded reason, and explain the owner decision setting and meeting boundary. +- **`sync --retry-attachments` help no longer says to install an extraction engine.** The PDF and Word + readers ship with memo; the option is for attachments an older memo or a broken install left unread. ## 0.82.0 — 20.10.2026 diff --git a/translations/memo/changelog.ru.md b/translations/memo/changelog.ru.md index ee504070..2477dcd7 100644 --- a/translations/memo/changelog.ru.md +++ b/translations/memo/changelog.ru.md @@ -8,7 +8,30 @@ title: "История изменений" Точные технические записи новых выпусков сохранены на английском; инструкции по использованию переведены в соответствующих руководствах. -## Unreleased +## 0.83.0 — 20.10.2026 + +### Added + +- `memo projects evidence --contact person:` (MCP `project_evidence` `contact`) searches the person's stored name and + keeps the `person:` reference on the lane; an unknown id is refused with `not_found` instead of searched as text, + and a person with no stored name is refused with `validation_error` rather than searched under an identity's name. +- **`projects annotations export|check|restore`** retains selected project aliases, facts and generic + links, with explicit external bindings and historical state. Export writes a new private file from + read-only source access; preview checks an existing explicit target; owner-only restore requires its + exact fingerprint and refuses populated/conflicting targets. Notes, meeting memberships, tasks, + memories, labels and findings remain omitted, so this selected format is not a full project backup. +- **`project_annotations_snapshot` and `project_annotations_preview` MCP tools** read the same bounded + selected graph and destination conflicts. Restore is not exposed through MCP. Calls keep the normal + audit record, and schema, file reading, reference policy and transactions come from shared Core. + +### Fixed + +- MCP connection instructions distinguish direct proposed records, configurable project decisions and + owner-only meeting findings and annotation restoration. +- Guides consistently distinguish proposed memories and direct facts from project proposals that an + agent can decide with a recorded reason, and explain the owner decision setting and meeting boundary. +- **`sync --retry-attachments` help no longer says to install an extraction engine.** The PDF and Word + readers ship with memo; the option is for attachments an older memo or a broken install left unread. ## 0.82.0 — 20.10.2026 diff --git a/translations/memo/commands.es.md b/translations/memo/commands.es.md index d87d3fc5..68e4195e 100644 --- a/translations/memo/commands.es.md +++ b/translations/memo/commands.es.md @@ -1238,7 +1238,7 @@ memo projects evidence [options] | `--source ` | where to look, or all: which accounts, separated by commas: provider:account (email:personal), a provider (email), a kind (mail, notes, documents) or group:. | | `--alias ` | another name of the project, searched on its own; repeat for more. | | `--context-query ` | more words that all appear in one text; repeat for another search. | -| `--contact ` | a person's name; what only names them is context, not the project. | +| `--contact ` | label a contact identity, with --account. | | `--since-time