@rubytech/create-realagent-code 0.1.167 → 0.1.170

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent-code",
-  "version": "0.1.167",
+  "version": "0.1.170",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent-code": "./dist/index.js"

package/payload/platform/plugins/docs/references/platform.md

@@ -31,7 +31,7 @@ Everything {{productName}} can do is provided by a plugin. Each plugin is a self
 
 **How tools and roles reach the session.** Each `claude` PTY spawn registers every plugin's MCP server and every bundled subagent directory before the operator's first turn — a per-spawn `mcp-config.json` written by the session manager and passed as `--mcp-config` on the PTY argv, plus one `--add-dir` per agents directory. Admin sessions see every plugin and every role; public sessions see only plugins with at least one public-allowlisted tool. The manager refuses to start when a plugin's `PLUGIN.md` declares tools without a matching `mcp:` block (forensic signal: `boot-failed reason=mcp-allowlist-without-server …`). See `internals.md` "Spawn-time MCP and subagent registration" for the full mechanism and `internals.md` "Tool Eagerness" for the separate ToolSearch-vs-eager registration concern.
 
-**Where premium bundle subs live.** Bundle subs (`loop`, `property-data`, `brochures`, etc. inside `real-agent`) live exclusively at `premium-plugins/<bundle>/plugins/<sub>/` and are registered via the resolver's bundle-descent walk. They are never flat-copied into `platform/plugins/<sub>/`. Standalone premiums (no `BUNDLE.md`) still flat-copy on first boot because there is no parallel descent to register them. A divergent flat copy of a bundle sub is treated as an operator override: the resolver refuses to boot with `boot-failed reason=mcp-plugin-duplicate <plugin> declared by more than one plugins root: <pathA> (sha=…) vs <pathB> (sha=…)` so the operator can `sha256sum` both paths and remove the stale one. Byte-identical flat copies left over from installs predating Task 169 are reaped on the first post-upgrade boot (`[premium-auto-deliver] reaped sub=<name> reason=duplicate-of-premium-tree`).
+**Where premium bundle subs live.** Bundle subs (`loop`, `property-data`, `brochures`, etc. inside `real-agent`) live exclusively at `premium-plugins/<bundle>/plugins/<sub>/` and are registered via the resolver's bundle-descent walk. Standalone premiums (no `BUNDLE.md`, e.g. `writer-craft`, `teaching`, `venture-studio`) live exclusively at `premium-plugins/<name>/` and are registered via the resolver's dual-root scan (`platform/plugins/` and `premium-plugins/` are both `pluginsRoots`). Neither shape is flat-copied into `platform/plugins/<name>/`. A divergent flat copy of a bundle sub is treated as an operator override: the resolver refuses to boot with `boot-failed reason=mcp-plugin-duplicate <plugin> declared by more than one plugins root: <pathA> (sha=…) vs <pathB> (sha=…)` so the operator can `sha256sum` both paths and remove the stale one. Byte-identical bundle-sub flat copies left over from installer versions that flat-copied bundle subs are reaped on the first post-upgrade boot (`[premium-auto-deliver] reaped sub=<name> reason=duplicate-of-premium-tree`). Standalone flat copies (leaked by the pre-fix `autoDeliverPremiumPlugins` standalone branch) are reaped unconditionally — there is no documented override path for standalones at `platform/plugins/<name>/` — and the reaper logs `[premium-auto-deliver] reaped standalone=<name> matches-source=<true|false>` so divergent reaps leave a forensic trail.
 
 Plugins are installed and managed through conversation. You can add marketplace plugins (like Stripe) or use {{productName}}'s built-in ones (contacts, memory, Telegram).
 

package/payload/server/{chunk-3TRIXQSJ.js → chunk-L2YK2VK3.js}

@@ -3818,7 +3818,6 @@ import {
   readdirSync as readdirSync2,
   existsSync as existsSync5,
   statSync as statSync2,
-  cpSync,
   rmSync
 } from "fs";
 import { createHash as createHash2 } from "crypto";
@@ -3903,59 +3902,48 @@ function walkPremiumBundlesOnDisk() {
 function reapDuplicateFlatPremiumSubs(bundles, stagingRoot, pluginsDir) {
   const TAG = "[premium-auto-deliver]";
   for (const { bundle, subs } of bundles) {
+    const isBundle = existsSync5(join3(stagingRoot, bundle, "BUNDLE.md"));
     for (const sub of subs) {
-      const premiumManifest = resolve4(stagingRoot, bundle, "plugins", sub, "PLUGIN.md");
+      const premiumManifest = isBundle ? resolve4(stagingRoot, bundle, "plugins", sub, "PLUGIN.md") : resolve4(stagingRoot, bundle, "PLUGIN.md");
       const flatDir = resolve4(pluginsDir, sub);
       const flatManifest = resolve4(flatDir, "PLUGIN.md");
       if (!existsSync5(premiumManifest) || !existsSync5(flatManifest)) continue;
       const premiumSha = createHash2("sha256").update(readFileSync5(premiumManifest)).digest("hex");
       const flatSha = createHash2("sha256").update(readFileSync5(flatManifest)).digest("hex");
-      if (premiumSha === flatSha) {
+      if (isBundle) {
+        if (premiumSha === flatSha) {
+          try {
+            rmSync(flatDir, { recursive: true });
+            console.log(`${TAG} reaped sub=${sub} reason=duplicate-of-premium-tree`);
+          } catch (err) {
+            console.log(`${TAG} reap-failed sub=${sub} err=${err instanceof Error ? err.message : String(err)}`);
+          }
+        } else {
+          console.log(`${TAG} flat-copy-divergent sub=${sub} action=skip-keep`);
+        }
+      } else {
         try {
           rmSync(flatDir, { recursive: true });
-          console.log(`${TAG} reaped sub=${sub} reason=duplicate-of-premium-tree`);
+          console.log(`${TAG} reaped standalone=${sub} matches-source=${flatSha === premiumSha}`);
         } catch (err) {
-          console.log(`${TAG} reap-failed sub=${sub} err=${err instanceof Error ? err.message : String(err)}`);
+          console.log(`${TAG} reap-failed standalone=${sub} err=${err instanceof Error ? err.message : String(err)}`);
         }
-      } else {
-        console.log(`${TAG} flat-copy-divergent sub=${sub} action=skip-keep`);
       }
     }
   }
 }
 function autoDeliverPremiumPlugins() {
-  const TAG = "[premium-auto-deliver]";
   const bundles = walkPremiumBundles();
   if (bundles.length === 0) return;
   const stagingRoot = resolve4(PLATFORM_ROOT2, "../premium-plugins");
   const pluginsDir = resolve4(PLATFORM_ROOT2, "plugins");
   reapDuplicateFlatPremiumSubs(bundles, stagingRoot, pluginsDir);
-  for (const { bundle, subs: _subs } of bundles) {
-    const stagingDir = resolve4(stagingRoot, bundle);
-    const bundlePath = join3(stagingDir, "BUNDLE.md");
-    const isBundle = existsSync5(bundlePath);
-    if (isBundle) {
-      continue;
-    }
-    const target = resolve4(pluginsDir, bundle);
-    if (existsSync5(resolve4(target, "PLUGIN.md"))) {
-      console.log(`${TAG} ${bundle}: already present, skipping`);
-    } else {
-      try {
-        cpSync(stagingDir, target, { recursive: true });
-        console.log(`${TAG} ${bundle} (standalone): delivered`);
-      } catch (err) {
-        console.log(`${TAG} ${bundle}: copy failed: ${err instanceof Error ? err.message : String(err)}`);
-      }
-    }
-  }
 }
 function reconcileEnabledPlugins(accountDir, config, accountId) {
   const TAG = "[premium-auto-deliver]";
   if (!accountDir || !config) return;
   const bundles = walkPremiumBundles();
   const stagingRoot = resolve4(PLATFORM_ROOT2, "../premium-plugins");
-  const pluginsDir = resolve4(PLATFORM_ROOT2, "plugins");
   const bundleNames = [];
   const allSubs = [];
   for (const { bundle, subs } of bundles) {
@@ -3963,7 +3951,7 @@ function reconcileEnabledPlugins(accountDir, config, accountId) {
     const bundlePath = join3(stagingRoot, bundle, "BUNDLE.md");
     const isBundle = existsSync5(bundlePath);
     for (const sub of subs) {
-      const subManifest = isBundle ? resolve4(stagingRoot, bundle, "plugins", sub, "PLUGIN.md") : resolve4(pluginsDir, sub, "PLUGIN.md");
+      const subManifest = isBundle ? resolve4(stagingRoot, bundle, "plugins", sub, "PLUGIN.md") : resolve4(stagingRoot, bundle, "PLUGIN.md");
       if (!existsSync5(subManifest)) continue;
       allSubs.push(sub);
     }

package/payload/server/maxy-edge.js

@@ -14,7 +14,7 @@ import {
   sanitizeClientCorrId,
   vncLog,
   websockifyLog
-} from "./chunk-3TRIXQSJ.js";
+} from "./chunk-L2YK2VK3.js";
 import "./chunk-PFF6I7KP.js";
 
 // server/edge.ts

package/payload/server/server.js

@@ -84,7 +84,7 @@ import {
   vncLog,
   walkPremiumBundles,
   writeAdminUserAndPerson
-} from "./chunk-3TRIXQSJ.js";
+} from "./chunk-L2YK2VK3.js";
 import {
   __commonJS,
   __toESM