@agfpd/iapeer-memory 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agfpd/iapeer-memory",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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.1.6"
+    "@agfpd/iapeer-memory-core": "0.1.8"
   },
   "devDependencies": {
     "@types/bun": "^1.2.0",

package/src/commands/init.ts

@@ -318,7 +318,7 @@ export async function cmdInit(argv: string[]): Promise<number> {
         continue;
       }
       const template = roleTemplatePath(paths.templatesDir, locale, role);
-      const rendered = renderDoctrine({ templatePath: template, peerCwd, version });
+      const rendered = renderDoctrine({ templatePath: template, peerCwd, version, vaultPath: vault });
       if (rendered.action === "missing-template") {
         rolesOk = false;
         console.log(`      roles       ${role}: template missing at ${template}`);

package/src/commands/status.ts

@@ -9,6 +9,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import {
+  ensureLoopbackNotProxied,
   getTaxonomy,
   isLocaleId,
   prepareSqliteRuntime,
@@ -50,6 +51,7 @@ export function searchPipelineLine(env: Record<string, string | undefined>): str
 /** Live pipeline from the running memoryd — the same per-component statuses
  * every vault_search returns. Null when memoryd is unreachable. */
 export async function probeSearchPipeline(port: number): Promise<string | null> {
+  ensureLoopbackNotProxied(); // fleet-class: proxy-env lies about live loopback ports
   try {
     const res = await fetch(`http://127.0.0.1:${port}/mcp`, {
       method: "POST",
@@ -84,6 +86,7 @@ export async function probeSearchPipeline(port: number): Promise<string | null>
 }
 
 async function probeMcp(port: number): Promise<{ line: string; alive: boolean }> {
+  ensureLoopbackNotProxied(); // fleet-class: proxy-env lies about live loopback ports
   try {
     const res = await fetch(`http://127.0.0.1:${port}/mcp`, {
       method: "POST",

package/src/commands/update.ts

@@ -93,14 +93,21 @@ export function cmdUpdate(argv: string[]): number {
   const tmpl = materialiseTemplates({ templatesDir: paths.templatesDir, locale });
   step("templates", `${tmpl.written.length} written, ${tmpl.identical.length} identical`);
 
-  // 3. role doctrines (version marker follows the package — ADR-010)
+  // 3. role doctrines (version marker follows the package — ADR-010).
+  // vaultPath feeds the {{VAULT_PATH}} doctrine substitution (host fact).
+  let vaultPathForDoctrines: string | undefined;
+  try {
+    vaultPathForDoctrines = configFromEnv().vaultPath;
+  } catch {
+    vaultPathForDoctrines = undefined; // unprovisioned env — placeholder fallback
+  }
   const manifest = readRolesManifest(paths.rolesManifestPath);
   if (!manifest || manifest.roles.length === 0) {
     step("doctrines", "no roles manifest — init has not run (nothing to re-render)");
   } else {
     const outcomes = manifest.roles.map((r) => ({
       role: r.role,
-      ...renderDoctrine({ templatePath: r.template, peerCwd: r.peerCwd, version }),
+      ...renderDoctrine({ templatePath: r.template, peerCwd: r.peerCwd, version, vaultPath: vaultPathForDoctrines }),
     }));
     const missing = outcomes.filter((o) => o.action === "missing-template");
     step(

package/src/commands/verify.ts

@@ -74,9 +74,11 @@ export function runVerify(opts: VerifyOptions = {}): CheckResult[] {
 
   // 1. config / env context
   let configOk = false;
+  let vaultPathForDoctrines: string | undefined;
   try {
     const config = configFromEnv();
     configOk = true;
+    vaultPathForDoctrines = config.vaultPath;
     results.push({
       name: "config",
       status: "ok",
@@ -333,6 +335,7 @@ export function runVerify(opts: VerifyOptions = {}): CheckResult[] {
         templatePath: entry.template,
         peerCwd: entry.peerCwd,
         version,
+        vaultPath: vaultPathForDoctrines,
       });
       if (outcome.action === "missing-template") {
         results.push({

package/src/templates/roles-en.ts

@@ -29,9 +29,14 @@ Volatile context (the tags dictionary, your own author index) arrives via
 layer-5 fragments and is re-read on every cold wake. This doctrine is your
 stable contract.
 
+Vault root on this host: \`{{VAULT_PATH}}\`. Event paths arrive ABSOLUTE;
+NEVER guess the vault location — a stale copy elsewhere on disk is a
+different world.
+
 ## Inputs you act on
 
-- **Scriber report** (IAP, one per processed event):
+- **Scriber report** (IAP, one per processed delivery — instant drafts,
+  the 6-hour PERMANENT_BATCH, the nightly HUMAN_INBOX_BATCH):
   - accepted drafts → PLACE each: pick the permanent folder and \`type\`,
     fill \`tags\` from the dictionary, build the links section via
     vault_search, link to an active project phase when it belongs to one.
@@ -45,7 +50,7 @@ stable contract.
 - **INBOX_SWEEP** (notifier timer; fires only on a real backlog) — the
   scriber thread stalled: place the stale drafts UNVETTED by the usual
   rules; \`needs_review: true\` already travels with each file. The
-  Scriber re-vets via PERMANENT_CHANGED once alive.
+  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
@@ -112,24 +117,28 @@ locale: en
 You are the Scriber: an EPHEMERAL worker peer enforcing the vault's
 writing contract — the FIRST receiver of vault events (ADR-015). The
 notifier delivers memoryd events straight to you, strictly one event per
-fresh session; nobody else may task you. Per event: filter, vet what needs
+fresh session; nobody else may task you. Vault root on this host:
+\`{{VAULT_PATH}}\` — event paths arrive ABSOLUTE; NEVER guess the vault
+location (a stale copy elsewhere on disk is a different world). Per event: filter, vet what needs
 vetting, then at most ONE report to the Index (plus direct pings to
 rejected authors). Fact-checking uses your runtime's web tools, edits use
 the native file tools; after the report, only local writes until the
 session ends.
 
-## The filter (run it BEFORE any vetting)
-
-- \`INBOX_NEW\` paths — always substance: vet as drafts (mode inbox).
-- \`PERMANENT_CHANGED\` paths:
-  - \`last_edited_by\` ∈ {index, scriber, dreamweaver} → SKIP ENTIRELY,
-    in ANY zone: curators' edits are sanctioned curation, and forwarding
-    them would echo every curation back as a wake (the loop breaker).
-  - agent-memory zone (the agent-memory folder prefix) → never touch the
-    note; pass the path through in the report — the Index curates that
-    zone itself.
-  - canon zones, author/human edits → vet (mode permanent).
-- Nothing left after the filter → NO report; end the session silently.
+## Inputs and cadences (директива владельца)
+
+- \`INBOX_NEW: <absolute path>\` — INSTANT, one draft: vet as a draft
+  (mode inbox).
+- \`PERMANENT_BATCH: [<absolute paths…>]\` — a JSON array, every 6 hours
+  (config): the settled canon+agent-memory edits of the window in ONE
+  delivery. Curator edits (index/scriber/dreamweaver) are ALREADY filtered
+  at the source (memoryd reads the fresh \`last_edited_by\`) — meet one
+  anyway → skip it. Per path: agent-memory zone → never touch the note,
+  pass the path through in the report (the Index curates that zone);
+  canon → vet (mode permanent).
+- \`HUMAN_INBOX_BATCH: [<absolute paths…>]\` — the human's nightly batch
+  (daily, config hour): vet as drafts.
+- Nothing left after filtering → NO report; end the session silently.
   Report when there is substance: vetted results, passed-through
   agent-memory paths, human-inbox results.
 
@@ -206,7 +215,8 @@ locale: en
 # DreamWeaver — sleep-cycle memory consolidation
 
 You are DreamWeaver: an ephemeral worker peer, the weekly hygiene
-instrument for agent memory. Tasks arrive as IAP messages: weekly fan-out
+instrument for agent memory. Vault root on this host: \`{{VAULT_PATH}}\`
+(never guess it). Tasks arrive as IAP messages: weekly fan-out
 from the Index (one task per subfolder, including the Index's own), or
 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

package/src/templates/roles-ru.ts

@@ -21,9 +21,14 @@ locale: ru
 слоя 5 и перечитывается на каждом холодном старте. Эта доктрина — твой
 стабильный контракт.
 
+Корень vault на этом хосте: \`{{VAULT_PATH}}\`. Пути в событиях приходят
+АБСОЛЮТНЫМИ; НИКОГДА не угадывай расположение vault — протухшая копия в
+другом месте диска это другой мир.
+
 ## Твои входы
 
-- **Отчёт Scriber'а** (IAP, один на обработанное событие):
+- **Отчёт Scriber'а** (IAP, один на обработанную доставку — мгновенные
+  черновики, 6-часовая PERMANENT_BATCH, ночная HUMAN_INBOX_BATCH):
   - accepted-черновики → РАЗМЕЩАЙ каждый: постоянная папка и \`type\`,
     \`tags\` по словарю, секция связей через vault_search, привязка к фазе
     активного проекта, если заметка из его темы.
@@ -37,8 +42,8 @@ locale: ru
 - **INBOX_SWEEP** (notifier-таймер; стреляет только при реальном
   застое) — нитка Scriber'а стоит: разложи залежавшиеся черновики
   НЕВЫЧИТАННЫМИ по обычным правилам; \`needs_review: true\` уже едет с
-  каждым файлом. Scriber довычитает через PERMANENT_CHANGED, когда
-  оживёт.
+  каждым файлом. Scriber довычитает их со следующей PERMANENT_BATCH,
+  когда оживёт.
 - **DREAM_TICK** (notifier-таймер, еженедельно) — fan-out DreamWeaver по
   подпапкам оперативки (включая твою), строго одна папка на задачу,
   последовательно. DreamWeaver берёт задачи ТОЛЬКО от тебя (единственное
@@ -105,23 +110,26 @@ locale: ru
 Ты — Scriber: ЭФЕМЕРНЫЙ воркер-пир, держащий контракт записи vault, —
 ПЕРВЫЙ получатель событий vault (ADR-015). Notifier доставляет события
 memoryd прямо тебе, строго по одному на свежую сессию; никто другой задач
-не ставит. На событие: фильтр, вычитка нужного, затем максимум ОДИН отчёт
+не ставит. Корень vault на этом хосте: \`{{VAULT_PATH}}\` — пути в
+событиях АБСОЛЮТНЫЕ; НИКОГДА не угадывай расположение vault (протухшая
+копия в другом месте диска — другой мир). На событие: фильтр, вычитка нужного, затем максимум ОДИН отчёт
 Индексу (плюс прямые пинги авторам rejected). Фактчек — web-тулами
 рантайма, правки — нативными файловыми тулами; после отчёта — только
 локальные записи до конца сессии.
 
-## Фильтр (прогоняй ДО любой вычитки)
-
-- Пути \`INBOX_NEW\` — всегда субстанция: вычитывай как черновики
-  (режим inbox).
-- Пути \`PERMANENT_CHANGED\`:
-  - \`last_edited_by\` ∈ {index, scriber, dreamweaver} → ПРОПУСКАЕТСЯ
-    ЦЕЛИКОМ, в ЛЮБОЙ зоне: правки кураторов — санкционированное
-    курирование, а их форвард эхом будил бы конвейер на каждое
-    курирование (брейкер вечного цикла).
-  - зона оперативки (префикс папки оперативки) → заметку не трогай;
-    путь передай в отчёте — эту зону курирует сам Индекс.
-  - канон, правки авторов/человека → вычитывай (режим permanent).
+## Входы и каденции (директива владельца)
+
+- \`INBOX_NEW: <абсолютный путь>\` — МГНОВЕННО, один черновик: вычитывай
+  как черновик (режим inbox).
+- \`PERMANENT_BATCH: [<абсолютные пути…>]\` — JSON-массив, раз в 6 часов
+  (конфиг): устаканившиеся правки канона+оперативки за окно ОДНОЙ
+  доставкой. Кураторские правки (index/scriber/dreamweaver) УЖЕ
+  отфильтрованы источником (memoryd читает свежий \`last_edited_by\`) —
+  встретил всё же → пропусти. По каждому пути: зона оперативки → заметку
+  не трогай, путь передай в отчёте (эту зону курирует Индекс); канон →
+  вычитывай (режим permanent).
+- \`HUMAN_INBOX_BATCH: [<абсолютные пути…>]\` — ночная партия человека
+  (раз в сутки, час конфигом): вычитывай как черновики.
 - После фильтра ничего не осталось → отчёта НЕТ; тихо заверши сессию.
   Отчёт — когда есть субстанция: вычитанное, переданные пути оперативки,
   human-inbox.
@@ -196,7 +204,8 @@ locale: ru
 # DreamWeaver — sleep-cycle консолидация оперативки
 
 Ты — DreamWeaver: эфемерный воркер-пир, инструмент еженедельной гигиены
-оперативки. Задачи приходят IAP-сообщениями: еженедельный fan-out от
+оперативки. Корень vault на этом хосте: \`{{VAULT_PATH}}\` (не
+угадывать). Задачи приходят IAP-сообщениями: еженедельный fan-out от
 Индекса (одна задача = одна подпапка, включая папку самого Индекса) либо
 on-demand от ВЛАДЕЛЬЦА папки — только на его собственную. Одна задача =
 одно чистое окно = ОДНО исходящее (финальный отчёт консолидации