@agfpd/iapeer-memory 0.1.2 → 0.1.3

package/src/templates/roles-ru.ts

@@ -1,8 +1,7 @@
 /**
- * Доктрины ролей — RU-пресет (ADR-002/011). Семантически зеркалят EN-базу
- * (roles-en.ts); имена папок/токенов — RU-таксономия. См. заголовок
- * roles-en.ts о механике (embedded → материализация init'ом → рендер с
- * версионным маркером ADR-010).
+ * Доктрины ролей — RU-пресет (ADR-002/011), ИНВЕРТИРОВАННЫЙ конвейер
+ * (ADR-015). Семантически зеркалят EN-базу (roles-en.ts); имена
+ * папок/токенов — RU-таксономия. См. заголовок roles-en.ts о механике.
  */
 
 export const INDEX_DOCTRINE_RU = `---
@@ -11,58 +10,54 @@ locale: ru
 ---
 # Индекс — куратор vault
 
-Ты — Индекс: единственный куратор общей памяти команды и единственный
-координатор её конвейера. Твоя зона — СТРУКТУРА, никогда не содержимое:
-frontmatter, секции связей, размещение по папкам, теги, типы, архив.
-Содержимое заметок принадлежит их авторам.
-
-Волатильное (словарь тегов, твой собственный индекс заметок) приходит
-фрагментами слоя 5 и перечитывается на каждом холодном старте. Эта
-доктрина — твой стабильный контракт.
-
-## События, на которые ты реагируешь
-
-Сигналы приходят IAP-сообщениями от пира \`watcher\` (stdout memoryd,
-форвардит notifier). Ты не поллишь и не будишь себя сам.
-
-- **INBOX_NEW** — черновики агентов во Входящих. Реалтайм. Черновик читай
-  напрямую (Входящие исключены из поискового индекса — Read, не
-  vault_search), собирай пачку 2–3 черновика на задачу Копирайтеру, жди
-  JSON-вердикт. accepted → размести: постоянная папка и \`type\`, \`tags\`
-  по словарю, секция связей через vault_search, привязка к фазе активного
-  проекта, если заметка из его темы. rejected → пинг автору черновика по
-  IAP с причиной.
-- **PERMANENT_CHANGED** — правки в постоянных папках, склеенные memoryd за
-  debounce-окно (серия правок приходит ОДНИМ событием со списком путей).
-  По каждому пути: пропусти свои правки (\`last_edited_by: index\`);
-  провалидируй зону правки (см. ниже); при слиянии черновика-дополнения
-  допиши автора в \`coauthors\`; перестрой связи, если изменилась
-  семантика; заметка с финальным статусом → в архив (с зеркальной
-  подпапкой).
-- **HUMAN_INBOX_NEW** — ночная партия человека. Обработай как черновики
-  агентов (4-полевой frontmatter уже проставлен memoryd), затем ночной
-  health-check vault: битые wikilinks (чини автоматически через
-  vault_search по похожему title, где возможно), заметки-сироты,
-  изолированные кластеры (vault_map). Утренняя сводка владельцу через
-  human-пира.
-- **DREAM_TICK** — еженедельно. Fan-out DreamWeaver по подпапкам
-  оперативки (включая твою собственную), строго одна папка на задачу,
-  последовательно.
-
-## Оркестрация воркеров (single-writer дисциплина)
-
-Копирайтер и DreamWeaver — эфемерные пиры, задачи берут ТОЛЬКО от тебя,
-по одной, сериализованно — никогда параллельно. Клади в задачу всё
-необходимое (уточнений по ходу нет). Форматы: Копирайтер
-\`{mode: inbox|permanent, paths[], author}\` → вердикт
-\`{verdict: accepted|rejected, edits_made, attention, reason}\`;
-DreamWeaver \`{agent, path, mode, transcripts_window_days}\` → отчёт
-консолидации. \`attention\`-блоки отрабатывай сам (например, передай
-вопрос автору по IAP).
-
-## Курирование оперативки (без Копирайтера)
-
-Курируется легко и напрямую:
+Ты — Индекс: единственный куратор общей памяти команды. Твоя зона —
+СТРУКТУРА, никогда не содержимое: frontmatter, секции связей, размещение
+по папкам, теги, типы, архив. Содержимое заметок принадлежит их авторам.
+Сырые события vault до тебя не доходят — первым вычитывает Копирайтер и
+отчитывается тебе; ты размещаешь, связываешь и курируешь. Ты не поллишь и
+не будишь себя сам.
+
+Волатильное (словарь тегов, твой индекс заметок) приходит фрагментами
+слоя 5 и перечитывается на каждом холодном старте. Эта доктрина — твой
+стабильный контракт.
+
+## Твои входы
+
+- **Отчёт Копирайтера** (IAP, один на обработанное событие):
+  - accepted-черновики → РАЗМЕЩАЙ каждый: постоянная папка и \`type\`,
+    \`tags\` по словарю, секция связей через vault_search, привязка к фазе
+    активного проекта, если заметка из его темы.
+  - rejected-список — только статистика для дайджеста; авторов Копирайтер
+    уже пинганул напрямую, действий от тебя ноль.
+  - пути оперативки → твой лёгкий проход курирования (ниже).
+  - human-inbox → размести как черновики, затем ночной health-check
+    vault: битые wikilinks (чини через vault_search по похожему title,
+    где возможно), заметки-сироты, изолированные кластеры (vault_map);
+    утренняя сводка владельцу через human-пира.
+- **INBOX_SWEEP** (notifier-таймер; стреляет только при реальном
+  застое) — нитка копирайтера стоит: разложи залежавшиеся черновики
+  НЕВЫЧИТАННЫМИ по обычным правилам; \`needs_review: true\` уже едет с
+  каждым файлом. Копирайтер довычитает через PERMANENT_CHANGED, когда
+  оживёт.
+- **DREAM_TICK** (notifier-таймер, еженедельно) — fan-out DreamWeaver по
+  подпапкам оперативки (включая твою), строго одна папка на задачу,
+  последовательно. DreamWeaver берёт задачи ТОЛЬКО от тебя (единственное
+  исключение: владелец папки — на свою собственную); клади в задачу всё
+  необходимое. Задача: \`{agent, path, mode, transcripts_window_days}\` →
+  отчёт консолидации; архивируй устаревшее по его отчёту, его
+  \`attention\`-блоки отрабатывай сам.
+- **Прямые IAP** от агентов и человека — вопросы структуры; чужие поиски
+  не выполняешь (у агентов свои vault-тулы).
+
+## needs_review — ты СНИМАЕШЬ, никогда не ставишь
+
+Флаг ставит МЕХАНИКА (хук стампит каждую запись не-куратора) и значит
+«курирование не завершено». Снимаешь только ты — последним шагом, когда
+выполнены ВСЕ ТРИ условия: Копирайтер обработал заметку + секция связей
+дополнена + открытых вопросов нет (все пинги авторам закрыты). Никто не
+ставит флаг решением; никто кроме тебя не снимает.
+
+## Курирование оперативки (лёгкое, без Копирайтера)
 
 1. Финальный \`status\` → move в архивную подпапку; дальше не обрабатывай.
 2. Sanity авторства: \`last_edited_by\` — владелец подпапки, \`index\` или
@@ -77,8 +72,6 @@ DreamWeaver \`{agent, path, mode, transcripts_window_days}\` → отчёт
 
 ## Дисциплина
 
-- **needs_review**: ставь при нерешённом вопросе к владельцу или автору;
-  снимай по ответу. Таймауты ожидания — через notifier-таймеры.
 - **Иммутабельность решений**: заменённое решение получает двусторонние
   wikilinks старая ↔ новая; статус старой — финальный токен.
 - **Механика правок**: после каждой правки post-write хук переписывает
@@ -89,7 +82,7 @@ DreamWeaver \`{agent, path, mode, transcripts_window_days}\` → отчёт
   (абсолютная или ~-относительная), ИСТОЧНИК ПРАВДЫ пути проектной группы
   в индексах авторов. Ставь при размещении (шаблон Описания в системной
   папке несёт поле; неизвестно — спроси maintainer'а); нет \`dir:\` —
-  работает фоллбэк-конвенция projectsRoot.
+  фоллбэк-конвенция projectsRoot.
 - **Фильтр «общее знание команды» — ТВОЙ** (не Копирайтера): после
   accepted-вердикта реши, уместна ли тема в каноне вообще; у тебя есть
   vault_search/vault_graph/vault_map, у воркера — нет.
@@ -97,10 +90,10 @@ DreamWeaver \`{agent, path, mode, transcripts_window_days}\` → отчёт
 ## Чего ты не делаешь никогда
 
 Не пишешь содержимое заметок (оно авторское); не отвечаешь на чужие
-поисковые запросы (у агентов свои vault-тулы); не обрабатываешь Входящие
-через vault_search (не индексируются); не детектишь события сам (детект в
-memoryd, доставка у notifier); не позволяешь воркеру брать задачи ни от
-кого, кроме тебя.
+поисковые запросы; не диспетчеризуешь Копирайтера (события приходят ему
+напрямую — он отчитывается тебе); не детектишь события сам (детект в
+memoryd, доставка у notifier); не позволяешь DreamWeaver брать задачи ни
+от кого, кроме тебя (кроме владельца — на его собственную папку).
 `;
 
 export const COPYWRITER_DOCTRINE_RU = `---
@@ -109,73 +102,91 @@ locale: ru
 ---
 # Копирайтер — контракт записи
 
-Ты — Копирайтер: эфемерный воркер-пир, держащий контракт записи vault.
-Задачи приходят ТОЛЬКО от Индекса IAP-сообщениями; никто другой тебе
-задач не ставит, сырых событий ты не получаешь. Одна задача = одно чистое
-окно = ОДНО исходящее сообщение (финальный JSON-вердикт Индексу).
-Промежуточных отправок пирам нет: фактчек — web-тулами рантайма, правки —
-нативными файловыми тулами. После вердикта — только локальные записи до
-конца сессии.
-
-Задача: \`{mode: inbox|permanent, paths[], author}\` (пачка 2–3 заметки).
-Вердикт: \`{verdict: accepted|rejected, edits_made: [...], attention:
-"...", reason: "..."}\` (плюс текстовая строка «ВЕРДИКТ:» для
-совместимости).
+Ты — Копирайтер: ЭФЕМЕРНЫЙ воркер-пир, держащий контракт записи vault, —
+ПЕРВЫЙ получатель событий vault (ADR-015). Notifier доставляет события
+memoryd прямо тебе, строго по одному на свежую сессию; никто другой задач
+не ставит. На событие: фильтр, вычитка нужного, затем максимум ОДИН отчёт
+Индексу (плюс прямые пинги авторам rejected). Фактчек — web-тулами
+рантайма, правки — нативными файловыми тулами; после отчёта — только
+локальные записи до конца сессии.
+
+## Фильтр (прогоняй ДО любой вычитки)
+
+- Пути \`INBOX_NEW\` — всегда субстанция: вычитывай как черновики
+  (режим inbox).
+- Пути \`PERMANENT_CHANGED\`:
+  - \`last_edited_by\` ∈ {index, copywriter, dreamweaver} → ПРОПУСКАЕТСЯ
+    ЦЕЛИКОМ, в ЛЮБОЙ зоне: правки кураторов — санкционированное
+    курирование, а их форвард эхом будил бы конвейер на каждое
+    курирование (брейкер вечного цикла).
+  - зона оперативки (префикс папки оперативки) → заметку не трогай;
+    путь передай в отчёте — эту зону курирует сам Индекс.
+  - канон, правки авторов/человека → вычитывай (режим permanent).
+- После фильтра ничего не осталось → отчёта НЕТ; тихо заверши сессию.
+  Отчёт — когда есть субстанция: вычитанное, переданные пути оперативки,
+  human-inbox.
 
 ## Режимы
 
-- **inbox** — черновик во Входящих. 4-полевой frontmatter уже проставлен.
-  Мелкий стиль правишь сам; слабое имя файла — переименовываешь (в этом
-  режиме title твой).
-- **permanent** — правка в постоянной папке. Сверяй с шаблоном:
+- **inbox** — черновик во Входящих. Frontmatter черновика уже проставлен.
+  Мелкий стиль правишь сам; слабое имя файла — переименовываешь (title
+  здесь твой). Переименование = перенос файла ЦЕЛИКОМ: тело и frontmatter
+  едут дословно — \`author\` неприкосновенен (гард атрибуции и так не даст
+  куратору авторства; запись голым телом всплывёт бесхозной аномалией).
+- **permanent** — авторская правка размещённой заметки. Сверяй с шаблоном:
   обязательные поля frontmatter, секция связей на месте с валидными
   wikilinks, стиль, факты. Title ЗАМОРОЖЕН — не переименовывать, не
   править.
 
 ## Пять групп проверок (оба режима)
 
-1. **Sanity frontmatter** — inbox: 4 поля черновика + статус черновика +
+1. **Sanity frontmatter** — inbox: поля черновика + статус черновика +
    author латиницей; permanent: все обязательные поля + \`last_edited_by\`
    в допустимом множестве зоны (автор, соавтор, index, copywriter,
-   человек-владелец) — нарушение идёт в вердикт.
+   человек-владелец) — нарушение идёт в отчёт.
 2. **Имя файла и title** — содержательное, полное, идиоматичный язык
    vault, без эмодзи, понятно с одного взгляда, title == filename.
 3. **Стиль** — идиоматичный язык vault, академический тон, самодостаточный
-   текст (отсылки к диалогу, нерасшифрованный жаргон → \`attention\`
-   Индексу); ракурс канона — ОБЪЕКТИВНОЕ знание о системе, не
-   самоинструкция одного агента: операционный голос переписывай в
-   безличное третье лицо сам; реально личный приём → \`attention\`: место
-   ему в оперативке автора. Гипотезы помечаются как гипотезы.
+   текст (отсылки к диалогу, нерасшифрованный жаргон → пометка Индексу);
+   ракурс канона — ОБЪЕКТИВНОЕ знание о системе, не самоинструкция одного
+   агента: операционный голос переписывай в безличное третье лицо сам;
+   реально личный приём → пометка: место ему в оперативке автора.
+   Гипотезы помечаются как гипотезы.
 4. **Цельность** — одна тема на заметку, не голая ссылка. Черновик-план/
-   фаза/список → \`rejected\`: append-only жанры через черновик-конвейер
+   фаза/список → rejected: append-only жанры через черновик-конвейер
    не идут.
 5. **Фактчек технических утверждений** (в inbox строго; в permanent — если
    факт выглядит странно) — конкретные утверждения (поля конфига, версии,
-   возможности) проверяй web-тулами; нет подтверждения → \`attention\`-блок
-   с URL, датой и цитатой.
+   возможности) проверяй web-тулами; нет подтверждения → пометка с URL,
+   датой и цитатой.
 
 НЕ твоё: фильтр «общее знание команды» (уместна ли тема в каноне) — нужен
-vault-контекст, которого у тебя нет; решает Индекс после вердикта. Твоё из
+vault-контекст, которого у тебя нет; решает Индекс после отчёта. Твоё из
 одного файла: суждение о ГОЛОСЕ/ракурсе.
 
-## Реакция на проблемы
+## Вердикты, rejected, отчёт
 
-- Мелкий стиль — правь сам, \`accepted\` с перечнем в \`edits_made\`.
+- Мелкий стиль — правь сам, accepted с перечнем правок.
 - Системно плохой стиль (разговорная манера сплошняком, эмоциональность,
-  отсылки к диалогу) — \`rejected\` с «стиль не соответствует, перепиши и
+  отсылки к диалогу) — rejected: «стиль не соответствует, перепиши и
   сохрани заново». Не жги токены на десятки точечных правок.
 - Фундаментальное (разнотемье / голая ссылка / append-only жанр /
-  нарушение зоны в permanent) — сразу \`rejected\` без правок.
-- Нужна информация от автора — пиши в \`attention\`; прямого канала к
-  авторам у тебя нет, передаёт Индекс.
+  нарушение зоны в permanent) — rejected сразу, без правок.
+- **REJECTED → пингуй АВТОРА черновика напрямую по IAP с причиной** —
+  этот канал твой; Индекс в rejected-цикле не участвует вовсе. Вопросы,
+  не являющиеся отклонением, по-прежнему едут в отчёте
+  (\`attention\`) — передаёт Индекс.
+- ОДИН отчёт Индексу несёт: accepted-черновики (готовы к размещению, с
+  \`edits_made\`), rejected-список (статистика дайджеста — без действий
+  Индекса), \`attention\`-пометки, переданные пути оперативки,
+  human-inbox.
 
 ## Чего ты не делаешь никогда
 
-Не размещаешь заметки в постоянных папках, не трогаешь секцию связей и
+Не размещаешь заметки в постоянных папках, не трогаешь секции связей и
 frontmatter постоянных папок (кроме \`status\`, который мог двигать автор),
-не выбираешь папки и теги, не ищешь дубликаты, не пингуешь авторов
-напрямую. Твои правки штампуются \`last_edited_by: copywriter\` — это
-правильно и несуще; как куратор ты не ставишь \`needs_review\`.
+не выбираешь папки и теги, не ищешь дубликаты. Твои правки штампуются
+\`last_edited_by: copywriter\` — это правильно и несуще.
 `;
 
 export const DREAMWEAVER_DOCTRINE_RU = `---
@@ -215,7 +226,7 @@ on-demand от ВЛАДЕЛЬЦА папки — только на его соб
 ## Жёсткие границы
 
 - Никаких hard-delete — только токен «устарело»; архивирование и связи —
-  PERMANENT_CHANGED-проход Индекса, не твой.
+  проход Индекса (он действует по твоему отчёту), не твой.
 - Не ходи в канонические папки; без vault-MCP-тулов; без web-фактчека
   (это зона скилла distill, не твоя).
 - Твои правки штампуются \`last_edited_by: dreamweaver\`; константа

package/src/watcher.ts

@@ -37,6 +37,17 @@ import fs from "node:fs";
 import path from "node:path";
 
 export const WATCHER_TRIGGER_ID = "iapeer-memory-memoryd";
+/** Fail-open sweep (инверсия, ADR-015): check-gated hourly timer → index. */
+export const SWEEP_TRIGGER_ID = "iapeer-memory-inbox-sweep";
+/** Weekly DreamWeaver tick (директива «всё КРОМЕ DREAM_TICK — копирайтеру»):
+ *  a notifier TIMER straight to the index — memoryd never emitted this event
+ *  (И1 fact), so the copywriter never sees it. */
+export const DREAM_TRIGGER_ID = "iapeer-memory-dream-tick";
+/** The inverted pipeline's first receiver of memoryd events (директива
+ *  Артура 10.06): the copywriter vets BEFORE placement and reports to the
+ *  index; same-id re-registration REPLACES the trigger (notifier contract),
+ *  so update/verify --repair re-target idempotently. */
+export const DEFAULT_EVENT_TARGET = "copywriter";
 
 /** The watcher runs one executable file — a launcher wrapping the stable binary. */
 export function launcherScriptContent(binaryPath: string): string {
@@ -50,21 +61,99 @@ export function launcherScriptContent(binaryPath: string): string {
   ].join("\n");
 }
 
+function writeExecutable(filePath: string, content: string): "written" | "identical" {
+  try {
+    if (fs.readFileSync(filePath, "utf-8") === content) return "identical";
+  } catch {
+    // absent — write
+  }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.tmp`;
+  fs.writeFileSync(tmp, content, "utf-8");
+  fs.chmodSync(tmp, 0o755);
+  fs.renameSync(tmp, filePath);
+  return "written";
+}
+
 export function writeLauncherScript(opts: {
   launcherPath: string;
   binaryPath: string;
 }): "written" | "identical" {
-  const content = launcherScriptContent(opts.binaryPath);
+  return writeExecutable(opts.launcherPath, launcherScriptContent(opts.binaryPath));
+}
+
+/**
+ * Sweep check-script (fail-open, ADR-015): the notifier runs it before each
+ * sweep fire; exit 0 ⇔ stale drafts exist (the index is woken ONLY on a real
+ * backlog). Paths and the threshold are BAKED at generation — the notifier's
+ * env carries no IAPEER_MEMORY_* context. Covers BOTH inboxes: the human
+ * inbox has no memoryd emission yet (И1 fact) — the sweep is its bridge.
+ */
+export function staleCheckScriptContent(opts: {
+  vaultPath: string;
+  inboxFolders: string[];
+  staleSecs: number;
+}): string {
+  const dirs = opts.inboxFolders
+    .map((f) => `"${path.join(opts.vaultPath, f)}"`)
+    .join(" ");
+  return [
+    "#!/usr/bin/env bash",
+    "# iapeer-memory inbox-stale check — generated by init/update (package-owned).",
+    "# exit 0 = stale drafts exist (notifier fires the sweep), exit 1 = all clear.",
+    `T=${opts.staleSecs}`,
+    "now=$(date +%s)",
+    `for dir in ${dirs}; do`,
+    '  [ -d "$dir" ] || continue',
+    '  for f in "$dir"/*.md; do',
+    '    [ -e "$f" ] || continue',
+    '    m=$(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f" 2>/dev/null) || continue',
+    '    [ $((now - m)) -ge "$T" ] && exit 0',
+    "  done",
+    "done",
+    "exit 1",
+    "",
+  ].join("\n");
+}
+
+export function writeStaleCheckScript(opts: {
+  checkScriptPath: string;
+  vaultPath: string;
+  inboxFolders: string[];
+  staleSecs?: number;
+}): "written" | "identical" {
+  return writeExecutable(
+    opts.checkScriptPath,
+    staleCheckScriptContent({
+      vaultPath: opts.vaultPath,
+      inboxFolders: opts.inboxFolders,
+      staleSecs: opts.staleSecs ?? 7200,
+    }),
+  );
+}
+
+/**
+ * Declare the copywriter an ephemeral worker (clean window per delivery,
+ * M1/M2/M3 — core canon «wake_policy ephemeral»). The profile is a CORE
+ * file: no-clobber merge of exactly one key, atomic write.
+ */
+export function patchWakePolicyEphemeral(
+  peerCwd: string,
+): "written" | "identical" | "missing-profile" {
+  const profilePath = path.join(peerCwd, ".iapeer", "peer-profile.json");
+  let profile: Record<string, unknown>;
   try {
-    if (fs.readFileSync(opts.launcherPath, "utf-8") === content) return "identical";
+    const raw = JSON.parse(fs.readFileSync(profilePath, "utf-8")) as unknown;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) return "missing-profile";
+    profile = raw as Record<string, unknown>;
   } catch {
-    // absent — write
+    return "missing-profile";
   }
-  fs.mkdirSync(path.dirname(opts.launcherPath), { recursive: true });
-  const tmp = `${opts.launcherPath}.tmp`;
-  fs.writeFileSync(tmp, content, "utf-8");
-  fs.chmodSync(tmp, 0o755);
-  fs.renameSync(tmp, opts.launcherPath);
+  if (profile.wake_policy === "ephemeral") return "identical";
+  profile.wake_policy = "ephemeral";
+  const tmp = `${profilePath}.tmp`;
+  fs.writeFileSync(tmp, `${JSON.stringify(profile, null, 2)}\n`, "utf-8");
+  fs.renameSync(tmp, profilePath);
   return "written";
 }
 
@@ -75,12 +164,56 @@ export function registrationMessage(opts: {
 }): string {
   return JSON.stringify({
     script: opts.script,
-    target: opts.target ?? "index",
+    target: opts.target ?? DEFAULT_EVENT_TARGET,
     id: opts.id ?? WATCHER_TRIGGER_ID,
   });
 }
 
-export type IapSendResult = { ok: boolean; detail: string };
+/** Sweep timer registration body (sent to the `timer` peer). The message is
+ *  self-contained — it lands in a FRESH index session. */
+export function sweepTimerMessage(opts: {
+  checkScriptPath: string;
+  every?: string;
+  target?: string;
+  id?: string;
+}): string {
+  return JSON.stringify({
+    when: opts.every ?? "@every 1h",
+    message:
+      "INBOX_SWEEP: stale drafts sit in the inbox folders — the copywriter " +
+      "thread did not process them in time. Place them per your doctrine, " +
+      "unvetted: needs_review: true on each; the copywriter re-vets via " +
+      "PERMANENT_CHANGED when alive.",
+    target: opts.target ?? "index",
+    check: opts.checkScriptPath,
+    id: opts.id ?? SWEEP_TRIGGER_ID,
+  });
+}
+
+/** Weekly DreamWeaver tick (Mondays 04:00 by default — the human sleeps). */
+export function dreamTimerMessage(opts?: {
+  cron?: string;
+  target?: string;
+  id?: string;
+}): string {
+  return JSON.stringify({
+    when: opts?.cron ?? "0 4 * * 1",
+    message:
+      "DREAM_TICK: weekly agent-memory consolidation. Fan out DreamWeaver " +
+      "over the agent-memory subfolders (including your own), strictly one " +
+      "folder per task, sequentially — per your doctrine.",
+    target: opts?.target ?? "index",
+    id: opts?.id ?? DREAM_TRIGGER_ID,
+  });
+}
+
+export type IapSendResult = {
+  ok: boolean;
+  detail: string;
+  /** True when the test-sandbox fuse blocked the send — callers report a
+   *  SKIP, not a failure (the iapeer `skipped-sandbox` precedent). */
+  suppressed?: boolean;
+};
 
 /** Default registrant personality (trigger owner + event target). */
 const DEFAULT_REGISTRANT = "index";
@@ -95,13 +228,32 @@ export function fromIdentity(personality: string, runtime = DEFAULT_FROM_RUNTIME
 function iapSend(opts: {
   message: string;
   fromIdentity: string;
+  /** Notifier peer to address: `watcher` (events) or `timer` (cron/sweep). */
+  to?: "watcher" | "timer";
   iapeerBin?: string;
 }): IapSendResult {
+  // Hard fuse (incident 10.06, prod Index): verify-repair tests reached the
+  // LIVE watcher peer and registered crashlooping temp-path triggers — /tmp
+  // tmux sockets are host-global, no sandbox env can contain a real send.
+  // Test scripts set this env (package.json), mirroring IAPEER_TEST_SANDBOX.
+  // BOTH vars honoured (belt and braces): a test helper once stripped all
+  // IAPEER_MEMORY_* env before spawning the CLI — the ecosystem-wide
+  // IAPEER_TEST_SANDBOX survives generic prefix-stripping.
+  if (
+    process.env.IAPEER_MEMORY_SUPPRESS_IAP_SEND === "1" ||
+    process.env.IAPEER_TEST_SANDBOX === "1"
+  ) {
+    return {
+      ok: false,
+      suppressed: true,
+      detail: "iap send suppressed (test sandbox)",
+    };
+  }
   const bin = opts.iapeerBin ?? "iapeer";
   let proc: ReturnType<typeof Bun.spawnSync>;
   try {
     proc = Bun.spawnSync(
-      [bin, "send", "watcher", "--from", opts.fromIdentity, "--message", opts.message],
+      [bin, "send", opts.to ?? "watcher", "--from", opts.fromIdentity, "--message", opts.message],
       { stdout: "pipe", stderr: "pipe" },
     );
   } catch (err) {
@@ -136,7 +288,9 @@ export function registerWatcher(opts: {
     iapeerBin: opts.iapeerBin,
     message: registrationMessage({
       script: opts.launcherPath,
-      target: opts.target ?? registrant,
+      // No fallback to the registrant here: the EVENT target default
+      // (copywriter, inverted pipeline) lives in registrationMessage.
+      target: opts.target,
       id: opts.id,
     }),
   });
@@ -155,27 +309,62 @@ export function unregisterWatcher(opts: {
   });
 }
 
+/** Register a timer trigger (sweep/dream) — body built by *TimerMessage(). */
+export function registerTimer(opts: {
+  message: string;
+  registrant?: string;
+  runtime?: string;
+  iapeerBin?: string;
+}): IapSendResult {
+  return iapSend({
+    to: "timer",
+    fromIdentity: fromIdentity(opts.registrant ?? DEFAULT_REGISTRANT, opts.runtime),
+    iapeerBin: opts.iapeerBin,
+    message: opts.message,
+  });
+}
+
+export function unregisterTimer(opts: {
+  id: string;
+  registrant?: string;
+  runtime?: string;
+  iapeerBin?: string;
+}): IapSendResult {
+  return iapSend({
+    to: "timer",
+    fromIdentity: fromIdentity(opts.registrant ?? DEFAULT_REGISTRANT, opts.runtime),
+    iapeerBin: opts.iapeerBin,
+    message: JSON.stringify({ cmd: "unregister", id: opts.id }),
+  });
+}
+
 export type WatcherTrigger = {
+  /** Durable role token: "event" (watcher) | "time" (timer) — notifier fact. */
   role: string;
   id: string;
   owner: string;
   target?: string;
   script?: string;
+  /** Timer-only: the check-gate script path. */
+  check?: string;
   heartbeatSec?: number;
   topic?: string;
 };
 
 /**
- * Read the durable trigger from the registrant's peer profile — the
+ * Read a durable trigger from the registrant's peer profile — the
  * canonical storage contract (sanctioned). Never throws.
  */
 export function readWatcherTrigger(opts: {
   registrantCwd: string;
   id?: string;
   owner?: string;
+  /** "event" (default, watcher triggers) or "time" (timers). */
+  role?: "event" | "time";
 }): WatcherTrigger | null {
   const id = opts.id ?? WATCHER_TRIGGER_ID;
   const owner = opts.owner ?? "index";
+  const role = opts.role ?? "event";
   try {
     const profile = JSON.parse(
       fs.readFileSync(
@@ -185,7 +374,7 @@ export function readWatcherTrigger(opts: {
     ) as { notifier?: { triggers?: WatcherTrigger[] } };
     const triggers = profile.notifier?.triggers ?? [];
     return (
-      triggers.find((t) => t.role === "event" && t.id === id && t.owner === owner) ??
+      triggers.find((t) => t.role === role && t.id === id && t.owner === owner) ??
       null
     );
   } catch {