@agfpd/iapeer-memory 0.1.3 → 0.1.4

package/package.json

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

package/src/commands/init.ts

@@ -35,8 +35,10 @@ import { provisionVault, writeDefaultConfig } from "../provision.js";
 import { writeRolesManifest, type RoleEntry } from "../roles.js";
 import { writeSlot } from "../slot.js";
 import {
+  doctrineOwnership,
   guideText,
   materialiseTemplates,
+  rolePersonality,
   roleTemplatePath,
   ROLE_NAMES,
 } from "../templates/index.js";
@@ -61,6 +63,10 @@ type InitFlags = {
   skipDeps: boolean;
   skipEcosystem: boolean;
   skipBinary: boolean;
+  /** Skip the host-wide guide fragment (staged fleet rollout — cutover 10.06:
+   *  the fleet still carries the MergeMind guide; ours lands by a separate
+   *  decision after the plugin swap). */
+  skipGuide: boolean;
   iapeerBin: string;
 };
 
@@ -70,6 +76,7 @@ function parseFlags(argv: string[]): InitFlags | null {
     skipDeps: false,
     skipEcosystem: false,
     skipBinary: false,
+    skipGuide: false,
     iapeerBin: "iapeer",
   };
   for (let i = 0; i < argv.length; i++) {
@@ -85,6 +92,7 @@ function parseFlags(argv: string[]): InitFlags | null {
       case "--skip-deps": f.skipDeps = true; break;
       case "--skip-ecosystem": f.skipEcosystem = true; break;
       case "--skip-binary": f.skipBinary = true; break;
+      case "--skip-guide": f.skipGuide = true; break;
       case "--iapeer-bin": f.iapeerBin = take() ?? "iapeer"; break;
       default:
         console.error(`iapeer-memory init: unknown flag: ${a}`);
@@ -263,7 +271,9 @@ export async function cmdInit(argv: string[]): Promise<number> {
   const tmpl = materialiseTemplates({ templatesDir: paths.templatesDir, locale });
   step("templates", `${paths.templatesDir} (${tmpl.written.length} written, ${tmpl.identical.length} identical)`);
 
-  // 6. role peers + doctrines + manifest
+  // 6. role peers + doctrines + manifest. Personalities are namespaced
+  // memory-<role> (collision-proof by design); the manifest keeps the
+  // CONCEPTUAL role keys.
   if (flags.skipEcosystem) {
     step("roles", "skipped (--skip-ecosystem)");
   } else {
@@ -271,26 +281,42 @@ export async function cmdInit(argv: string[]): Promise<number> {
     let rolesOk = true;
     let createdAny = false;
     for (const role of ROLE_NAMES) {
-      const exists = (peers ?? []).some((p) => p.personality === role);
+      const personality = rolePersonality(role);
+      const exists = (peers ?? []).some((p) => p.personality === personality);
       if (!exists) {
-        const created = run([flags.iapeerBin, "create", role]);
+        const created = run([flags.iapeerBin, "create", personality]);
         if (created.exitCode !== 0) {
           rolesOk = false;
-          console.log(`      roles       create ${role} failed: ${created.stderr.trim()}`);
+          console.log(`      roles       create ${personality} failed: ${created.stderr.trim()}`);
           continue;
         }
         createdAny = true;
       }
     }
     // peerCwd: the registry FACT when the core exposes it (`cwd` in
-    // `iapeer list --json` — iapeer 39de94b, next core release), otherwise
-    // the core's DOCUMENTED create default (no --path — требование Артура;
-    // IAPEER_ROOT-aware). Forward-compatible: switches to the fact
-    // automatically once the deployed core ships the field.
+    // `iapeer list --json` — iapeer 0.2.14), otherwise the core's
+    // DOCUMENTED create default (no --path — требование Артура;
+    // IAPEER_ROOT-aware).
     const freshPeers = createdAny ? listPeers(flags.iapeerBin) : peers;
     for (const role of ROLE_NAMES) {
-      const registryCwd = (freshPeers ?? []).find((p) => p.personality === role)?.cwd;
-      const peerCwd = registryCwd || path.join(iapeerDir, "peers", role);
+      const personality = rolePersonality(role);
+      const registryCwd = (freshPeers ?? []).find((p) => p.personality === personality)?.cwd;
+      const peerCwd = registryCwd || path.join(iapeerDir, "peers", personality);
+      // COLLISION GUARD (прецедент 10.06: «index» был занят живым
+      // MergeMind-Индексом; бренд-имена ролей — решение Артура, защита
+      // целиком здесь): a pre-existing peer whose doctrine is NOT ours is
+      // somebody else's — rendering over it would hijack a live peer.
+      // FAIL loud with a recipe, never render.
+      if (doctrineOwnership(peerCwd) === "foreign") {
+        rolesOk = false;
+        console.log(
+          `      roles       COLLISION: peer "${personality}" exists with a foreign doctrine ` +
+            `(${path.join(peerCwd, ".iapeer", "IAPEER.md")}) — not touching it. Recipe: ` +
+            `rename/remove that peer (iapeer stop ${personality} && iapeer remove ${personality}) ` +
+            `or move its cwd, then re-run init`,
+        );
+        continue;
+      }
       const template = roleTemplatePath(paths.templatesDir, locale, role);
       const rendered = renderDoctrine({ templatePath: template, peerCwd, version });
       if (rendered.action === "missing-template") {
@@ -308,8 +334,8 @@ export async function cmdInit(argv: string[]): Promise<number> {
     const wakePolicy = cwEntry ? patchWakePolicyEphemeral(cwEntry.peerCwd) : "missing-profile";
     step(
       "roles",
-      `${roleEntries.map((r) => r.role).join(", ")} (doctrines v${version}, ` +
-        `copywriter wake_policy: ${wakePolicy}, manifest ${paths.rolesManifestPath})`,
+      `${roleEntries.map((r) => rolePersonality(r.role as (typeof ROLE_NAMES)[number])).join(", ")} ` +
+        `(doctrines v${version}, copywriter wake_policy: ${wakePolicy}, manifest ${paths.rolesManifestPath})`,
       rolesOk && roleEntries.length === ROLE_NAMES.length && wakePolicy !== "missing-profile",
     );
   }
@@ -398,8 +424,12 @@ export async function cmdInit(argv: string[]): Promise<number> {
   }
 
   // 10. host-wide guide fragment (layer 5 — reaches every peer on next wakes)
-  const guidePath = writeHostWideGuideFragment(iapeerDir, guideText(locale));
-  step("guide", guidePath);
+  if (flags.skipGuide) {
+    step("guide", "skipped (--skip-guide) — roll out by a separate decision after the fleet plugin swap");
+  } else {
+    const guidePath = writeHostWideGuideFragment(iapeerDir, guideText(locale));
+    step("guide", guidePath);
+  }
 
   console.log(
     failures

package/src/templates/index.ts

@@ -30,6 +30,38 @@ import {
 export const ROLE_NAMES = ["index", "copywriter", "dreamweaver"] as const;
 export type RoleName = (typeof ROLE_NAMES)[number];
 
+/**
+ * Peer PERSONALITY of a role — the BRAND names, identical to the conceptual
+ * role names (решение Артура 10.06: «index должен остаться с таким же
+ * именем — это бренд, не memory-index»; the `memory-*` namespace variant
+ * was built and rolled back the same day). Collision safety therefore rests
+ * ENTIRELY on the init roles-step GUARD: a pre-existing peer with a foreign
+ * doctrine fails loud with a recipe, never gets rendered over (прецедент:
+ * «index» был занят живым MergeMind-Индексом до cutover'а). The single
+ * mapping point is kept so a future namespace decision is one line.
+ */
+export function rolePersonality(role: RoleName): string {
+  return role;
+}
+
+/**
+ * Who owns a peer's rendered doctrine — the init COLLISION GUARD's eye.
+ * "ours" = carries the ADR-010 marker; "foreign" = somebody else's live
+ * doctrine (rendering over it would hijack the peer — FAIL loud);
+ * "none" = bare peer, ours to render.
+ */
+export function doctrineOwnership(peerCwd: string): "ours" | "foreign" | "none" {
+  try {
+    const current = fs.readFileSync(
+      path.join(peerCwd, ".iapeer", "IAPEER.md"),
+      "utf-8",
+    );
+    return current.includes("<!-- iapeer-memory doctrine") ? "ours" : "foreign";
+  } catch {
+    return "none";
+  }
+}
+
 const ROLES: Record<LocaleId, Record<RoleName, string>> = {
   en: {
     index: INDEX_DOCTRINE_EN,