diff --git a/docs/reviews/2026-10-20-memo082-review.md b/docs/reviews/2026-10-20-memo082-review.md new file mode 100644 index 0000000..149962f --- /dev/null +++ b/docs/reviews/2026-10-20-memo082-review.md @@ -0,0 +1,96 @@ +# Memo document evidence and project review + +Readers gathering a project's sources can inspect the paragraphs around cited documents, understand +which proposals an agent may decide and choose owner-only project decisions. This review updates +Memo from the portal's reviewed 0.81.0 to 0.82.0 without changing other tools' pins. + +## Sources and scope + +Runtime: Memo0.82.0, source `93fc21b692260d9ffaefbaef799b01a46be18a8f`, Core0.371.0 and Base0.47.1. +Five prose-only guide overrides (`index`, `security`, `how-it-works`, `memories`, `usage`) use the +compatible immutable commit `a46159857442f2008324001468b440f009ea9b8c`, merged by +[Memo #353](https://github.com/WireCatLabs/cli-memo/pull/353). Other native guides come from the release. +The runtime feature is [Memo #350](https://github.com/WireCatLabs/cli-memo/pull/350). + +Behavior evidence: released `src/knowledge/project-actions.ts`, `project-actions-documents.test.ts`, +`project-actions-command.ts` and their tests; `src/author.ts`, project decision handlers, direct +memory/fact handlers and meeting findings handlers establish the separate permission boundaries. +Core's shared `documentPassage` supplies paragraph context. Key-document suggestions have no saved +source fingerprint and report `untracked`; findings continue to compare their saved fingerprints. + +A retained synthetic driver exercised the packaged and installed real CLI and stdio MCP server +with temporary state. It checked document paragraphs, untracked key documents, brief/zero-context +omission, unknown-field rejection, proposed state and zero accepted facts. This is functional +validation, not an extraction-accuracy or performance measurement. Reproducible driver, hashes and +private workflow metadata are retained in cli-private under the same dated Memo082 review names. + +## Page and locale inventory + +Reviewer: Codex. Changed task/explanation pages were read with openings and endings, alongside the +native source. The command reference review covers changed generated sections and exact literals, +not a fresh prose review of every unchanged command. Changelog technical entries retain the existing +English-source disclosure in both translations. + +| Page / locale | Reader task | Review and result | +| --- | --- | --- | +| index / en | Choose Memo and start | Project decisions and local-store claim corrected at source | +| index / ru | Same | Full reader page checked; decision control localized | +| index / es | Same | Full reader page checked; decision control localized | +| security / en | Choose data and permissions | Project, direct record and meeting permissions distinguished | +| security / ru | Same | Full page checked; old heading anchors preserved | +| security / es | Same | Full page checked; old heading anchors preserved | +| how-it-works / en | Understand imports and authorship | Memo-only import lock and automatic network checks clarified | +| how-it-works / ru | Same | Full page checked; old heading anchors preserved | +| how-it-works / es | Same | Full page checked; old heading anchors preserved | +| memories / en | Review retained facts and actions | Correct facts-confirm command and source field; project review linked | +| memories / ru | Same | Full page checked; direct facts and meeting findings remain distinct | +| memories / es | Same | Full page checked; direct facts and meeting findings remain distinct | +| usage / en | Find, retain and review | Owner memory confirmation versus fact acceptance explicit | +| usage / ru | Same | Full page checked; project review and configuration links included | +| usage / es | Same | Full page checked; project review and configuration links included | +| mcp / en | Connect and use an agent client | Actual write tools, decisions, paragraph context and untracked state | +| mcp / ru | Same | Changed guide read; permissions and evidence states localized | +| mcp / es | Same | Changed guide read; rejection and refusal kept distinct | +| recipes / en | Gather and review a project | Paragraph windows, untracked documents and partially stale batches | +| recipes / ru | Same | Reader flow and unchanged-finding review checked | +| recipes / es | Same | Reader flow and unchanged-finding review checked | +| search / en | Retrieve evidence | Large-document continuation and paragraph context explained | +| search / ru | Same | Reader flow and coverage boundaries checked | +| search / es | Same | Reader flow and coverage boundaries checked | +| commands / en | Look up exact syntax | Generated changed sections compared with released discovery | +| commands / ru | Same | Exact changed literals; technical help stays in English | +| commands / es | Same | Exact changed literals; technical help stays in English | +| changelog / en | Understand the release | Released 0.82 entry reviewed | +| changelog / ru | Same | Existing technical-entry disclosure retained | +| changelog / es | Same | Existing technical-entry disclosure retained | + +Unchanged pages keep their existing source fingerprints and prior review evidence; this is not a +claim that every unrelated page was newly read. The complete sync and contract checks still cover +all published guides and tools. + +## Findings and corrections + +- Native overview, security, explanation, memory and usage pages said agents could never decide + anything through MCP. Fixed upstream: default project decisions may create accepted facts, + numbered tasks or confirmed key documents; `agent_decisions: false` requires owner decisions. + Direct memories/facts and outbound action proposals remain proposed; meeting findings are owner-only. +- Native memory prose named `accept` and `origin`, contradicting its command example and record shape. + Fixed upstream to `memo facts confirm` and `source`; retired the portal's obsolete `accept` correction. +- The explanation promised nothing could access the network unless requested. Updated it to link the + existing update/sender-domain policy; source-text analysis remains opt-in. +- Translation structure found a missing usage-to-project-review link. Added it in both locales and + checked all ten updated prose-only translations before accepting their source fingerprints. +- The broader portal release update landed during preparation. Rebased on `6155c96`, preserving its + tg0.77/MAX0.66/Zoom0.31/Drive0.19 pins and reviews. Memo-only conflicts retain the newer reviewed text. + +## Validation + +Passed: source/translation structure, full sync, all five released command contracts with network +blocked during discovery, strict docs checks (0 reference gaps; 0 invalid examples), release-note +checks and typecheck. The quality report's manual-review constructs remain separately reported; +syntax validation does not establish task success. Local verification also passed lint (three existing warnings), 322 unit tests and seven browser smoke +cases. A separate one-off browser read checked 24 changed HTML pages and 24 Markdown twins across +EN/RU/ES at390px, preserving old heading anchors, the configuration links and untracked evidence +state, with no page errors or horizontal overflow. The dev server still emits the existing shared +Sidebar React key warning; no runtime code changed. Full export, link, SEO and browser deployment +gates remain unchanged. Production verification follows the successful deployment. diff --git a/scripts/docs-corrections.json b/scripts/docs-corrections.json index 2730d54..824b150 100644 --- a/scripts/docs-corrections.json +++ b/scripts/docs-corrections.json @@ -1784,31 +1784,6 @@ ] } }, - { - "tool": "memo", - "slug": "memories", - "reason": "Memo 0.41.0 exposes facts confirm, replacing facts accept; keep native surrounding prose consistent with the generated command example.", - "replacements": { - "en": [ - { - "before": "`accept`", - "after": "`confirm`" - } - ], - "ru": [ - { - "before": "`accept`", - "after": "`confirm`" - } - ], - "es": [ - { - "before": "`accept`", - "after": "`confirm`" - } - ] - } - }, { "tool": "memo", "slug": "installation", diff --git a/tools.json b/tools.json index 98787a6..60e3b77 100644 --- a/tools.json +++ b/tools.json @@ -61,7 +61,14 @@ "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.81.0", - "profile": false + "docsRef": "v0.82.0", + "profile": false, + "guideRefs": { + "index": "a46159857442f2008324001468b440f009ea9b8c", + "security": "a46159857442f2008324001468b440f009ea9b8c", + "how-it-works": "a46159857442f2008324001468b440f009ea9b8c", + "memories": "a46159857442f2008324001468b440f009ea9b8c", + "usage": "a46159857442f2008324001468b440f009ea9b8c" + } } ] diff --git a/translations/memo/changelog.es.md b/translations/memo/changelog.es.md index ed4c69f..853e916 100644 --- a/translations/memo/changelog.es.md +++ b/translations/memo/changelog.es.md @@ -8,6 +8,21 @@ 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.82.0 — 20.10.2026 + +### Fixed + +- The MCP guide describes project-decision permissions and the accepted facts and numbered tasks that + confirming a proposal can create, alongside the owner-only review of meeting findings. +- Key-document suggestions report `state: "untracked"` because no source fingerprint was saved with + the suggestion. They no longer incorrectly report unchanged text; reread the document before deciding. +- **Project proposal review includes document paragraphs**, using the shared Core passage helper around + the finding's words. `projects actions list`, its MCP counterpart and key-document review now show this + context; `--brief` or zero before/after counts still omit it. The guides also explain oversized evidence + and accepting unchanged findings from a partly stale batch. + ## 0.81.0 — 20.10.2026 ### Fixed diff --git a/translations/memo/changelog.ru.md b/translations/memo/changelog.ru.md index 1e50d17..ee50407 100644 --- a/translations/memo/changelog.ru.md +++ b/translations/memo/changelog.ru.md @@ -8,6 +8,21 @@ title: "История изменений" Точные технические записи новых выпусков сохранены на английском; инструкции по использованию переведены в соответствующих руководствах. +## Unreleased + +## 0.82.0 — 20.10.2026 + +### Fixed + +- The MCP guide describes project-decision permissions and the accepted facts and numbered tasks that + confirming a proposal can create, alongside the owner-only review of meeting findings. +- Key-document suggestions report `state: "untracked"` because no source fingerprint was saved with + the suggestion. They no longer incorrectly report unchanged text; reread the document before deciding. +- **Project proposal review includes document paragraphs**, using the shared Core passage helper around + the finding's words. `projects actions list`, its MCP counterpart and key-document review now show this + context; `--brief` or zero before/after counts still omit it. The guides also explain oversized evidence + and accepting unchanged findings from a partly stale batch. + ## 0.81.0 — 20.10.2026 ### Fixed diff --git a/translations/memo/commands.es.md b/translations/memo/commands.es.md index c74c596..d87d3fc 100644 --- a/translations/memo/commands.es.md +++ b/translations/memo/commands.es.md @@ -1281,7 +1281,7 @@ memo projects actions add [options] #### `memo projects actions list` -a project's proposed key documents and findings, newest first, each with its cited evidence: whether the text changed since it was cited, the text itself and the messages around it +a project's proposed key documents and findings, newest first, with source state, cited text and nearby messages or document paragraphs; key-document text is untracked because no fingerprint was saved ```sh memo projects actions list [query] [options] @@ -1297,9 +1297,9 @@ memo projects actions list [query] [options] | `--json` | print JSON; --json=id,status keeps only those fields. | | `--limit ` | findings batches per page, at most 50. Default: `10`. | | `--page ` | which page, from 1; key documents come on the first. Default: `1`. | -| `--brief` | only the references and whether their text changed, without the text around them. | -| `--before-n ` | messages before each cited message, at most 5. Default: `2`. | -| `--after-n ` | messages after each cited message, at most 5. Default: `2`. | +| `--brief` | only references and source state, without excerpts or nearby text. | +| `--before-n ` | messages or document paragraphs before the citation, at most 5. Default: `2`. | +| `--after-n ` | messages or document paragraphs after the citation, at most 5. Default: `2`. | **Returns:** a project's proposals with the evidence to decide them diff --git a/translations/memo/commands.ru.md b/translations/memo/commands.ru.md index 2816124..c35a375 100644 --- a/translations/memo/commands.ru.md +++ b/translations/memo/commands.ru.md @@ -1281,7 +1281,7 @@ memo projects actions add [options] #### `memo projects actions list` -a project's proposed key documents and findings, newest first, each with its cited evidence: whether the text changed since it was cited, the text itself and the messages around it +a project's proposed key documents and findings, newest first, with source state, cited text and nearby messages or document paragraphs; key-document text is untracked because no fingerprint was saved ```sh memo projects actions list [query] [options] @@ -1297,9 +1297,9 @@ memo projects actions list [query] [options] | `--json` | print JSON; --json=id,status keeps only those fields. | | `--limit ` | findings batches per page, at most 50. Default: `10`. | | `--page ` | which page, from 1; key documents come on the first. Default: `1`. | -| `--brief` | only the references and whether their text changed, without the text around them. | -| `--before-n ` | messages before each cited message, at most 5. Default: `2`. | -| `--after-n ` | messages after each cited message, at most 5. Default: `2`. | +| `--brief` | only references and source state, without excerpts or nearby text. | +| `--before-n ` | messages or document paragraphs before the citation, at most 5. Default: `2`. | +| `--after-n ` | messages or document paragraphs after the citation, at most 5. Default: `2`. | **Returns:** a project's proposals with the evidence to decide them diff --git a/translations/memo/how-it-works.es.md b/translations/memo/how-it-works.es.md index 9888264..58b992e 100644 --- a/translations/memo/how-it-works.es.md +++ b/translations/memo/how-it-works.es.md @@ -42,7 +42,7 @@ Una importación lee tus carpetas y tus cuentas de correo y pone al día el alma importación también prepara el texto nuevo para la búsqueda por significado. `--no-embed` se salta este paso. -Dos importaciones nunca se ejecutan a la vez, y una fuente que falla no detiene las demás. +Dos importaciones de Memo nunca se ejecutan a la vez, y una fuente que falla no detiene las demás. ## Carpetas en más de un ordenador @@ -102,7 +102,10 @@ indica cómo se encontró. Un resultado vacío solo significa que el almacén local no tiene nada que coincida. No demuestra que algo nunca ocurrió: puede que el chat no esté descargado o que la carpeta no esté importada. -## Los agentes sugieren, tú decides + + + +## Autoría del agente y revisión Tu agente puede añadir tres tipos de registros: @@ -111,16 +114,12 @@ Tu agente puede añadir tres tipos de registros: - una **acción propuesta**: algo que hacer, como una respuesta. Siempre espera hasta que la apruebes o la rechaces. Aprobarla la convierte en una tarea para ti. Memo nunca envía un mensaje ni un correo. -Lo que una aplicación añade a través del [servidor MCP](./mcp.md) queda como **propuesto** hasta que -confirmes el recuerdo o aceptes el hecho. A través de MCP, un agente no puede confirmar, aceptar, -aprobar ni rechazar, y cada llamada que hace queda escrita en el registro de agentes -(`memo agents log`), sin los detalles que envió. +Los recuerdos y los hechos registrados directamente mediante el [servidor MCP](./mcp.md) empiezan como **propuestos**. MCP no confirma recuerdos, no acepta directamente hechos propuestos existentes ni aprueba acciones en cuentas externas. Cada llamada se escribe en el registro de agentes (`memo agents log`), sin los detalles enviados. + +Por defecto, un agente puede confirmar o rechazar propuestas de proyecto con un motivo registrado: confirmarlas puede crear hechos aceptados y tareas numeradas o confirmar un documento clave. Configura [`agent_decisions: false`](./configuration.md#agent_decisions) para que solo el propietario decida las propuestas de proyecto. Leer y proponer siguen disponibles. Las conclusiones de reuniones siguen requiriendo al propietario. -El comando `memo` reconoce el terminal de un agente por `AI_AGENT` o `CLAUDECODE`, variables que establecen agentes como Claude Code. Un hecho, recuerdo, vínculo o acción propuesta se atribuye al agente y espera tu revisión, como mediante MCP. Sin ellas, o con `--as-owner`, se atribuye a ti y se confirma al instante. Las variables y `--as-owner` son etiquetas, no un bloqueo: un agente puede establecerlas y escribir como tú. +El comando `memo` reconoce el terminal de un agente por `AI_AGENT` o `CLAUDECODE`, variables que establecen agentes como Claude Code. Allí, un hecho registrado directamente, recuerdo o vínculo se atribuye al agente y empieza como propuesto. Sin ellas, o con `--as-owner`, se atribuye a ti: los recuerdos y vínculos se confirman y los hechos se aceptan al instante. Las acciones propuestas siguen esperando aprobación. Las variables y `--as-owner` son etiquetas, no un bloqueo: un agente puede establecerlas y escribir como tú. ## Qué puede salir de tu ordenador -Nada, a menos que lo pidas. Por defecto, `memo ask` prepara fuentes para tu propio agente. Envía -texto a un proveedor de IA solo cuando configuras uno y añades `--analyze`, y a un proveedor remoto -solo si además añades `--allow-remote`. Lo que tu agente hace con el texto que lee depende de ese -agente. Consulta [Seguridad](./security.md). +El envío de fuentes a un proveedor de IA requiere tu autorización. Por defecto, `memo ask` prepara fuentes para tu agente. Envía texto a un proveedor de IA solo cuando configuras uno y añades `--analyze`, y a uno remoto solo con `--allow-remote` además. Lo que tu agente hace con el texto depende de él. Las comprobaciones automáticas de actualizaciones y dominios de remitentes también pueden hacer peticiones de red; [Seguridad](./security.md) explica qué envían y qué ajustes se aplican. diff --git a/translations/memo/how-it-works.ru.md b/translations/memo/how-it-works.ru.md index 2a74beb..28f83f8 100644 --- a/translations/memo/how-it-works.ru.md +++ b/translations/memo/how-it-works.ru.md @@ -40,7 +40,7 @@ Memo хранит всё в одном файле на вашем компьют - **Подготовка к поиску по смыслу.** Если модель поиска есть на вашем компьютере, импорт также готовит новый текст к поиску по смыслу. `--no-embed` пропускает этот шаг. -Два импорта никогда не идут одновременно, и сбой одного источника не останавливает остальные. +Два импорта Memo никогда не идут одновременно, и сбой одного источника не останавливает остальные. ## Папки на нескольких компьютерах @@ -98,7 +98,10 @@ Memo всегда ищет по словам: он находит заметки Пустой результат означает только то, что в локальном хранилище нет совпадений. Он не доказывает, что чего-то никогда не было: чат может быть не скачан, а папка — не импортирована. -## Агент предлагает, решаете вы + + + +## Авторство агента и проверка Ваш агент может добавлять три вида записей: @@ -108,16 +111,12 @@ Memo всегда ищет по словам: он находит заметки одобрите или не отклоните. Если вы его одобрите, оно станет вашей задачей. Memo никогда не отправляет сообщения или письма. -Всё, что приложение добавляет через [MCP-сервер](./mcp.md), ждёт в статусе **предложенного**, пока вы не -подтвердите запись памяти или не примете факт. Через MCP агент не может подтверждать, принимать, -одобрять или отклонять, и каждый его вызов записывается в журнал агентов (`memo agents log`) без -подробностей, которые он отправил. +Память и напрямую записанные факты, добавленные через [MCP-сервер](./mcp.md), начинаются как **предложенные**. MCP не подтверждает память, не принимает напрямую существующие предложенные факты и не одобряет действия во внешних аккаунтах. Каждый вызов записывается в журнал агента (`memo agents log`) без переданных подробностей. + +По умолчанию агент может подтверждать или отклонять предложения по проекту с указанием причины: подтверждение может создать принятые факты и нумерованные задачи или подтвердить ключевой документ. Настройте [`agent_decisions: false`](./configuration.md#agent_decisions), чтобы решения по проекту принимали только вы. Читать и предлагать агент сможет по-прежнему. Итоги встреч всё ещё требуют решения владельца. -Команда `memo` распознаёт терминал агента по `AI_AGENT` или `CLAUDECODE` — переменным, которые задают такие агенты, как Claude Code. Факт, память, отношение или предложенное действие записываются от имени агента и ждут вас, как через MCP. Без этих переменных или с `--as-owner` запись считается вашей и подтверждается сразу. Переменные и `--as-owner` — метки, а не блокировка: агент может задавать их и писать от вашего имени. +Команда `memo` распознаёт терминал агента по `AI_AGENT` или `CLAUDECODE` — переменным, которые задают такие агенты, как Claude Code. Там напрямую записанный факт, память или отношение записываются от имени агента и начинаются как предложенные. Без этих переменных или с `--as-owner` запись считается вашей: память и отношения подтверждаются сразу, а факты принимаются. Предложенные действия всё ещё ждут одобрения. Переменные и `--as-owner` — метки, а не блокировка: агент может задавать их и писать от вашего имени. ## Что может покинуть ваш компьютер -Ничего, если вы сами об этом не попросите. По умолчанию `memo ask` готовит источники для вашего -собственного агента. Он отправляет текст провайдеру ИИ, только если вы его настроили и добавили -`--analyze`, а удалённому провайдеру — только если вы добавили ещё и `--allow-remote`. Что ваш агент -делает с прочитанным текстом, решает сам агент. См. [Безопасность](./security.md). +Отправка источников провайдеру ИИ требует вашего разрешения. По умолчанию `memo ask` готовит источники для вашего агента. Он отправляет текст провайдеру ИИ, только если вы его настроили и добавили `--analyze`, а удалённому провайдеру — также `--allow-remote`. Что агент делает с прочитанным текстом, зависит от него. Автоматические проверки обновлений и доменов отправителей тоже могут обращаться к сети; [Безопасность](./security.md) объясняет, что они отправляют и какие настройки действуют. diff --git a/translations/memo/index.es.md b/translations/memo/index.es.md index c68abac..00773c0 100644 --- a/translations/memo/index.es.md +++ b/translations/memo/index.es.md @@ -42,10 +42,9 @@ Tres palabras aparecen en todas las páginas: mueven el correo elegido a la Papelera o lo restauran solo con `--yes`. 3. **Tú o tu agente preguntáis.** Memo responde con el texto que coincide y una referencia a cada fuente, para que puedas abrir el original y comprobarlo. -4. **Tu agente puede sugerir, pero tú decides.** Lo que una aplicación añade a través de MCP, y cada - acción propuesta, espera tu revisión. Memo nunca envía un mensaje ni un correo. +4. **Tú controlas las decisiones del proyecto.** Los nuevos recuerdos del agente, los hechos registrados directamente y las propuestas de acciones en cuentas externas esperan revisión. Por defecto, el agente puede decidir propuestas de proyecto con un motivo registrado; [exige decisiones del propietario](./configuration.md#agent_decisions) si quieres revisar cada una. Las conclusiones de reuniones siguen requiriendo al propietario. Memo nunca envía mensajes ni correos. -Todo se queda en tu ordenador. Memo envía tu texto a un proveedor de IA solo cuando configuras uno y +Memo conserva el almacén en tu ordenador. Memo envía tu texto a un proveedor de IA solo cuando configuras uno y lo permites para esa petición. [Cómo funciona Memo](./how-it-works.md) lo explica con más detalle. ## Empezar diff --git a/translations/memo/index.ru.md b/translations/memo/index.ru.md index efb5438..b2fa6fe 100644 --- a/translations/memo/index.ru.md +++ b/translations/memo/index.ru.md @@ -41,10 +41,9 @@ Gemini CLI) использует Memo, чтобы найти сказанное, перемещают выбранные письма в корзину или восстанавливают их только с `--yes`. 3. **Вы или ваш агент задаёте вопрос.** Memo отвечает подходящим текстом и ссылкой на источник для каждого результата, чтобы вы могли открыть оригинал и проверить его. -4. **Агент может предложить, но решаете вы.** Всё, что приложение добавляет через MCP, и каждое - предложенное действие ждут вашей проверки. Memo никогда не отправляет сообщения или письма. +4. **Вы управляете решениями по проекту.** Новые записи памяти агента, напрямую записанные факты и предложения действий во внешних аккаунтах ждут проверки. По умолчанию агент может решать предложения по проекту с указанием причины; [включите решения только владельцем](./configuration.md#agent_decisions), если хотите проверять каждое предложение. Итоги встреч по-прежнему требуют владельца. Memo никогда не отправляет сообщений или писем. -Всё остаётся на вашем компьютере. Memo отправляет ваш текст провайдеру ИИ, только если вы его +Хранилище Memo находится на вашем компьютере. Memo отправляет ваш текст провайдеру ИИ, только если вы его настроили и разрешили это для данного запроса. Подробнее — в разделе [Как работает Memo](./how-it-works.md). ## Начало работы diff --git a/translations/memo/mcp.es.md b/translations/memo/mcp.es.md index f910d58..b036a3d 100644 --- a/translations/memo/mcp.es.md +++ b/translations/memo/mcp.es.md @@ -5,8 +5,8 @@ title: "El servidor MCP" Esta página te ayuda a conectar Memo a una aplicación de IA que no tiene terminal, como Claude Desktop o Cursor. MCP (Model Context Protocol) es la forma en que estas aplicaciones usan un programa de tu ordenador. Una vez conectada, la aplicación puede leer tus mensajes, tu correo, tus notas y tus reuniones archivadas, y lo que -Memo sabe de una persona. También puede guardar recuerdos, registrar hechos y proponer acciones. Lo -que guarda espera tu revisión. +Memo sabe de una persona. También puede guardar recuerdos, registrar hechos y proponer acciones. Las nuevas sugerencias esperan revisión; las propuestas de proyecto tienen permisos de decisión +propios, descritos más abajo. ## Qué puede hacer la aplicación a través de MCP @@ -15,13 +15,22 @@ que guarda espera tu revisión. | Buscar y leer tus mensajes, correo y notas guardados | Enviar un mensaje o un correo | | Leer el contexto de una persona o revisar los hallazgos pendientes de un proyecto | Cambiar tus notas, tu correo o tus mensajes | | Añadir, listar, mostrar y buscar recuerdos | Confirmar un recuerdo | -| Añadir, listar y mostrar hechos | Aceptar un hecho | +| Añadir, listar y mostrar hechos | Aceptar directamente un hecho ya propuesto | | Proponer acciones y listarlas | Aprobar o rechazar una acción | -| Leer el registro de agentes | Borrar nada | -| Buscar proyectos, etiquetas y temas por su nombre, y ver qué tareas están listas | Crear o vincular tareas | +| Revisar propuestas de proyecto y, si está permitido, decidir hechos y seguimientos citados con un motivo | Confirmar un lote de hallazgos de reuniones | +| Leer el registro de agentes | Borrar mensajes, correo o notas de origen | +| Buscar proyectos, etiquetas y temas por su nombre, y ver qué tareas están listas | Crear o modificar tareas arbitrarias | -Cuatro herramientas escriben: `memories_add`, `facts_add`, `actions_add` y `meeting_actions_add`. Lo que añaden queda -como propuesta hasta que lo confirmas, y una acción nunca se envía. Las demás herramientas no modifican los registros de origen; la búsqueda de reuniones puede actualizar su índice de texto local. Conecta Memo solo a una aplicación en la que confíes para leer tus mensajes, tu correo y tus notas. +`memories_add`, `facts_add`, `actions_add`, `meeting_actions_add` y `project_actions_add` guardan propuestas. +Por defecto, `project_actions_confirm` y `project_actions_reject` pueden decidir propuestas de proyecto +por ti con un motivo guardado. Confirmar puede crear hechos aceptados y tareas numeradas, o confirmar +un documento clave. Fija [`agent_decisions: false`](./configuration.md#agent_decisions) para que solo +el propietario decida las propuestas de proyecto; leer y proponer siguen disponibles. Los hallazgos +de reuniones siguen necesitando al propietario. Memo nunca envía una acción propuesta con `actions_add`. + +Las demás herramientas no modifican los registros de origen; la búsqueda de reuniones y la recopilación +de contexto de proyecto pueden actualizar índices de texto locales. Conecta Memo solo a una aplicación +en la que confíes para leer tus mensajes, tu correo y tus notas. ## Conectar una aplicación @@ -71,7 +80,7 @@ Use the memo tools to list the memories waiting for my review. | `vocabulary_inspect` | Examinar dos etiquetas elegidas antes de unirlas: recuentos, coincidencias y muestras limitadas; no fusiona nada | | `tasks_relations`, `tasks_status`, `tasks_list` | Consultar dependencias entre tareas; solo lectura | -Todo lo que añade la aplicación se guarda con el nombre de agente `memo-mcp` y espera como propuesto. Lo revisas +Las sugerencias se guardan con el nombre de agente `memo-mcp`. Revisa los recuerdos y hechos propuestos con `memo memories list status:proposed` y los comandos de [Recuerdos y hechos](./memories.md). ## El registro de agentes @@ -98,12 +107,14 @@ lotes con `memo meetings actions confirm` o `reject`. Preparar un lote no crea h `msg:` o `document:` con el `fingerprint` que dio `project_evidence`, y un texto que cambió desde entonces se rechaza por obsoleto. `project_actions_list` recorre por páginas las propuestas de un proyecto —documentos clave sugeridos (`key:`) y lotes de hallazgos—, cada una con su evidencia: si el texto cambió (`state`), el texto y los mensajes -de alrededor salvo con `brief`. Un texto que cambió después de prepararlos rechaza solo los hallazgos que lo citan. -Decide los que tengas claros con `project_actions_confirm` (los ID de hallazgos que +de alrededor salvo con `brief`; los documentos citados incluyen párrafos cercanos. Si un texto cambió desde que se preparó el lote, solo impide confirmar los hallazgos que lo citan. Decide los que tengas claros con `project_actions_confirm` (los ID de hallazgos que crear) o `project_actions_reject`, siempre con un `reason`, que se guarda con la decisión; pregunta al propietario por el resto. Un lote necesita su `fingerprint`. Si el propietario fija `agent_decisions: false`, las decisiones se rechazan y solo decide el propietario, con `memo projects actions confirm` o `reject`. +Las sugerencias de documentos clave no tienen una huella de texto guardada y devuelven `state: "untracked"`; +vuelve a leerlas antes de decidir. Los hallazgos conservan sus propias huellas para detectar cambios en las fuentes. + `project_evidence` acepta las opciones de `memo projects evidence` en snake_case y necesita `source`: entradas de cuenta, un tipo, `group:` o `all`. Busca por separado el nombre del proyecto, su clave, cada alias guardado y cada `alias`, cada `context_query` y cada `contact`, y une los resultados; `since_time` vale `60d` por defecto. diff --git a/translations/memo/mcp.ru.md b/translations/memo/mcp.ru.md index cd1706a..a3798a8 100644 --- a/translations/memo/mcp.ru.md +++ b/translations/memo/mcp.ru.md @@ -6,7 +6,8 @@ title: "MCP-сервер" MCP (Model Context Protocol, протокол контекста модели) — это способ, которым такие приложения используют программу на вашем компьютере. После подключения приложение может читать ваши сообщения, почту, заметки и архивные встречи, а также то, что Memo знает о человеке. Ещё оно может сохранять память, записывать -факты и предлагать действия. Всё, что оно сохраняет, ждёт вашей проверки. +факты и предлагать действия. Новые предложения ждут проверки; для решений по предложениям проекта +действуют отдельные разрешения, описанные ниже. ## Что приложение может делать через MCP @@ -15,15 +16,22 @@ MCP (Model Context Protocol, протокол контекста модели) | Искать и читать сохранённые сообщения, почту и заметки | Отправить сообщение или письмо | | Читать контекст человека или проверять ожидающие выводы проекта | Изменить ваши заметки, почту или сообщения | | Добавлять, показывать списком, открывать и искать память | Подтвердить запись памяти | -| Добавлять, показывать списком и открывать факты | Принять факт | +| Добавлять, показывать списком и открывать факты | Напрямую принять уже предложенный факт | | Предлагать действия и показывать их списком | Одобрить или отклонить действие | -| Читать журнал агентов | Удалить что-либо | -| Находить проекты, теги и темы по названию и видеть, какие задачи готовы | Создавать или связывать задачи | +| Проверять предложения проекта и, если разрешено, решать процитированные факты и поручения с указанием причины | Подтвердить пакет выводов встречи | +| Читать журнал агентов | Удалить исходные сообщения, почту или заметки | +| Находить проекты, теги и темы по названию и видеть, какие задачи готовы | Создавать или изменять произвольные задачи | -Записывают четыре инструмента: `memories_add`, `facts_add`, `actions_add` и `meeting_actions_add`. То, что они добавляют, -ждёт как предложение, пока вы его не подтвердите, а действие никогда не отправляется. Остальные -инструменты не меняют исходные записи; поиск по встречам может обновить локальный текстовый индекс. Подключайте Memo только к приложению, которому доверяете читать ваши -сообщения, почту и заметки. +`memories_add`, `facts_add`, `actions_add`, `meeting_actions_add` и `project_actions_add` сохраняют предложения. +По умолчанию `project_actions_confirm` и `project_actions_reject` могут решать предложения проекта за вас +с сохранением причины. Подтверждение может создать принятые факты и нумерованные задачи или подтвердить +ключевой документ. Задайте [`agent_decisions: false`](./configuration.md#agent_decisions), чтобы решения +по предложениям проекта принимал только владелец; чтение и подготовка предложений останутся доступны. +Выводы встреч по-прежнему проверяет владелец. Предложенное через `actions_add` действие Memo никогда не отправляет. + +Остальные инструменты не меняют исходные записи; поиск по встречам и сбор контекста проекта могут +обновлять локальные текстовые индексы. Подключайте Memo только к приложению, которому доверяете читать +ваши сообщения, почту и заметки. ## Подключите приложение @@ -72,8 +80,7 @@ Use the memo tools to list the memories waiting for my review. | `vocabulary_inspect` | Проверить два выбранных тега перед объединением: счётчики, пересечения и ограниченные примеры; ничего не объединяет | | `tasks_relations`, `tasks_status`, `tasks_list` | Зависимости задач; только чтение | -Всё, что добавляет приложение, сохраняется под именем агента `memo-mcp` и ждёт со статусом «предложено». -Вы проверяете это командой `memo memories list status:proposed` и командами со страницы +Предложения сохраняются под именем агента `memo-mcp`. Проверяйте предложенные записи памяти и факты командой `memo memories list status:proposed` и командами со страницы [Память и факты](./memories.md). ## Журнал агентов @@ -100,12 +107,14 @@ memo agents log agent:memo-mcp --limit 20 `msg:` или `document:` с `fingerprint`, который выдал `project_evidence`; текст, изменившийся с тех пор, отклоняется как устаревший. `project_actions_list` постранично показывает предложения по проекту — предложенные ключевые документы (`key:`) и пакеты находок — каждое с доказательствами: изменился ли текст (`state`), сам текст и -соседние сообщения, если не указан `brief`. Текст, изменившийся после подготовки, отклоняет только те находки, которые -его цитируют. Решайте те, в которых вы уверены, через `project_actions_confirm` +соседние сообщения, если не указан `brief`; для процитированных документов добавлены соседние абзацы. Изменение текста после подготовки пакета мешает подтвердить только находки, которые на него ссылаются. Решайте те, в которых вы уверены, через `project_actions_confirm` (ID находок, которые нужно создать) или `project_actions_reject`, всегда с `reason`, которая сохраняется вместе с решением; об остальных спросите владельца. Пакету нужен его `fingerprint`. Если владелец задал `agent_decisions: false`, решения отклоняются и решает только владелец через `memo projects actions confirm` или `reject`. +У предложений ключевых документов нет сохранённого отпечатка текста: они возвращают `state: "untracked"`. +Перечитайте их перед решением. Находки сохраняют собственные отпечатки источников для обнаружения изменений. + `project_evidence` принимает параметры `memo projects evidence` в snake_case и требует `source`: записи аккаунтов, вид, `group:` или `all`. Он ищет по названию проекта, его ключу, каждому сохранённому псевдониму и каждому `alias`, каждому `context_query` и каждому `contact` отдельно и объединяет найденное; `since_time` по умолчанию `60d`. diff --git a/translations/memo/memories.es.md b/translations/memo/memories.es.md index 318b434..de495a5 100644 --- a/translations/memo/memories.es.md +++ b/translations/memo/memories.es.md @@ -30,7 +30,10 @@ explica cómo. Para un lote de hechos y tareas con citas de reuniones, usa la [revisión de conclusiones de reuniones](#meeting-findings) de abajo. -**Qué espera tu decisión.** Una acción propuesta siempre espera aprobación o rechazo. Un recuerdo o hecho espera cuando lo añade un agente: mediante [MCP](./mcp.md) o `memo` en su terminal (con `AI_AGENT` o `CLAUDECODE`), que registra al agente como autor. Lo que añades personalmente se confirma al instante; en un terminal de agente, `--as-owner` lo atribuye a ti. El agente también puede pasar `--as-owner`; indícale que no lo haga. +Para fuentes reunidas en un proyecto, usa la [revisión de propuestas de proyecto](./recipes.md#review-project-facts-and-follow-ups). +Por defecto, un agente puede confirmar o rechazar propuestas de proyecto con un motivo registrado: confirmarlas puede crear hechos aceptados y tareas numeradas o confirmar un documento clave. Configura [`agent_decisions: false`](./configuration.md#agent_decisions) para que solo el propietario decida las propuestas de proyecto. Leer y proponer siguen disponibles. Las conclusiones de reuniones siguen requiriendo al propietario. + +**Qué espera tu decisión.** Una acción propuesta siempre espera aprobación o rechazo. Un recuerdo o hecho registrado directamente espera cuando lo añade un agente: mediante [MCP](./mcp.md) o `memo` en su terminal (con `AI_AGENT` o `CLAUDECODE`), que registra al agente como autor. Tu recuerdo se confirma y tu hecho se acepta al instante; en un terminal de agente, `--as-owner` lo atribuye a ti. El agente también puede pasar `--as-owner`; indícale que no lo haga. ## Recuerdos @@ -62,7 +65,7 @@ memo facts show fact:4 memo facts confirm fact:4 ``` -Un hecho que añades con `memo` se acepta al instante. El de un agente queda `proposed` hasta `accept`; `author` y `origin` identifican al autor. `facts list` filtra por `kind`, `status`, `project` y `subject` en la consulta. `--project project:1` lo incorpora a un proyecto y `--occurred-time` indica cuándo ocurrió. +Un hecho que añades con `memo` se acepta al instante. El de un agente queda `proposed` hasta `memo facts confirm`; `author` y `source` identifican al autor. `facts list` filtra por `kind`, `status`, `project` y `subject` en la consulta. `--project project:1` lo incorpora a un proyecto y `--occurred-time` indica cuándo ocurrió. Una decisión puede sustituir a otra anterior: añade `--supersedes fact:2`. Cuando aceptas la nueva decisión, la antigua deja de ser válida. Cuando una decisión ya no es válida y nada la sustituyó, @@ -128,8 +131,6 @@ Nunca guarda lo que envió el agente. ## A través del servidor MCP -Una aplicación sin terminal, como Claude Desktop, puede añadir recuerdos, hechos y acciones propuestas -a través de [el servidor MCP](./mcp.md). Lo que añade siempre espera tu decisión: a través de MCP un -agente no puede confirmar, aceptar, aprobar ni rechazar. +Una aplicación sin terminal, como Claude Desktop, puede añadir recuerdos, hechos y acciones propuestas mediante [el servidor MCP](./mcp.md). Los registros directos quedan propuestos. Las propuestas de proyecto usan el flujo de revisión separado descrito arriba. Siguiente: [conectar una aplicación a través de MCP](./mcp.md). diff --git a/translations/memo/memories.ru.md b/translations/memo/memories.ru.md index 3c8eb24..29d89f6 100644 --- a/translations/memo/memories.ru.md +++ b/translations/memo/memories.ru.md @@ -30,7 +30,10 @@ memo actions list status:proposed Для пакета фактов и задач с источниками встречи используйте [проверку итогов встречи](#meeting-findings) ниже. -**Что ждёт вашего решения.** Предложенное действие всегда ждёт одобрения или отклонения. Память или факт ждут, когда их добавляет агент: через [сервер MCP](./mcp.md) или команду `memo` в терминале агента (с `AI_AGENT` или `CLAUDECODE`), где автором записывается агент. Ваша запись подтверждается сразу; в терминале агента `--as-owner` делает запись вашей. Агент тоже может передать `--as-owner`, поэтому запретите ему это. +Для источников, собранных по проекту, используйте [проверку предложений по проекту](./recipes.md#review-project-facts-and-follow-ups). +По умолчанию агент может подтверждать или отклонять предложения по проекту с указанием причины: подтверждение может создать принятые факты и нумерованные задачи или подтвердить ключевой документ. Настройте [`agent_decisions: false`](./configuration.md#agent_decisions), чтобы решения по проекту принимали только вы. Читать и предлагать агент сможет по-прежнему. Итоги встреч всё ещё требуют решения владельца. + +**Что ждёт вашего решения.** Предложенное действие всегда ждёт одобрения или отклонения. Память или напрямую записанный факт ждут, когда их добавляет агент: через [сервер MCP](./mcp.md) или команду `memo` в терминале агента (с `AI_AGENT` или `CLAUDECODE`), где автором записывается агент. Ваша память подтверждается сразу, а факт принимается; в терминале агента `--as-owner` делает запись вашей. Агент тоже может передать `--as-owner`, поэтому запретите ему это. ## Память @@ -62,7 +65,7 @@ memo facts show fact:4 memo facts confirm fact:4 ``` -Факт, который вы добавляете командой `memo`, принимается сразу. Запись агента остаётся `proposed` до `accept`; `author` и `origin` показывают автора. `facts list` фильтруется полями `kind`, `status`, `project` и `subject` запроса. `--project project:1` относит факт к проекту, а `--occurred-time` задаёт дату события. +Факт, который вы добавляете командой `memo`, принимается сразу. Запись агента остаётся `proposed` до `memo facts confirm`; `author` и `source` показывают автора. `facts list` фильтруется полями `kind`, `status`, `project` и `subject` запроса. `--project project:1` относит факт к проекту, а `--occurred-time` задаёт дату события. Решение может заменить более раннее: добавьте `--supersedes fact:2`. Когда вы примете новое решение, старое перестанет действовать. Если решение больше не действует и ничем не заменено, выполните @@ -128,8 +131,6 @@ memo agents log agent:memo-mcp ## Через MCP-сервер -Приложение без терминала, например Claude Desktop, может добавлять память, факты и предложенные -действия через [MCP-сервер](./mcp.md). Всё, что оно добавляет, всегда ждёт вашего решения: через MCP -агент не может подтверждать, принимать, одобрять или отклонять. +Приложение без терминала, например Claude Desktop, может добавлять память, факты и предложенные действия через [MCP-сервер](./mcp.md). Прямые записи остаются предложенными. Предложения по проекту используют отдельную проверку, описанную выше. Дальше: [подключите приложение через MCP](./mcp.md). diff --git a/translations/memo/recipes.es.md b/translations/memo/recipes.es.md index cacb12d..06869f8 100644 --- a/translations/memo/recipes.es.md +++ b/translations/memo/recipes.es.md @@ -127,15 +127,20 @@ memo projects actions list HRB --limit 5 --page 1 --json memo projects actions list HRB --brief ``` -La vista normal incluye fragmentos citados y mensajes cercanos. Lee la fuente completa cuando un +La vista normal incluye fragmentos citados y mensajes o párrafos de documentos cercanos. Lee la fuente completa cuando un fragmento no baste para juzgar el hallazgo. `--brief` conserva referencias y estado de las fuentes sin -ese contexto. `--limit` cuenta lotes de hallazgos; los documentos clave propuestos se añaden en la +ese contexto. Las sugerencias de documentos clave no tienen una huella de texto guardada: su estado +es `untracked`, así que vuelve a leerlas antes de decidir. Un hallazgo sí conserva su propia huella +para comprobar el texto citado. `--limit` cuenta lotes de hallazgos; los documentos clave propuestos se añaden en la primera página. Usa `--page 2` y las siguientes mientras el resultado indique que hay más. La recopilación usa puntos de continuación; esta lista de revisión usa números de página. Comprueba el significado, proyecto, fecha y responsable de cada hallazgo con su evidencia. Una cita exacta o una huella sin cambios no demuestra que la conclusión se desprenda del texto. Si una fuente -cambió o desapareció, vuelve a leerla y prepara una propuesta nueva; puedes rechazar un lote obsoleto. +cambió o desapareció, vuelve a leerla y prepara una propuesta nueva para los hallazgos afectados. +Puedes aceptar los hallazgos cuyo proyecto, responsable y texto citado no hayan cambiado. Algunos +lotes antiguos exigen que todas las citas sigan iguales; si uno no permite confirmar, prepara los +hallazgos que aún quieras en un lote nuevo. Puedes rechazar un lote obsoleto. El propietario puede confirmar un documento clave como `key:12` o aceptar hallazgos elegidos de un lote. En este ejemplo, sustituye `7`, ambos ID y `BATCH_FINGERPRINT` por los valores de la lista de revisión: diff --git a/translations/memo/recipes.ru.md b/translations/memo/recipes.ru.md index 0266944..47de838 100644 --- a/translations/memo/recipes.ru.md +++ b/translations/memo/recipes.ru.md @@ -127,15 +127,20 @@ memo projects actions list HRB --limit 5 --page 1 --json memo projects actions list HRB --brief ``` -Обычный вид показывает отрывки источников и соседние сообщения. Прочитайте полный источник, если +Обычный вид показывает отрывки источников и соседние сообщения или абзацы документов. Прочитайте полный источник, если отрывка недостаточно для оценки вывода. `--brief` оставляет ссылки и состояние источника без контекста. +У предложений ключевых документов нет сохранённого отпечатка текста: их состояние — `untracked`, +поэтому перечитайте их перед решением. У вывода есть собственный отпечаток, с которым можно сверить источник. `--limit` считает пакеты выводов; предложенные ключевые документы добавляются на первой странице. Используйте `--page 2` и следующие страницы, пока результат сообщает о продолжении. Сбор использует контрольные точки, а этот список проверки — номера страниц. Сверьте смысл каждого вывода, проект, дату и исполнителя с доказательствами. Точная цитата или неизменившийся отпечаток ещё не означают, что вывод следует из текста. Если источник изменился или -исчез, перечитайте его и подготовьте новое предложение; устаревший пакет можно отклонить. +исчез, перечитайте его и подготовьте новое предложение для затронутых выводов. Вы всё ещё можете +принять выводы, у которых не изменились проект, исполнитель и процитированный текст. Некоторым +старым пакетам нужны неизменившиеся источники для всех выводов; если такой пакет не удаётся подтвердить, +подготовьте нужные выводы в новом пакете. Устаревший пакет можно отклонить. Владелец может подтвердить ключевой документ вроде `key:12` или выбрать выводы из пакета. В примере замените `7`, оба ID выводов и `BATCH_FINGERPRINT` значениями из списка проверки: diff --git a/translations/memo/search.es.md b/translations/memo/search.es.md index 1e63aaf..71cebb3 100644 --- a/translations/memo/search.es.md +++ b/translations/memo/search.es.md @@ -151,6 +151,11 @@ una reunión antigua importada hoy sigue siendo antigua. Lee el fragmento y sus `memo meetings passage` antes de sacar conclusiones. La recopilación no crea vínculos al proyecto, no establece asistentes ni guarda hechos o tareas extraídos. +Un resultado de documento incluye párrafos breves alrededor del primer párrafo con una palabra buscada. +Ayudan a localizar el pasaje, pero no prueban una conclusión. Si `oversized` enumera un documento, +la recopilación no leyó su texto: abre su referencia con `memo notes show` cuando lo necesites. +Mantén la fuente sin leer en el resultado en vez de afirmar que no hay evidencia. + Si `units` indica un índice de reuniones pendiente, ejecuta `memo search meetings` para esa misma cuenta siguiendo [la búsqueda de reuniones](#search-stored-meetings) y vuelve a recopilar. La actualización de correo y documentos no indexa fragmentos de transcripciones. Las transcripciones diff --git a/translations/memo/search.ru.md b/translations/memo/search.ru.md index ad70c49..a3852c9 100644 --- a/translations/memo/search.ru.md +++ b/translations/memo/search.ru.md @@ -147,6 +147,11 @@ memo projects evidence HRB --source zoom:work,telegram:1 --since-time 60d --befo `memo meetings passage`, прежде чем делать выводы. Сбор не создаёт связей с проектом, не устанавливает состав участников и не сохраняет извлечённые факты и задачи. +Совпадение в документе включает короткие абзацы вокруг первого абзаца со словом из запроса. +Они помогают найти фрагмент, но не доказывают вывод. Если `oversized` перечисляет документ, +сбор не прочитал его текст: при необходимости откройте возвращённую ссылку через `memo notes show`. +Сохраните непрочитанный источник в результате вместо утверждения, что доказательств нет. + Если `units` сообщает об ожидающем индексе встреч, выполните `memo search meetings` для того же аккаунта по [сценарию поиска встреч](#search-stored-meetings), затем повторите сбор. Обновление индекса почты и документов не индексирует фрагменты расшифровок. Отсутствующие расшифровки сначала diff --git a/translations/memo/security.es.md b/translations/memo/security.es.md index 6d6b2b5..c09c989 100644 --- a/translations/memo/security.es.md +++ b/translations/memo/security.es.md @@ -30,10 +30,14 @@ Cuando borras un archivo de nota o un correo, su texto sale del almacén local e importación. Si una importación detecta que falta de golpe una parte inusualmente grande de una carpeta o de un buzón, no borra nada y te avisa. -## Los agentes sugieren, tú decides + + -- Las acciones propuestas y los recuerdos y hechos añadidos por MCP esperan tu revisión. Por MCP un agente no puede confirmar, aceptar, aprobar ni rechazar. -- Un hecho, recuerdo, vínculo o acción propuesta añadido con `memo` registra al autor. En un terminal de agente (`AI_AGENT` o `CLAUDECODE` definido), el agente es el autor y el hecho, recuerdo o vínculo espera tu revisión, como mediante MCP. Lo tuyo se confirma al instante; en el terminal de un agente se indica con `--as-owner`. Es una etiqueta, no un bloqueo: el agente también puede pasarla, así que indícale que nunca lo haga. +## Controlar las decisiones del agente + +- Los recuerdos del agente, los hechos registrados directamente y las propuestas de acciones en cuentas externas empiezan como propuestos. MCP no confirma recuerdos, no acepta directamente hechos propuestos existentes ni aprueba acciones en cuentas externas. +- Por defecto, un agente puede confirmar o rechazar propuestas de proyecto con un motivo registrado: confirmarlas puede crear hechos aceptados y tareas numeradas o confirmar un documento clave. Configura [`agent_decisions: false`](./configuration.md#agent_decisions) para que solo el propietario decida las propuestas de proyecto. Leer y proponer siguen disponibles. Las conclusiones de reuniones siguen requiriendo al propietario. +- Un hecho, recuerdo o vínculo añadido con `memo` registra al autor. En un terminal de agente (`AI_AGENT` o `CLAUDECODE` definido), el agente es el autor y el hecho registrado directamente, recuerdo o vínculo nuevo espera revisión. Los recuerdos y vínculos del propietario se confirman y los hechos se aceptan al instante; en el terminal de un agente, añade `--as-owner`. Es una etiqueta, no un bloqueo: el agente también puede pasarla, así que indícale que nunca lo haga. - Aprobar una acción la convierte en una tarea para ti. Memo no envía mensajes ni correos. - El registro del agente conserva agente, herramienta, resultado y hora, sin el contenido enviado. - Un agente que solo debe leer se ejecuta con `MEMO_READ_ONLY=1`. Entonces todo comando que cambia algo se detiene con `permission_error` (código de salida 5), y `memo mcp` ofrece solo sus herramientas de lectura. Las lecturas y `memo sync` siguen funcionando, igual que las escrituras de tareas que hace un agente programado con `tasks plan` y `tasks link`, como en tg y max: el vínculo solo se propone y se rechaza vincular dos tareas. `reminders poll` se rechaza. diff --git a/translations/memo/security.ru.md b/translations/memo/security.ru.md index 01b0837..e951195 100644 --- a/translations/memo/security.ru.md +++ b/translations/memo/security.ru.md @@ -29,10 +29,14 @@ title: "Безопасность" импорте. Если импорт обнаружит, что необычно большая часть папки или почтового ящика пропала разом, он ничего не удаляет и сообщает вам об этом. -## Агенты предлагают, вы решаете + + -- Предложенные действия, память и факты из MCP ждут вашего решения. Через MCP агент не может подтверждать, принимать, одобрять или отклонять. -- Факт, память, отношение или предложенное действие, добавленные командой `memo`, сохраняют автора. В терминале агента (задана `AI_AGENT` или `CLAUDECODE`) автор — агент; факт, память или отношение ждут вас, как через MCP. Ваша запись подтверждается сразу; в терминале агента это задаёт `--as-owner`. `--as-owner` — метка, не блокировка: агент тоже может её передать, поэтому запретите ему это. +## Управляйте решениями агента + +- Записи памяти агента, напрямую записанные факты и предложения действий во внешних аккаунтах начинаются как предложенные. MCP не подтверждает память, не принимает напрямую существующие предложенные факты и не одобряет действия во внешних аккаунтах. +- По умолчанию агент может подтверждать или отклонять предложения по проекту с указанием причины: подтверждение может создать принятые факты и нумерованные задачи или подтвердить ключевой документ. Настройте [`agent_decisions: false`](./configuration.md#agent_decisions), чтобы решения по проекту принимали только вы. Читать и предлагать агент сможет по-прежнему. Итоги встреч всё ещё требуют решения владельца. +- Факт, память или отношение, добавленные командой `memo`, сохраняют автора. В терминале агента (задана `AI_AGENT` или `CLAUDECODE`) автор — агент; напрямую записанный факт, память или новое отношение ждут проверки. Память и отношения владельца подтверждаются сразу, а факты принимаются; в терминале агента добавьте `--as-owner`. Это метка, а не блокировка: агент тоже может её передать, поэтому запретите ему это. - Одобренное действие становится вашей задачей. Memo не отправляет сообщений или писем. - Журнал агента хранит агента, инструмент, результат и время, без переданного текста. - Агент, который должен только читать, работает с `MEMO_READ_ONLY=1`. Тогда каждая команда, которая что-то меняет, diff --git a/translations/memo/usage.es.md b/translations/memo/usage.es.md index abb778a..5adb8e4 100644 --- a/translations/memo/usage.es.md +++ b/translations/memo/usage.es.md @@ -70,7 +70,9 @@ Use memo CLI to show the memories, facts and actions waiting for my review, with Do not confirm or approve anything; I will decide. ``` -[Recuerdos y hechos](./memories.md) explica cómo confirmarlos o rechazarlos. Aprobar una acción la convierte en una tarea para ti; Memo no envía nada. Un recuerdo o hecho añadido por el agente con `memo` también espera: con `AI_AGENT` o `CLAUDECODE`, Memo registra al agente como autor. Lo que añades personalmente se confirma al instante. +[Recuerdos y hechos](./memories.md) explica cómo confirmarlos o rechazarlos. Aprobar una acción la convierte en una tarea para ti; Memo no envía nada. Un recuerdo o hecho añadido por el agente con `memo` también espera: con `AI_AGENT` o `CLAUDECODE`, Memo registra al agente como autor. Tus recuerdos se confirman y tus hechos se aceptan al instante. + +Las propuestas de proyecto tienen un [flujo de revisión](./recipes.md#review-project-facts-and-follow-ups) separado. Por defecto, un agente puede confirmar o rechazar propuestas de proyecto con un motivo registrado: confirmarlas puede crear hechos aceptados y tareas numeradas o confirmar un documento clave. Configura [`agent_decisions: false`](./configuration.md#agent_decisions) para que solo el propietario decida las propuestas de proyecto. Leer y proponer siguen disponibles. Las conclusiones de reuniones siguen requiriendo al propietario. ## Respuestas para scripts y agentes diff --git a/translations/memo/usage.ru.md b/translations/memo/usage.ru.md index 73e4944..834f76e 100644 --- a/translations/memo/usage.ru.md +++ b/translations/memo/usage.ru.md @@ -70,7 +70,9 @@ Use memo CLI to show the memories, facts and actions waiting for my review, with Do not confirm or approve anything; I will decide. ``` -[Память и факты](./memories.md) объясняет подтверждение и отклонение записей. Одобренное действие становится вашей задачей; Memo ничего не отправляет. Память или факт, добавленные агентом через `memo`, тоже ждут вас: при `AI_AGENT` или `CLAUDECODE` автором записывается агент. Ваша запись подтверждается сразу. +[Память и факты](./memories.md) объясняет подтверждение и отклонение записей. Одобренное действие становится вашей задачей; Memo ничего не отправляет. Память или факт, добавленные агентом через `memo`, тоже ждут вас: при `AI_AGENT` или `CLAUDECODE` автором записывается агент. Ваша память подтверждается сразу, а факт принимается. + +Предложения по проекту используют отдельную [проверку](./recipes.md#review-project-facts-and-follow-ups). По умолчанию агент может подтверждать или отклонять предложения по проекту с указанием причины: подтверждение может создать принятые факты и нумерованные задачи или подтвердить ключевой документ. Настройте [`agent_decisions: false`](./configuration.md#agent_decisions), чтобы решения по проекту принимали только вы. Читать и предлагать агент сможет по-прежнему. Итоги встреч всё ещё требуют решения владельца. ## Ответы для скриптов и агентов diff --git a/translations/sources.json b/translations/sources.json index 576f388..9c692c1 100644 --- a/translations/sources.json +++ b/translations/sources.json @@ -134,42 +134,42 @@ "drive/security.es": "a49bb872d74c6abaa9586f5e8995633d5faae489e93abfcff54999118061f3d3", "memo/archive.es": "4ec5c10e7af64d164cb92e7a5aae788540c0f3ccdcd9df0c6999170afe65217a", "memo/archive.ru": "4ec5c10e7af64d164cb92e7a5aae788540c0f3ccdcd9df0c6999170afe65217a", - "memo/commands.es": "153af9d4b38b8ba2f1f4575b653a940444fbb5a7cf77f37c20c3f4d398d45e22", - "memo/commands.ru": "153af9d4b38b8ba2f1f4575b653a940444fbb5a7cf77f37c20c3f4d398d45e22", + "memo/commands.es": "6852c24269e3be4beadaf2320cdcdbd90171c1a488399bb719e7726f9f077f50", + "memo/commands.ru": "6852c24269e3be4beadaf2320cdcdbd90171c1a488399bb719e7726f9f077f50", "memo/configuration.es": "f056563d9c4df3df4269082ce3381873687462c3361afcea884e435f3d1dddaf", "memo/configuration.ru": "f056563d9c4df3df4269082ce3381873687462c3361afcea884e435f3d1dddaf", - "memo/how-it-works.es": "857d88ddd3149c3d4c4ef17842a0b9eccf9eef004ab4343a2bf442744e5c24a0", - "memo/how-it-works.ru": "857d88ddd3149c3d4c4ef17842a0b9eccf9eef004ab4343a2bf442744e5c24a0", - "memo/index.es": "7574a1d3cb0754855af424c37e0cece4b7b562fd3e7397067ba5e67b1c39198b", - "memo/index.ru": "7574a1d3cb0754855af424c37e0cece4b7b562fd3e7397067ba5e67b1c39198b", + "memo/how-it-works.es": "10253b14d275396d2fbf9df37eb8c0b478c46c66dc0495247cdb76d2a93dadd7", + "memo/how-it-works.ru": "10253b14d275396d2fbf9df37eb8c0b478c46c66dc0495247cdb76d2a93dadd7", + "memo/index.es": "3363d2296603027571f83d8bccaeab17a6c8d7e7d3f41fac064abe9828b03883", + "memo/index.ru": "3363d2296603027571f83d8bccaeab17a6c8d7e7d3f41fac064abe9828b03883", "memo/installation.es": "cc433c3bcdd4e74c80d663d6144a667224ccea578d968e05b36e5fee15d864cf", "memo/installation.ru": "cc433c3bcdd4e74c80d663d6144a667224ccea578d968e05b36e5fee15d864cf", "memo/mail.es": "b335104f50b081b8f1d867566a1c2776da05aab51057eab955d2f74a62108bc8", "memo/mail.ru": "b335104f50b081b8f1d867566a1c2776da05aab51057eab955d2f74a62108bc8", - "memo/mcp.es": "bf0f35aca819184786eac1c65414430da98a971bac92320d9ab39fc0ca2f6c9b", - "memo/mcp.ru": "bf0f35aca819184786eac1c65414430da98a971bac92320d9ab39fc0ca2f6c9b", - "memo/memories.es": "074a473bdf314cf163ae130bb40c500f8e70997178b8262edb3bc868033068c8", - "memo/memories.ru": "074a473bdf314cf163ae130bb40c500f8e70997178b8262edb3bc868033068c8", + "memo/mcp.es": "d6d7e78e833c295adcd8bd9aa41d15a0c5b05089eb55d804659731842288417c", + "memo/mcp.ru": "d6d7e78e833c295adcd8bd9aa41d15a0c5b05089eb55d804659731842288417c", + "memo/memories.es": "82e89578de3c502b5c0a7041bd2998af8c9e08c2f27205a777902ac56b693e73", + "memo/memories.ru": "82e89578de3c502b5c0a7041bd2998af8c9e08c2f27205a777902ac56b693e73", "memo/notes.es": "d56c752daa37531912b668164aa2522791d55f1aaa73b00d5634f9bfd86f937f", "memo/notes.ru": "d56c752daa37531912b668164aa2522791d55f1aaa73b00d5634f9bfd86f937f", "memo/people.es": "13c48cbbfb961817ea07851d81d8e754ae53537e2bd0d8d6f6860bf41d6a0958", "memo/people.ru": "13c48cbbfb961817ea07851d81d8e754ae53537e2bd0d8d6f6860bf41d6a0958", - "memo/recipes.es": "ff567c0633d3c01f743cdfa027fe7e824bce5ebfb9432b2e2fc79d3a88d05f85", - "memo/recipes.ru": "ff567c0633d3c01f743cdfa027fe7e824bce5ebfb9432b2e2fc79d3a88d05f85", - "memo/search.es": "2f5662ffe1d7b12493d4ae3ad378e543288c5d1aedf70a7130dba4c8b08f55cd", - "memo/search.ru": "2f5662ffe1d7b12493d4ae3ad378e543288c5d1aedf70a7130dba4c8b08f55cd", - "memo/security.es": "78c212fa907a0838f99f024dbc5482ff6ef078938238934e1493a1073158e552", - "memo/security.ru": "78c212fa907a0838f99f024dbc5482ff6ef078938238934e1493a1073158e552", + "memo/recipes.es": "3addbe65c020b3d17f9b8fe2f1d84f1321f81e94635151564461b5b13ae4fd16", + "memo/recipes.ru": "3addbe65c020b3d17f9b8fe2f1d84f1321f81e94635151564461b5b13ae4fd16", + "memo/search.es": "3548c5e47ae62282115e34592476bc3a5853a92090644815810ccdd596c2cb17", + "memo/search.ru": "3548c5e47ae62282115e34592476bc3a5853a92090644815810ccdd596c2cb17", + "memo/security.es": "19abc966e6af84f6ca64b0a6c28069b26804ad02d67a529d44ea08aba6a09ab7", + "memo/security.ru": "19abc966e6af84f6ca64b0a6c28069b26804ad02d67a529d44ea08aba6a09ab7", "memo/tags.es": "b14b5d80057665c2fc13c76a0d0262a760e0ac9ecbe277642909698557e80d0f", "memo/tags.ru": "b14b5d80057665c2fc13c76a0d0262a760e0ac9ecbe277642909698557e80d0f", "memo/tasks.es": "c086bd23fb0826faef3538566fb6168cb77763c687b321bef79b5ab19e015aea", "memo/tasks.ru": "c086bd23fb0826faef3538566fb6168cb77763c687b321bef79b5ab19e015aea", "memo/troubleshooting.es": "2eef97e2e3dc72d73e75806de73a42748bf709f2fcaf9fe78c8ebfacb7af94d8", "memo/troubleshooting.ru": "2eef97e2e3dc72d73e75806de73a42748bf709f2fcaf9fe78c8ebfacb7af94d8", - "memo/usage.es": "44e5d564ff354e611a174a0836bbcd2b8d1d44f22d50e381e0cb26aecc2a2847", - "memo/usage.ru": "44e5d564ff354e611a174a0836bbcd2b8d1d44f22d50e381e0cb26aecc2a2847", - "memo/changelog.ru": "f8867fd947ad5c79e7a689153e683b2db19dd3c90064df0c527a094a01ccd891", - "memo/changelog.es": "f8867fd947ad5c79e7a689153e683b2db19dd3c90064df0c527a094a01ccd891", + "memo/usage.es": "acde45092b89737a9a8580e4063f0bcf29c380544269b042589f22afea34bfcf", + "memo/usage.ru": "acde45092b89737a9a8580e4063f0bcf29c380544269b042589f22afea34bfcf", + "memo/changelog.ru": "c27dc5c06196fec5d4473f94f772f261042fc96f916299475b4e042f459895a8", + "memo/changelog.es": "c27dc5c06196fec5d4473f94f772f261042fc96f916299475b4e042f459895a8", "zm/troubleshooting.ru": "ea65e0dc08288b94c8f754790ddd7ac30f0645d66abeaf24db33a3a40001023a", "zm/roadmap.es": "204a8bd153c69b1186e09dd8df1cd8d6426f8148df2a7c2eb4e7337705ad9853", "zm/mcp.ru": "af8970a4447b90a7f21d0d79b9fcc56d2d5d2e5ca6acfaacf2b11d5d5807861c",