@agfpd/iapeer-memory-core 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agfpd/iapeer-memory-core",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "iapeer-memory core — host-neutral TypeScript memory primitive: vault schema/taxonomy config, search engine, memoryd, context renderer, role contracts. Consumed by the @agfpd/iapeer-memory facade; version kept in lockstep by its release flow (docs/10-distribution.md).",
   "license": "MIT",
   "type": "module",

package/src/config.ts

@@ -1,7 +1,7 @@
 /**
  * iapeer-memory core runtime config.
  *
- * Re-built from the MergeMind reference `config.ts` for the iapeer-memory
+ * Re-built from the reference implementation's `config.ts` for the iapeer-memory
  * namespace: `IAPEER_MEMORY_*` env vars, taxonomy-driven defaults (ADR-002 —
  * the locale preset supplies folder names instead of hard-coded constants)
  * and the `~/.iapeer/{cache,…}/iapeer-memory/` path namespace.
@@ -89,7 +89,7 @@ export type CoreConfig = {
  * to BM25. Adding the exact endpoint host to NO_PROXY is idempotent and
  * monotonic — it only bypasses the explicitly configured host.
  */
-function ensureEndpointNotProxied(endpoint: string): void {
+export function ensureEndpointNotProxied(endpoint: string): void {
   let host: string;
   try {
     host = new URL(endpoint).hostname;
@@ -106,6 +106,19 @@ function ensureEndpointNotProxied(endpoint: string): void {
   }
 }
 
+/**
+ * Loopback NEVER goes through a proxy — fleet-class defect (B-приёмка
+ * 10.06, boris): every peer's shell carries HTTP(S)_PROXY (VPN tinyproxy),
+ * Bun's fetch honours it for 127.0.0.1 too → the status probe of the LIVE
+ * memoryd port detoured to the proxy and lied «nothing listening» (proven:
+ * lsof caught tinyproxy SYN_SENT to 8766; `env -u HTTP_PROXY` → truthful).
+ * Call before ANY loopback fetch from CLI paths that run in agent shells.
+ */
+export function ensureLoopbackNotProxied(): void {
+  ensureEndpointNotProxied("http://127.0.0.1/");
+  ensureEndpointNotProxied("http://localhost/");
+}
+
 function envString(name: string, fallback = ""): string {
   const value = process.env[name];
   return typeof value === "string" && value.length > 0 ? value : fallback;

package/src/frontmatter-fill.ts

@@ -8,7 +8,7 @@
  *
  * - **curator-set instead of hard-coded `index`** (ADR-006): `needs_review`
  *   is NOT stamped when the writing agent belongs to the configured curator
- *   set (`index`, `copywriter`, `dreamweaver` by default) — curators'
+ *   set (`index`, `scriber`, `dreamweaver` by default) — curators'
  *   edits are sanctioned curation, not author edits awaiting review.
  * - **taxonomy-driven zone routing** (ADR-002/011): folder names, the
  *   agent-memory type token and emitted status tokens come from the locale

package/src/index.ts

@@ -8,7 +8,12 @@
  */
 
 // config
-export { configFromEnv, type CoreConfig } from "./config.js";
+export {
+  configFromEnv,
+  ensureEndpointNotProxied,
+  ensureLoopbackNotProxied,
+  type CoreConfig,
+} from "./config.js";
 
 // taxonomy (ADR-002/011)
 export {

package/src/indexer.ts

@@ -31,7 +31,7 @@ export async function indexAll(params: {
 
   const deleted = deleteMissingDocuments(db, seenPaths);
   if (deleted > 0) {
-    logger.info(`MergeMind: removed ${deleted} stale documents from index`);
+    logger.info(`iapeer-memory: removed ${deleted} stale documents from index`);
   }
 
   // Resolve wikilinks: map note titles to actual file paths
@@ -193,7 +193,7 @@ async function embedMissingChunks(params: {
 
     if (!result.vectors) {
       logger.warn(
-        `MergeMind: embedding endpoint unavailable (${result.status}), skipping embedding`,
+        `iapeer-memory: embedding endpoint unavailable (${result.status}), skipping embedding`,
       );
       break;
     }
@@ -208,7 +208,7 @@ async function embedMissingChunks(params: {
   }
 
   if (total > 0) {
-    logger.info(`MergeMind: embedded ${total} chunks`);
+    logger.info(`iapeer-memory: embedded ${total} chunks`);
   }
 }
 
@@ -227,11 +227,11 @@ async function scanRoot(params: ScanRootParams): Promise<void> {
   try {
     const stat = await fs.stat(basePath);
     if (!stat.isDirectory()) {
-      logger.warn(`MergeMind: skip non-directory path ${basePath}`);
+      logger.warn(`iapeer-memory: skip non-directory path ${basePath}`);
       return;
     }
   } catch {
-    logger.warn(`MergeMind: path does not exist, skipping ${basePath}`);
+    logger.warn(`iapeer-memory: path does not exist, skipping ${basePath}`);
     return;
   }
 
@@ -264,7 +264,7 @@ async function walkDirectory(params: ScanRootParams, currentPath: string): Promi
       await indexFile(params, fullPath);
     } catch (err) {
       params.logger.warn(
-        `MergeMind: skip ${fullPath} — ${err instanceof Error ? err.message : String(err)}`,
+        `iapeer-memory: skip ${fullPath} — ${err instanceof Error ? err.message : String(err)}`,
       );
     }
   }
@@ -319,5 +319,5 @@ async function indexFile(params: ScanRootParams, fullPath: string): Promise<void
     addTitlePath(titleToPath, titleNfc, docPath);
   }
 
-  logger.info(`MergeMind: indexed ${docPath}`);
+  logger.info(`iapeer-memory: indexed ${docPath}`);
 }

package/src/mcp-tools.ts

@@ -59,7 +59,7 @@ export const MCP_TOOL_SURFACE = ["vault_search", "vault_graph", "vault_map"] as
 /**
  * Validate and resolve a user-supplied vault path before any disk access.
  *
- * vault_read is reachable from any agent that loads the MergeMind plugin,
+ * vault_read is reachable from any agent that loads the reference plugin,
  * including ones whose context can be poisoned by inbox drafts (prompt
  * injection). Without containment, an attacker-controlled `path` like
  * `../../.ssh/id_rsa`, `../../.mergemind/env`, or `/etc/passwd` would
@@ -237,7 +237,7 @@ export async function runRead(
 // ---- vault_graph ----
 
 // Oneway-фильтр графа: backlinks из `06_Оперативка_агентов/` **не**
-// показываются при запросе графа канонической заметки — граф MergeMind не
+// показываются при запросе графа канонической заметки — граф референса не
 // должен засоряться упоминаниями оперативки разных агентов. От оперативной
 // заметки исходящие связи (на каноники) показываются как есть — автор
 // должен видеть на что ссылается его оперативка. Парсер сохраняет все

package/src/search.ts

@@ -61,7 +61,7 @@ const SNIPPET_LEAD_CHARS = 40;
 // without faking relevance.
 const EMPTY_NOTE_SNIPPET = "(пустой каркас — в заметке нет содержимого)";
 // How many top-degree related notes to surface per result. Was unbounded —
-// hub notes (e.g. План MergeMind) inflated payload to ~10KB on a 6-result
+// hub notes (e.g. a project Plan note) inflated payload to ~10KB on a 6-result
 // search. Agents can call vault_graph for the full neighborhood.
 const RELATED_LIMIT = 3;
 

package/src/taxonomy.ts

@@ -6,7 +6,7 @@
  * Every folder name, enum value (type / status / subtype), the links-section
  * heading, project file-name prefixes and system file names live here.
  * i18n = presets of this same configuration: the EN base plus the RU preset
- * (the live MergeMind vault, used for migration parity).
+ * (the live reference vault, used for migration parity).
  *
  * The canonical RU↔EN mapping is the table in `docs/01-vault-layout.md`
  * §«Таксономия» — this module encodes that table; tests guard shape parity
@@ -204,7 +204,7 @@ export const TAXONOMY_EN: TaxonomyPreset = {
 };
 
 /**
- * RU preset — the live MergeMind vault taxonomy (frozen reference, ADR-002).
+ * RU preset — the live reference-vault taxonomy (frozen, ADR-002).
  * Values are verbatim from the reference `src/` constants and
  * `docs/01-vault-layout.md`; migration parity runs against this preset.
  */
@@ -380,6 +380,6 @@ export const DEFAULT_RANKING: RankingConfig = {
  */
 export const DEFAULT_CURATOR_SET: readonly string[] = [
   "index",
-  "copywriter",
+  "scriber",
   "dreamweaver",
 ];