@agfpd/iapeer-memory 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agfpd/iapeer-memory",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "iapeer-memory — peer memory for the iapeer ecosystem: vault, memoryd (index/search/MCP-http), layer-5 context fragments, role doctrines. The package IS the system; the claude/codex plugins are thin session sockets (docs/10-distribution.md, ADR-009).",
   "license": "MIT",
   "type": "module",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agfpd/iapeer-memory-core": "0.2.3"
+    "@agfpd/iapeer-memory-core": "0.2.4"
   },
   "devDependencies": {
     "@types/bun": "^1.2.0",

package/src/cli.ts

@@ -24,6 +24,7 @@ import { cmdInit } from "./commands/init.js";
 import { cmdInstallBinary } from "./commands/install-binary.js";
 import { cmdMemoryd } from "./commands/memoryd.js";
 import { cmdMigrate } from "./commands/migrate.js";
+import { cmdDreamPaths } from "./commands/dream-paths.js";
 import { cmdProvisionPeer, cmdUnprovisionPeer } from "./commands/provision-peer.js";
 import { cmdRender } from "./commands/render.js";
 import { cmdStatus } from "./commands/status.js";
@@ -61,6 +62,10 @@ Commands:
   fm-update [ops] FILE...   structural frontmatter edits + attribution stamp
   migrate --source DIR      move harness auto-memory into the vault
                             (dry-run by default; --apply to execute)
+  dream-paths               tick-time DreamWeaver fan-out resolution: agent
+                            memory folders + transcript globs per runtime
+                            from the LIVE registry (the Index shells this on
+                            DREAM_TICK; read-only)
   render index|fragment|doctrine|guide
                             render one artifact explicitly (memoryd does this
                             continuously; render is the manual/scripted path)
@@ -125,6 +130,8 @@ export async function main(argv: string[]): Promise<number> {
       return cmdUpdate(rest, egress);
     case "install-binary":
       return cmdInstallBinary(rest, egress);
+    case "dream-paths":
+      return cmdDreamPaths(rest, egress);
     case "provision-peer":
       return cmdProvisionPeer(rest, egress);
     case "unprovision-peer":

package/src/commands/dream-paths.ts

@@ -0,0 +1,153 @@
+/**
+ * `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;
+}

package/src/fleet.ts

@@ -70,65 +70,72 @@ export function readFleetMap(fleetMapPath: string): FleetPeer[] | null {
   }
 }
 
-export function writeFleetMap(
+/** Live-registry query — the ONE place `iapeer list --json` is parsed.
+ *  Shared by writeFleetMap (the persisted map) and dream-paths (the
+ *  tick-time resolution; freshness fact: birth does NOT touch fleet.json
+ *  and the SessionStart kick is heartbeat-gated, so the LIVE registry is
+ *  the only source that sees a newborn before the next update). */
+export function queryRegistry(
   egress: Egress,
-  opts: {
-    fleetMapPath: string;
-    iapeerBin?: string;
-    /** Injectable for tests. */
-    nowIso?: string;
-  },
-): FleetMapResult {
+  opts: { iapeerBin?: string },
+): { peers: FleetPeer[] } | { error: string } {
   const bin = opts.iapeerBin ?? IAPEER_BIN;
   const proc = egress.spawnSync([bin, "list", "--json"], {
     explicitBin: opts.iapeerBin !== undefined,
   });
   if (proc.refused) {
-    return {
-      action: "failed",
-      count: 0,
-      detail: "live-registry query suppressed (test sandbox) — pass a fake iapeerBin",
-    };
+    return { error: "live-registry query suppressed (test sandbox) — pass a fake iapeerBin" };
   }
   if (proc.spawnError) {
-    return { action: "failed", count: 0, detail: `${bin} unavailable: ${proc.spawnError}` };
+    return { error: `${bin} unavailable: ${proc.spawnError}` };
   }
   if (proc.exitCode !== 0) {
-    return {
-      action: "failed",
-      count: 0,
-      detail: (proc.stderr.trim() || `iapeer list exited ${proc.exitCode}`).slice(0, 160),
-    };
+    return { error: (proc.stderr.trim() || `iapeer list exited ${proc.exitCode}`).slice(0, 160) };
   }
-  const stdout = proc.stdout;
-
   let listed: ListedPeer[];
   try {
-    const raw = JSON.parse(stdout) as unknown;
+    const raw = JSON.parse(proc.stdout) as unknown;
     listed = Array.isArray(raw) ? (raw as ListedPeer[]) : [];
   } catch {
-    return { action: "failed", count: 0, detail: "iapeer list --json: unparsable output" };
+    return { error: "iapeer list --json: unparsable output" };
   }
+  return {
+    peers: listed
+      .filter(
+        (p): p is ListedPeer & { personality: string; cwd: string } =>
+          typeof p.personality === "string" &&
+          p.personality.trim() !== "" &&
+          typeof p.cwd === "string" &&
+          p.cwd.trim() !== "",
+      )
+      .map((p) => ({
+        personality: p.personality.trim(),
+        cwd: p.cwd.trim(),
+        runtimes: [
+          ...new Set(
+            (Array.isArray(p.runtimes) ? p.runtimes : [])
+              .map((r) => (typeof r?.runtime === "string" ? r.runtime.trim() : ""))
+              .filter(Boolean),
+          ),
+        ],
+      })),
+  };
+}
 
-  const peers: FleetPeer[] = listed
-    .filter(
-      (p): p is ListedPeer & { personality: string; cwd: string } =>
-        typeof p.personality === "string" &&
-        p.personality.trim() !== "" &&
-        typeof p.cwd === "string" &&
-        p.cwd.trim() !== "",
-    )
-    .map((p) => ({
-      personality: p.personality.trim(),
-      cwd: p.cwd.trim(),
-      runtimes: [
-        ...new Set(
-          (Array.isArray(p.runtimes) ? p.runtimes : [])
-            .map((r) => (typeof r?.runtime === "string" ? r.runtime.trim() : ""))
-            .filter(Boolean),
-        ),
-      ],
-    }));
+export function writeFleetMap(
+  egress: Egress,
+  opts: {
+    fleetMapPath: string;
+    iapeerBin?: string;
+    /** Injectable for tests. */
+    nowIso?: string;
+  },
+): FleetMapResult {
+  const q = queryRegistry(egress, { iapeerBin: opts.iapeerBin });
+  if ("error" in q) {
+    return { action: "failed", count: 0, detail: q.error };
+  }
+  const peers = q.peers;
 
   const body =
     JSON.stringify(

package/src/templates/roles-en.ts

@@ -51,13 +51,17 @@ different world.
   scriber thread stalled: place the stale drafts UNVETTED by the usual
   rules; \`needs_review: true\` already travels with each file. The
   Scriber re-vets them with the next PERMANENT_BATCH once alive.
-- **DREAM_TICK** (notifier timer, weekly) — fan out DreamWeaver over the
-  agent-memory subfolders (including your own), strictly one folder per
-  task, sequentially. DreamWeaver takes tasks ONLY from you (the one
-  exception: a folder's owner may task it on their own folder); put
-  everything it needs INTO the task. Task: \`{agent, path, mode,
-  transcripts_window_days}\` → consolidation report; archive what it
-  deprecated, act on its \`attention\` blocks yourself.
+- **DREAM_TICK** (notifier timer, weekly) — run \`iapeer-memory
+  dream-paths\` (read-only; the LIVE registry at tick time) and fan out
+  DreamWeaver over the folders of its output (including your own),
+  strictly one folder per task, sequentially. DreamWeaver takes tasks ONLY
+  from you (the one exception: a folder's owner may task it on their own
+  folder). Task: \`{agent, path, mode, transcripts_window_days,
+  transcripts}\` — copy \`transcripts\` from the verb's output AS IS
+  (globs + the codex cwdFilter; path forms are the code's zone, not
+  yours). A verb error = report to the owner, never guess the fleet. On
+  the consolidation report: archive what it deprecated, act on its
+  \`attention\` blocks yourself.
 - **Direct IAP** from agents or the human — structure questions; never
   run searches for others (they have their own vault tools).
 
@@ -237,7 +241,7 @@ on-demand from a folder's OWNER for their own folder only. One task = one
 clean window = ONE outbound message (the final consolidation report to the
 task sender). Discipline: touch ONLY the folder named in the task.
 
-Task: \`{agent, path, mode, transcripts_window_days}\`.
+Task: \`{agent, path, mode, transcripts_window_days, transcripts}\`.
 
 ## The four phases
 
@@ -253,11 +257,14 @@ Task: \`{agent, path, mode, transcripts_window_days}\`.
   mentions in bodies; read the targets; on a clear mismatch (file gone,
   function renamed) write an updated note and flip the old one to the
   outdated token. LOCAL checks only.
-- **D — Transcript scan.** Read the runtime's session transcripts for the
-  window (\`transcripts_window_days\`, adapter-scoped paths; no paths/empty
-  glob → skip the phase). Find user phrases that formulate a rule with 2+
-  explicit confirmations in different sessions; check against existing
-  feedback notes; write new notes with quotes for what's missing.
+- **D — Transcript scan.** Read the session transcripts for the window
+  (\`transcripts_window_days\`) per the task's \`transcripts\`: each entry
+  is a glob; for \`runtime: codex\` the store is HOST-WIDE — take ONLY the
+  sessions whose \`session_meta.cwd\` equals the entry's \`cwdFilter\`
+  (foreign cwds are foreign memory). No entries / empty glob → skip the
+  phase. Find user phrases that formulate a rule with 2+ explicit
+  confirmations in different sessions; check against existing feedback
+  notes; write new notes with quotes for what's missing.
 
 ## Hard limits
 

package/src/templates/roles-ru.ts

@@ -44,13 +44,16 @@ locale: ru
   НЕВЫЧИТАННЫМИ по обычным правилам; \`needs_review: true\` уже едет с
   каждым файлом. Scriber довычитает их со следующей PERMANENT_BATCH,
   когда оживёт.
-- **DREAM_TICK** (notifier-таймер, еженедельно) — fan-out DreamWeaver по
-  подпапкам оперативки (включая твою), строго одна папка на задачу,
-  последовательно. DreamWeaver берёт задачи ТОЛЬКО от тебя (единственное
-  исключение: владелец папки — на свою собственную); клади в задачу всё
-  необходимое. Задача: \`{agent, path, mode, transcripts_window_days}\` →
-  отчёт консолидации; архивируй устаревшее по его отчёту, его
-  \`attention\`-блоки отрабатывай сам.
+- **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\`-блоки отрабатывай сам.
 - **Прямые IAP** от агентов и человека — вопросы структуры; чужие поиски
   не выполняешь (у агентов свои vault-тулы).
 
@@ -224,7 +227,7 @@ on-demand от ВЛАДЕЛЬЦА папки — только на его соб
 одно чистое окно = ОДНО исходящее (финальный отчёт консолидации
 постановщику). Дисциплина: трогай ТОЛЬКО папку из задачи.
 
-Задача: \`{agent, path, mode, transcripts_window_days}\`.
+Задача: \`{agent, path, mode, transcripts_window_days, transcripts}\`.
 
 ## Четыре фазы
 
@@ -239,11 +242,14 @@ on-demand от ВЛАДЕЛЬЦА папки — только на его соб
   env-переменных; прочитай цели; при явном расхождении (файла нет, функция
   переименована) — новая updated-заметка + старая в «устарело». Только
   ЛОКАЛЬНЫЕ проверки.
-- **D — Скан транскриптов.** Прочитай транскрипты сессий рантайма за окно
-  (\`transcripts_window_days\`, adapter-scoped пути; путей нет / glob пуст —
-  фаза пропускается). Найди user-фразы, формулирующие правило, с 2+ явными
-  подтверждениями в разных сессиях; сверь с существующими feedback-заметками;
-  недостающее — новой заметкой с цитатами.
+- **D — Скан транскриптов.** Прочитай транскрипты сессий за окно
+  (\`transcripts_window_days\`) по \`transcripts\` из задачи: для каждой
+  записи — glob; у \`runtime: codex\` хранилище HOST-WIDE, бери ТОЛЬКО
+  сессии, чей \`session_meta.cwd\` равен \`cwdFilter\` записи (чужие cwd —
+  чужая память). Записей нет / glob пуст — фаза пропускается. Найди
+  user-фразы, формулирующие правило, с 2+ явными подтверждениями в разных
+  сессиях; сверь с существующими feedback-заметками; недостающее — новой
+  заметкой с цитатами.
 
 ## Жёсткие границы
 

package/src/watcher.ts

@@ -201,9 +201,12 @@ export function dreamTimerMessage(opts?: {
   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.",
+      "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",
     id: opts?.id ?? DREAM_TRIGGER_ID,
   });