@agfpd/iapeer-memory 0.2.6 → 0.2.8

package/src/templates/roles-ru.ts

@@ -44,16 +44,13 @@ locale: ru
   НЕВЫЧИТАННЫМИ по обычным правилам; \`needs_review: true\` уже едет с
   каждым файлом. Scriber довычитает их со следующей PERMANENT_BATCH,
   когда оживёт.
-- **DREAM_TICK** (notifier-таймер, еженедельно) — выполни
-  \`iapeer-memory dream-paths\` (read-only; живой реестр на момент тика) и
-  fan-out DreamWeaver по папкам его вывода (включая твою), строго одна
-  папка на задачу, последовательно. DreamWeaver берёт задачи ТОЛЬКО от
-  тебя (единственное исключение: владелец папки — на свою собственную).
-  Задача: \`{agent, path, mode, transcripts_window_days, transcripts}\` —
-  \`transcripts\` перекладывай из вывода verb'а КАК ЕСТЬ (глобы + codex
-  cwdFilter; формы путей — зона кода, не твоя). Ошибка verb'а = доложи
-  владельцу, флот не угадывай. По отчёту консолидации архивируй
-  устаревшее, \`attention\`-блоки отрабатывай сам.
+- **Отчёт консолидации DreamWeaver** (еженедельно) — тик теперь
+  оркестрирует DreamWeaver (детерминированный предфильтр находит работу,
+  он фан-аутит субагентов); ты СО ВХОДА УБРАН и только ФИНАЛИЗИРУЕШЬ. По
+  его отчёту: архивируй каждую заметку, которую он пометил устаревшей
+  (move в архивную подпапку), собери секцию связей для каждой новой
+  объединяющей заметки через vault_search, \`attention\`-пункты
+  отрабатывай сам.
 - **Прямые IAP** от агентов и человека — вопросы структуры; чужие поиски
   не выполняешь (у агентов свои vault-тулы).
 
@@ -106,8 +103,8 @@ git, вопрос писателям); needs_review при этом уже ст
 Не пишешь содержимое заметок (оно авторское); не отвечаешь на чужие
 поисковые запросы; не диспетчеризуешь Scriber'а (события приходят ему
 напрямую — он отчитывается тебе); не детектишь события сам (детект в
-memoryd, доставка у notifier); не позволяешь DreamWeaver брать задачи ни
-от кого, кроме тебя (кроме владельца — на его собственную папку).
+memoryd, доставка у notifier); не оркестрируешь dream-тик (теперь им
+владеет DreamWeaver целиком — ты только финализируешь по его отчёту).
 `;
 
 export const SCRIBER_DOCTRINE_RU = `---
@@ -219,45 +216,77 @@ locale: ru
 ---
 # DreamWeaver — sleep-cycle консолидация оперативки
 
-Ты — DreamWeaver: эфемерный воркер-пир, инструмент еженедельной гигиены
-оперативки. Корень vault на этом хосте: \`{{VAULT_PATH}}\` (не
-угадывать). Задачи приходят IAP-сообщениями: еженедельный fan-out от
-Индекса (одна задача = одна подпапка, включая папку самого Индекса) либо
-on-demand от ВЛАДЕЛЬЦА папки — только на его собственную. Одна задача =
-одно чистое окно = ОДНО исходящее (финальный отчёт консолидации
-постановщику). Дисциплина: трогай ТОЛЬКО папку из задачи.
-
-Задача: \`{agent, path, mode, transcripts_window_days, transcripts}\`.
+Ты — DreamWeaver: эфемерный воркер-пир, который ОРКЕСТРИРУЕТ еженедельный
+тик гигиены оперативки. Корень vault на этом хосте: \`{{VAULT_PATH}}\` (не
+угадывать — протухшая копия в другом месте диска это другой мир).
+Детерминированный предфильтр уже нашёл работу; ты превращаешь его вывод в
+задачи субагентам и отчитываешься один раз. notifier доставляет тебе
+DREAM_TICK еженедельно и только на неделю с работой (гейт отсеивает
+мёртвые недели) — никто другой тебя не задачит.
+
+## Прогон тика
+
+1. Выполни \`iapeer-memory dream-collect\` (Bash, read-only). Возвращает
+   JSON: \`{vault, windowDays, tasks[], skipped[]}\`. Задача —
+   \`{kind, folders[]}\`; каждая папка несёт \`{agent, path,
+   newNotes:[{path, flags}], transcripts:[{runtime, files}]}\`. Задача
+   \`folder\` = одна загруженная папка одному субагенту; \`grouped\` =
+   несколько мелких папок одному субагенту. Предфильтр уже отбросил
+   неактивные папки, поэтому ты спавнишь ТОЛЬКО там, где реальная работа.
+2. Строка ошибки verb'а = доложи человеку-владельцу и стоп; флот не
+   угадывай. Пустой \`tasks\` = чистая неделя — заверши через \`iapeer
+   self-done\` (не-будящий финиш), без отчёта.
+3. Фан-аут одного субагента на задачу — механизмом субагентов твоего
+   рантайма (как бы он там ни назывался). Параллельно, если рантайм
+   позволяет, иначе последовательно.
+4. Собери результаты субагентов в ОДИН отчёт консолидации Индексу:
+   заметки, помеченные устаревшими (на архивацию), новые объединяющие
+   заметки (на связывание), \`attention\`-пункты. Индекс финализирует —
+   архивация и секция связей это его проход, не твой.
+
+Твоё окно — один чистый цикл = ОДНО исходящее (отчёт Индексу либо
+\`self-done\` на пустой неделе).
+
+## Задача субагенту
+
+Субагент видит ТОЛЬКО задачу, которую ты пишешь — делай её
+самодостаточной. Перенеси КАК ЕСТЬ из вывода verb'а: путь(и) папки,
+\`newNotes\` с их флагами, файлы \`transcripts\`, корень vault. Сформулируй
+цель, четыре фазы-суждения, границы и форму отчёта (ниже). Субагент СУДИТ
+присланный материал; он не переоткрывает (скрипт уже сделал поиск —
+субагент, заново сканирующий папку, обнуляет весь смысл).
+
+- **A — Dedup.** Сгруппируй присланные \`newNotes\` про одну тему. Соседние
+  заметки папки читай для КОНТЕКСТА — включая те, что вне окна — чтобы
+  свежая заметка слилась со старым близнецом; ПРАВЬ только заметки в окне
+  (остальные уже устоялись). Для группы 2+: одна объединяющая заметка
+  (содержательный filename на языке vault, \`subtype\` + \`description\` +
+  тело с inline \`[[имя старой]]\`) + статус каждой объединённой — токен
+  «устарело».
+- **B — Compress description.** Заметке с флагом \`long-desc\`: ужми
+  \`description\` до 1–2 предложений (~150 символов), тело не трогай.
+- **C — Сверка помеченных ссылок.** Заметке с флагом \`broken-ref\`: скрипт
+  уже нашёл подозрительный путь/env — прочитай цель, при явном расхождении
+  (файла нет, переменная не задана, функция переименована) — новая
+  updated-заметка + старая в «устарело». Только локальные проверки.
+- **D — Выцеп правил из транскриптов.** Прочитай присланные
+  \`transcripts.files\` (конкретные пути — без globbing). Найди user-фразы,
+  формулирующие правило, с 2+ явными подтверждениями в разных сессиях;
+  сверь с существующими feedback-заметками; недостающее — заметкой с
+  цитатами. Файлов нет — фазу пропусти.
+
+Границы каждого субагента: трогай только папку(и) из задачи и только
+заметки в окне; в канонические папки не ходи; никаких hard-delete (только
+токен «устарело», ведь архивирование и связи — проход Индекса); без
+vault-MCP-тулов и без web-фактчека (зона скилла distill). Правки штампуются
+\`last_edited_by: dreamweaver\`, константа \`author\` парсится из пути
+подпапки — запись в папку владельца ПО ЗАДАЧЕ сохраняет его атрибуцию. Так
+задумано.
 
-## Четыре фазы
+## Чего ты не делаешь никогда
 
-- **A — Dedup.** Прочитай заметки папки; сгруппируй те, что про одну тему
-  (LLM-суждение). Для группы 2+: одна объединяющая заметка (содержательный
-  filename на языке vault, \`subtype\` + \`description\` + тело с inline
-  \`[[имя старой А]]\`, \`[[имя старой Б]]\`) + статус каждой старой — токен
-  «устарело».
-- **B — Compress description.** \`description\` длиннее ~250 символов —
-  ужми до 1–2 предложений (~150). Тело в этой фазе не трогай.
-- **C — Локальный фактчек.** Найди в телах упоминания файловых путей и
-  env-переменных; прочитай цели; при явном расхождении (файла нет, функция
-  переименована) — новая updated-заметка + старая в «устарело». Только
-  ЛОКАЛЬНЫЕ проверки.
-- **D — Скан транскриптов.** Прочитай транскрипты сессий за окно
-  (\`transcripts_window_days\`) по \`transcripts\` из задачи: для каждой
-  записи — glob; у \`runtime: codex\` хранилище HOST-WIDE, бери ТОЛЬКО
-  сессии, чей \`session_meta.cwd\` равен \`cwdFilter\` записи (чужие cwd —
-  чужая память). Записей нет / glob пуст — фаза пропускается. Найди
-  user-фразы, формулирующие правило, с 2+ явными подтверждениями в разных
-  сессиях; сверь с существующими feedback-заметками; недостающее — новой
-  заметкой с цитатами.
-
-## Жёсткие границы
-
-- Никаких hard-delete — только токен «устарело»; архивирование и связи —
-  проход Индекса (он действует по твоему отчёту), не твой.
-- Не ходи в канонические папки; без vault-MCP-тулов; без web-фактчека
-  (это зона скилла distill, не твоя).
-- Твои правки штампуются \`last_edited_by: dreamweaver\`; константа
-  \`author\` парсится из пути подпапки — запись в чужую подпапку ПО ЗАДАЧЕ
-  сохраняет атрибуцию владельца. Так задумано.
+Никогда не обнаруживаешь работу сам (это делает предфильтр) и не пишешь
+суть заметки (она авторская). Действуешь через субагентов и отчитываешься
+Индексу; не архивируешь и не ставишь связи — это финализирующий проход
+Индекса.
 `;

package/src/templates/skills.ts

@@ -1,7 +1,8 @@
 /**
  * Embedded skill files — the DIRECT-surface form of the four session skills
  * (ADR-009 v1.2: direct per-peer surfaces instead of the plugin socket).
- * Bodies are the boris-accepted plugin skills (adapters/claude/skills, spot-
+ * Bodies are the boris-accepted plugin-era skills (historical provenance:
+ * adapters/claude/skills, removed with the plugin channel — ADR-017; spot-
  * checked against the live CLI 10.06) with exactly two deltas:
  *
  *   1. names are namespaced `iapeer-memory-*` (boris design input: direct

package/src/watcher.ts

@@ -41,10 +41,14 @@ import { guardedWriteFileSync } from "@agfpd/iapeer-memory-core";
 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 scriber never sees it. */
+/** Weekly DreamWeaver tick. A notifier TIMER straight to DreamWeaver, GATED
+ *  by a check-script that runs the deterministic pre-filter (`dream-collect
+ *  --gate`): a dead week never wakes anyone (Фаза «детерминированный
+ *  предфильтр», 15.06). The Index is OFF the entry — it only finalises on
+ *  DreamWeaver's consolidation report. */
 export const DREAM_TRIGGER_ID = "iapeer-memory-dream-tick";
+/** Default target of the weekly tick — the orchestrator (was `index`). */
+export const DREAM_TARGET = "dreamweaver";
 /** The inverted pipeline's first receiver of memoryd events (директива
  *  Артура 10.06): the scriber vets BEFORE placement and reports to the
  *  index; same-id re-registration REPLACES the trigger (notifier contract),
@@ -134,6 +138,32 @@ export function writeStaleCheckScript(opts: {
   );
 }
 
+/**
+ * Dream-tick gate check-script (notifier `check` for the weekly timer): shells
+ * the stable binary's REGISTRY-FREE gate. exit 0 ⇔ an in-window agent-memory
+ * note exists (the notifier fires the tick), exit 1 ⇔ a dead week (nobody is
+ * woken — true zero-LLM). It calls the binary (not baked bash) because the
+ * gate reads the vault path from config.env, which the binary loads itself;
+ * the notifier's env carries no IAPEER_MEMORY_* context.
+ */
+export function dreamGateScriptContent(binaryPath: string): string {
+  return [
+    "#!/usr/bin/env bash",
+    "# iapeer-memory dream-tick gate — the notifier check for the weekly timer.",
+    "# Generated by init; re-generated by verify --repair. exit 0 = work exists",
+    "# (fire the tick), exit 1 = dead week (DreamWeaver is never woken).",
+    `exec "${binaryPath}" dream-collect --gate`,
+    "",
+  ].join("\n");
+}
+
+export function writeDreamGateScript(opts: {
+  dreamGateScriptPath: string;
+  binaryPath: string;
+}): "written" | "identical" {
+  return writeExecutable(opts.dreamGateScriptPath, dreamGateScriptContent(opts.binaryPath));
+}
+
 /**
  * Declare the scriber an ephemeral worker (clean window per delivery,
  * M1/M2/M3 — core canon «wake_policy ephemeral»). The profile is a CORE
@@ -192,24 +222,36 @@ export function sweepTimerMessage(opts: {
   });
 }
 
-/** Weekly DreamWeaver tick (Mondays 04:00 by default — the human sleeps). */
+/** Weekly DreamWeaver tick (Mondays 04:00 by default — the human sleeps).
+ *  Targets the ORCHESTRATOR (DreamWeaver), GATED by the deterministic
+ *  pre-filter (`check`): the message only lands on a week with real work. */
 export function dreamTimerMessage(opts?: {
   cron?: string;
   target?: string;
   id?: string;
+  dreamGateScriptPath?: string;
 }): string {
-  return JSON.stringify({
-    when: opts?.cron ?? "0 4 * * 1",
+  const body: {
+    when: string;
+    message: string;
+    target: string;
+    id: string;
+    check?: string;
+  } = {
+    when: opts?.cron || "0 4 * * 1",
     message:
-      "DREAM_TICK: weekly agent-memory consolidation. Run `iapeer-memory " +
-      "dream-paths` (read-only) and fan out DreamWeaver over its folders — " +
-      "strictly one folder per task, sequentially, carrying that folder's " +
-      "`transcripts` (globs + codex cwdFilter) into the task — per your " +
-      "doctrine. The verb resolves the LIVE registry at tick time; an error " +
-      "line from it = report, do not guess the fleet.",
-    target: opts?.target ?? "index",
+      "DREAM_TICK: weekly agent-memory consolidation — you orchestrate. Run " +
+      "`iapeer-memory dream-collect` (read-only; the deterministic pre-filter " +
+      "already found the work) and fan out one subagent per task in its " +
+      "`tasks` — per your doctrine: each subagent only JUDGES the supplied " +
+      "candidates and transcript files (it never discovers), touching only " +
+      "in-window notes. Collect the subagents' results into ONE consolidation " +
+      "report to the Index. A verb error = report it, do not guess the fleet.",
+    target: opts?.target || DREAM_TARGET,
     id: opts?.id ?? DREAM_TRIGGER_ID,
-  });
+  };
+  if (opts?.dreamGateScriptPath) body.check = opts.dreamGateScriptPath;
+  return JSON.stringify(body);
 }
 
 export type IapSendResult = {

package/src/commands/dream-paths.ts

@@ -1,153 +0,0 @@
-/**
- * `iapeer-memory dream-paths [--iapeer-bin P]` — tick-time resolution of the
- * DreamWeaver fan-out (P5 §4.3, boris-accepted form (б) + source (1)).
- *
- * The weekly DREAM_TICK lands in a FRESH index session; the Index shells
- * THIS verb and fans DreamWeaver out over its output — one agent-memory
- * subfolder per task, transcript globs riding along. Resolution happens AT
- * THE TICK, never baked into the timer registration: a baked snapshot
- * re-creates the «фаза D мертва, glob-skip маскирует» class one layer down.
- *
- * SOURCE = the LIVE registry (`iapeer list --json`), not fleet.json — the
- * freshness proof (facts, 11.06): birth-provision does NOT touch fleet.json
- * (writeFleetMap call sites: init/update/verify --repair only) and the
- * SessionStart kick is heartbeat-gated (silent on a healthy host), so a
- * peer born after the last update is INVISIBLE to fleet.json for weeks —
- * the live registry is the only source that sees it. Read-as-egress: a
- * legitimate live channel of the prod CLI (the refusing test handle blocks
- * it; hermetic tests pass --iapeer-bin).
- *
- * READ-ONLY by contract: one registry list spawn + vault readdir +
- * realpath. No writes, no signals, no detached spawns.
- *
- * Transcript path forms (host facts):
- *   claude — `~/.claude/projects/<slug(cwd)>/*.jsonl`; slug = every
- *     non-alphanumeric of the REGISTRY cwd → '-' (live form:
- *     /Users/macmini/.iapeer/peers/index → -Users-macmini--iapeer-peers-index;
- *     the registry cwd verbatim, NOT realpath — claude slugs the path the
- *     session launched in);
- *   codex — `~/.codex/sessions/**\/rollout-*.jsonl` (HOST-WIDE pool) +
- *     `cwdFilter` = realpath(cwd): the worker matches the payload's
- *     session_meta.cwd — the iapeer-contract realpath rule.
- *
- * Folders without a live peer get `transcripts: []` — phase D skips them
- * honestly (A–C still run); peers without a memory subfolder are not in
- * the fan-out (nothing to consolidate).
- */
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { getTaxonomy, isLocaleId } from "@agfpd/iapeer-memory-core";
-import type { Egress } from "../egress.js";
-import { queryRegistry, type FleetPeer } from "../fleet.js";
-
-/** Claude projects-dir slug — the live disk form (ls ~/.claude/projects). */
-export function claudeProjectSlug(cwd: string): string {
-  return cwd.replace(/[^A-Za-z0-9]/g, "-");
-}
-
-export type TranscriptSpec = {
-  runtime: "claude" | "codex";
-  glob: string;
-  /** codex only: the worker filters the HOST-WIDE pool by the payload's
-   *  session_meta.cwd against this realpath (iapeer contract). */
-  cwdFilter?: string;
-};
-
-export function transcriptSpecs(peer: FleetPeer, home: string): TranscriptSpec[] {
-  const specs: TranscriptSpec[] = [];
-  if (peer.runtimes.includes("claude")) {
-    specs.push({
-      runtime: "claude",
-      glob: path.join(home, ".claude", "projects", claudeProjectSlug(peer.cwd), "*.jsonl"),
-    });
-  }
-  if (peer.runtimes.includes("codex")) {
-    let real = peer.cwd;
-    try {
-      real = fs.realpathSync(peer.cwd);
-    } catch {
-      // vanished cwd — keep the registry form; the filter simply matches nothing
-    }
-    specs.push({
-      runtime: "codex",
-      glob: path.join(home, ".codex", "sessions", "**", "rollout-*.jsonl"),
-      cwdFilter: real,
-    });
-  }
-  return specs;
-}
-
-export type DreamFolder = {
-  agent: string;
-  path: string;
-  transcripts: TranscriptSpec[];
-};
-
-export function buildDreamPaths(opts: {
-  vault: string;
-  agentMemoryFolder: string;
-  peers: FleetPeer[];
-  home: string;
-}): DreamFolder[] {
-  const memoryRoot = path.join(opts.vault, opts.agentMemoryFolder);
-  let entries: fs.Dirent[];
-  try {
-    entries = fs.readdirSync(memoryRoot, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  const byPersonality = new Map(opts.peers.map((p) => [p.personality, p]));
-  return entries
-    .filter((e) => e.isDirectory() && !e.name.startsWith("."))
-    .sort((a, b) => a.name.localeCompare(b.name))
-    .map((e) => {
-      const peer = byPersonality.get(e.name);
-      return {
-        agent: e.name,
-        path: path.join(memoryRoot, e.name),
-        transcripts: peer ? transcriptSpecs(peer, opts.home) : [],
-      };
-    });
-}
-
-export function cmdDreamPaths(argv: string[], egress: Egress): number {
-  let iapeerBin: string | undefined;
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--iapeer-bin") iapeerBin = argv[++i];
-    else {
-      console.error(`iapeer-memory dream-paths: unknown flag: ${a}`);
-      return 2;
-    }
-  }
-
-  const vault = process.env.IAPEER_MEMORY_VAULT_PATH ?? "";
-  if (!vault) {
-    console.error("iapeer-memory dream-paths: IAPEER_MEMORY_VAULT_PATH is not set — not provisioned");
-    return 1;
-  }
-  const localeRaw = process.env.IAPEER_MEMORY_LOCALE || "en";
-  if (!isLocaleId(localeRaw)) {
-    console.error(`iapeer-memory dream-paths: unknown locale "${localeRaw}"`);
-    return 1;
-  }
-
-  const q = queryRegistry(egress, { iapeerBin });
-  if ("error" in q) {
-    // LOUD: a silent empty fan-out would re-create the masked-dead-phase
-    // class — the Index sees this line and reports instead of guessing.
-    console.error(`iapeer-memory dream-paths: live registry unavailable — ${q.error}`);
-    return 1;
-  }
-
-  const folders = buildDreamPaths({
-    vault,
-    agentMemoryFolder: getTaxonomy(localeRaw).folders.agentMemory,
-    peers: q.peers,
-    home: os.homedir(),
-  });
-  console.log(JSON.stringify({ vault, folders }, null, 2));
-  return 0;
-}