agent-remnote 1.3.1 → 1.3.3

package/dist/main.js

@@ -43209,6 +43209,10 @@ var mapErrorCause = /* @__PURE__ */ dual(2, (self, f) => matchCauseEffect(self,
   onSuccess: succeed
 }));
 var negate = (self) => map12(self, (b) => !b);
+var option = (self) => matchEffect(self, {
+  onFailure: () => succeed(none2()),
+  onSuccess: (a) => succeed(some2(a))
+});
 var orElseFail = /* @__PURE__ */ dual(2, (self, evaluate2) => orElse2(self, () => failSync(evaluate2)));
 var patchFiberRefs = (patch11) => updateFiberRefs((fiberId2, fiberRefs3) => pipe(patch11, patch9(fiberId2, fiberRefs3)));
 var promise = (evaluate2) => evaluate2.length >= 1 ? async_((resolve, signal) => {
@@ -47914,13 +47918,13 @@ var exponential2 = (baseInput, factor = 2) => {
 var fixed2 = (intervalInput) => {
   const interval = decode(intervalInput);
   const intervalMillis = toMillis(interval);
-  return makeWithState([none2(), 0], (now, _, [option, n]) => sync(() => {
-    switch (option._tag) {
+  return makeWithState([none2(), 0], (now, _, [option2, n]) => sync(() => {
+    switch (option2._tag) {
       case "None": {
         return [[some2([now, now + intervalMillis]), n + 1], n, continueWith2(after2(now + intervalMillis))];
       }
       case "Some": {
-        const [startMillis, lastRun] = option.value;
+        const [startMillis, lastRun] = option2.value;
         const runningBehind = now > lastRun + intervalMillis;
         const boundary = equals(interval, zero) ? interval : millis(intervalMillis - (now - startMillis) % intervalMillis);
         const sleepTime = equals(boundary, zero) ? interval : boundary;
@@ -48041,7 +48045,7 @@ var repeat_combined = /* @__PURE__ */ dual(2, (self, options) => {
 });
 var repeatOrElse_Effect = /* @__PURE__ */ dual(3, (self, schedule, orElse4) => flatMap7(driver(schedule), (driver2) => matchEffect(self, {
   onFailure: (error3) => orElse4(error3, none2()),
-  onSuccess: (value) => repeatOrElseEffectLoop(provideServiceEffect(self, CurrentIterationMetadata, get10(driver2.iterationMeta)), driver2, (error3, option) => provideServiceEffect(orElse4(error3, option), CurrentIterationMetadata, get10(driver2.iterationMeta)), value)
+  onSuccess: (value) => repeatOrElseEffectLoop(provideServiceEffect(self, CurrentIterationMetadata, get10(driver2.iterationMeta)), driver2, (error3, option2) => provideServiceEffect(orElse4(error3, option2), CurrentIterationMetadata, get10(driver2.iterationMeta)), value)
 })));
 var repeatOrElseEffectLoop = (self, driver2, orElse4, value) => matchEffect(driver2.next(value), {
   onFailure: () => orDie(driver2.last),
@@ -48364,6 +48368,7 @@ var provide2 = effect_provide;
 var provideService2 = provideService;
 var provideServiceEffect2 = provideServiceEffect;
 var serviceOption2 = serviceOption;
+var option2 = option;
 var either3 = either2;
 var exit2 = exit;
 var intoDeferred2 = intoDeferred;
@@ -55481,7 +55486,7 @@ var orElseIf = /* @__PURE__ */ dual(2, (self, options) => {
   fallback.condition = options.if;
   return fallback;
 });
-var option2 = (self) => {
+var option3 = (self) => {
   return pipe(self, map24(some2), orElseIf({
     orElse: () => succeed17(none2()),
     if: isMissingDataOnly2
@@ -55595,7 +55600,7 @@ var integer2 = integer;
 var duration3 = duration2;
 var isConfig2 = isConfig;
 var map25 = map24;
-var option3 = option2;
+var option4 = option3;
 var string5 = string4;
 var validate3 = validate2;
 var withDefault2 = withDefault;
@@ -61444,7 +61449,7 @@ var validateInternal = (self, value6, config2) => {
     }
   }
 };
-var attempt = (option5, typeName, parse5) => orElseFail2(option5, () => `${typeName} options do not have a default value`).pipe(flatMap9((value6) => orElseFail2(parse5(value6), () => `'${value6}' is not a ${typeName}`)));
+var attempt = (option6, typeName, parse5) => orElseFail2(option6, () => `${typeName} options do not have a default value`).pipe(flatMap9((value6) => orElseFail2(parse5(value6), () => `'${value6}' is not a ${typeName}`)));
 var validatePathExistence = (path, shouldPathExist, pathExists) => {
   if (shouldPathExist === "no" && pathExists) {
     return fail8(`Path '${path}' must not exist`);
@@ -62313,14 +62318,14 @@ var boolean7 = (name, options3) => {
     ...defaultBooleanOptions,
     ...options3
   };
-  const option5 = makeSingle(name, aliases, boolean5(some2(ifPresent)));
+  const option6 = makeSingle(name, aliases, boolean5(some2(ifPresent)));
   if (isNonEmptyReadonlyArray(negationNames)) {
     const head5 = headNonEmpty(negationNames);
     const tail = tailNonEmpty(negationNames);
     const negationOption = makeSingle(head5, tail, boolean5(some2(!ifPresent)));
-    return withDefault4(orElse13(option5, negationOption), !ifPresent);
+    return withDefault4(orElse13(option6, negationOption), !ifPresent);
   }
-  return withDefault4(option5, !ifPresent);
+  return withDefault4(option6, !ifPresent);
 };
 var choice4 = (name, choices) => {
   const primitive2 = choice2(map5(choices, (choice5) => [choice5, choice5]));
@@ -62861,7 +62866,7 @@ var wizardInternal3 = (self, config2) => {
       return select({
         message: toAnsiText(message).trimEnd(),
         choices
-      }).pipe(flatMap9((option5) => wizardInternal3(option5, config2)));
+      }).pipe(flatMap9((option6) => wizardInternal3(option6, config2)));
     }
     case "Variadic": {
       const repeatHelp = p("How many times should this argument be repeated?");
@@ -63510,11 +63515,12 @@ var map34 = map32;
 var optional5 = optional4;
 var repeated5 = repeated4;
 var withDefault5 = withDefault4;
+var withDescription5 = withDescription4;
 
 // ../../node_modules/@effect/cli/dist/esm/internal/commandDirective.js
-var builtIn = (option5) => ({
+var builtIn = (option6) => ({
   _tag: "BuiltIn",
-  option: option5
+  option: option6
 });
 var userDefined = (leftover2, value6) => ({
   _tag: "UserDefined",
@@ -63570,7 +63576,7 @@ var mapEffect7 = /* @__PURE__ */ dual(2, (self, f) => {
   return op;
 });
 var parse7 = /* @__PURE__ */ dual(3, (self, args2, config2) => parseInternal2(self, args2, config2));
-var withDescription5 = /* @__PURE__ */ dual(2, (self, help) => withDescriptionInternal(self, help));
+var withDescription6 = /* @__PURE__ */ dual(2, (self, help) => withDescriptionInternal(self, help));
 var withSubcommands = /* @__PURE__ */ dual(2, (self, subcommands) => {
   const op = Object.create(proto23);
   op._tag = "Subcommands";
@@ -64033,7 +64039,7 @@ var getFishCompletionsInternal = (self, executable) => traverseCommand(self, emp
   const options3 = isStandard(info2.command) ? all10([builtIns, info2.command.options]) : builtIns;
   const optionsCompletions = getFishCompletions3(options3);
   const argsCompletions = isStandard(info2.command) ? getFishCompletions2(info2.command.args) : empty2();
-  const rootCompletions = (conditionals2) => pipe(map5(optionsCompletions, (option5) => pipe(baseTemplate, appendAll(conditionals2), append(option5), join(" "))), appendAll(map5(argsCompletions, (option5) => pipe(baseTemplate, appendAll(conditionals2), append(option5), join(" ")))));
+  const rootCompletions = (conditionals2) => pipe(map5(optionsCompletions, (option6) => pipe(baseTemplate, appendAll(conditionals2), append(option6), join(" "))), appendAll(map5(argsCompletions, (option6) => pipe(baseTemplate, appendAll(conditionals2), append(option6), join(" ")))));
   const subcommandCompletions = (conditionals2) => map5(info2.subcommands, ([name, subcommand]) => {
     const description = getShortDescription3(subcommand);
     return pipe(baseTemplate, appendAll(conditionals2), appendAll(make4("-f", "-a", `"${name}"`)), appendAll(description.length === 0 ? empty2() : make4("-d", `'${description}'`)), join(" "));
@@ -64276,7 +64282,7 @@ __export(exports_Command, {
   wizard: () => wizard6,
   withSubcommands: () => withSubcommands3,
   withHandler: () => withHandler2,
-  withDescription: () => withDescription7,
+  withDescription: () => withDescription8,
   transformHandler: () => transformHandler2,
   run: () => run8,
   provideSync: () => provideSync2,
@@ -64447,7 +64453,7 @@ var provideSync = /* @__PURE__ */ dual(3, (self, tag4, f) => makeDerive(self, {
     return provideService2(self2, tag4, service2);
   }
 }));
-var withDescription6 = /* @__PURE__ */ dual(2, (self, help) => mapDescriptor(self, withDescription5(help)));
+var withDescription7 = /* @__PURE__ */ dual(2, (self, help) => mapDescriptor(self, withDescription6(help)));
 var withSubcommands2 = /* @__PURE__ */ dual(2, (self, subcommands) => {
   const command = withSubcommands(self.descriptor, map5(subcommands, (_) => [_.tag, _.descriptor]));
   const subcommandMap = reduce(subcommands, new Map, (handlers, subcommand) => {
@@ -64497,7 +64503,7 @@ var provideEffect2 = provideEffect;
 var provideEffectDiscard2 = provideEffectDiscard;
 var provideSync2 = provideSync;
 var transformHandler2 = transformHandler;
-var withDescription7 = withDescription6;
+var withDescription8 = withDescription7;
 var withHandler2 = withHandler;
 var withSubcommands3 = withSubcommands2;
 var wizard6 = wizard5;
@@ -70636,11 +70642,11 @@ var config2 = /* @__PURE__ */ all8({
   runnerAddress: /* @__PURE__ */ all8({
     host: string5("host").pipe(withDefault2(defaultRunnerAddress.host), withDescription2("The hostname or IP address of the runner.")),
     port: integer2("port").pipe(withDefault2(defaultRunnerAddress.port), withDescription2("The port used for inter-runner communication."))
-  }).pipe(/* @__PURE__ */ map25((options6) => RunnerAddress.make(options6)), option3),
+  }).pipe(/* @__PURE__ */ map25((options6) => RunnerAddress.make(options6)), option4),
   runnerListenAddress: /* @__PURE__ */ all8({
     host: string5("listenHost").pipe(withDescription2("The host to listen on.")),
     port: integer2("listenPort").pipe(withDefault2(defaultRunnerAddress.port), withDescription2("The port to listen on."))
-  }).pipe(/* @__PURE__ */ map25((options6) => RunnerAddress.make(options6)), option3),
+  }).pipe(/* @__PURE__ */ map25((options6) => RunnerAddress.make(options6)), option4),
   runnerShardWeight: /* @__PURE__ */ integer2("runnerShardWeight").pipe(/* @__PURE__ */ withDefault2(defaults.runnerShardWeight)),
   shardGroups: /* @__PURE__ */ array5(string5("shardGroups")).pipe(/* @__PURE__ */ withDefault2(["default"]), /* @__PURE__ */ withDescription2("The shard groups that are assigned to this runner.")),
   shardsPerGroup: /* @__PURE__ */ integer2("shardsPerGroup").pipe(/* @__PURE__ */ withDefault2(defaults.shardsPerGroup), /* @__PURE__ */ withDescription2("The number of shards to allocate per shard group.")),
@@ -73914,7 +73920,7 @@ var platformRunnerImpl = /* @__PURE__ */ PlatformRunner2.of({
   }
 });
 // src/main.ts
-import { readFileSync as readFileSync2 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 import { format as format10 } from "node:util";
 
 // src/services/UserConfigFile.ts
@@ -76530,6 +76536,18 @@ function readAppliedMigrations(db) {
     return new Map;
   }
 }
+function readStoreSchemaStatus(db) {
+  const applied = readAppliedMigrations(db);
+  const currentUserVersion = readUserVersion(db);
+  const appliedVersions = Array.from(applied.keys()).sort((a, b) => a - b);
+  const latestAppliedVersion = appliedVersions.length > 0 ? appliedVersions[appliedVersions.length - 1] : 0;
+  return {
+    current_user_version: currentUserVersion,
+    latest_supported_version: LATEST_USER_VERSION,
+    applied_migrations: applied.size,
+    latest_applied_version: latestAppliedVersion
+  };
+}
 function ensureMigrationRecorded(db, migration9, appliedAt, appVersion) {
   const existing = db.prepare(`SELECT name, checksum FROM store_migrations WHERE version=?`).get(migration9.version);
   if (existing) {
@@ -76869,10 +76887,10 @@ var OP_CATALOG = {
     op_type: "create_rem",
     aliases: ["rem.create"],
     payload: {
-      required: ["parent_id"],
-      optional: ["text", "tags", "is_document", "position", "client_temp_id"]
+      required: [],
+      optional: ["parent_id", "standalone", "text", "tags", "is_document", "position", "client_temp_id"]
     },
-    description: "Create a Rem (parent required).",
+    description: "Create a Rem (either parent_id or standalone=true required).",
     id_fields: ["parent_id", "tags[]"]
   },
   create_portal: {
@@ -76905,8 +76923,11 @@ var OP_CATALOG = {
   move_rem: {
     op_type: "move_rem",
     aliases: ["rem.move"],
-    payload: { required: ["rem_id", "new_parent_id"], optional: ["position"] },
-    description: "Move a Rem to a new parent.",
+    payload: {
+      required: ["rem_id"],
+      optional: ["new_parent_id", "standalone", "position", "is_document", "leave_portal"]
+    },
+    description: "Move a Rem to a new parent or to standalone top-level placement.",
     id_fields: ["rem_id", "new_parent_id"]
   },
   delete_rem: {
@@ -78999,6 +79020,7 @@ function toWsBridgeClient(client) {
     remoteAddr: client.remoteAddr,
     userAgent: client.userAgent,
     readyState: client.readyState,
+    runtime: client.runtime,
     selection: client.selection,
     uiContext: client.uiContext
   };
@@ -79059,6 +79081,10 @@ function buildClientsSnapshot(params3) {
 
 // src/lib/wsBridgeCore.ts
 var STATE_WRITE_TIMER_ID = "state-write";
+function normalizeRuntimeNumber(value8) {
+  const parsed = Number(value8 ?? 0);
+  return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 0;
+}
 function newClientState(params3) {
   return {
     connId: params3.connId,
@@ -79317,10 +79343,20 @@ function makeWsBridgeCore(params3) {
         const protocolVersionRaw = typeof msg?.protocolVersion === "number" ? msg.protocolVersion : typeof msg?.protocol_version === "number" ? msg.protocol_version : undefined;
         const protocolVersion = typeof protocolVersionRaw === "number" && Number.isFinite(protocolVersionRaw) && protocolVersionRaw > 0 ? Math.floor(protocolVersionRaw) : undefined;
         const capabilities = msg?.capabilities && typeof msg.capabilities === "object" ? msg.capabilities : {};
+        const runtime6 = msg?.runtime && typeof msg.runtime === "object" ? {
+          name: typeof msg.runtime.name === "string" ? msg.runtime.name : "unknown",
+          version: typeof msg.runtime.version === "string" ? msg.runtime.version : "0.0.0",
+          build_id: typeof msg.runtime.build_id === "string" ? msg.runtime.build_id : "unknown",
+          built_at: normalizeRuntimeNumber(msg.runtime.built_at),
+          source_stamp: normalizeRuntimeNumber(msg.runtime.source_stamp),
+          mode: typeof msg.runtime.mode === "string" ? msg.runtime.mode : undefined
+        } : undefined;
         client.clientType = clientType || client.clientType;
         client.clientInstanceId = clientInstanceIdRaw ? clientInstanceIdRaw : null;
         if (protocolVersion)
           client.protocolVersion = protocolVersion;
+        if (runtime6)
+          client.runtime = runtime6;
         client.capabilities = {
           control: !!capabilities?.control,
           worker: !!capabilities?.worker,
@@ -79338,6 +79374,7 @@ function makeWsBridgeCore(params3) {
             connId: event.connId,
             clientType: client.clientType ?? null,
             protocolVersion: client.protocolVersion ?? null,
+            runtime: client.runtime ?? null,
             capabilities: client.capabilities ?? null
           }
         });
@@ -91113,7 +91150,7 @@ var WsClientLive = succeed10(WsClient, {
 });
 
 // src/commands/ws/_shared.ts
-import path17 from "node:path";
+import path18 from "node:path";
 
 // src/services/Process.ts
 import { spawn as spawn3 } from "node:child_process";
@@ -91205,6 +91242,121 @@ var ProcessLive = succeed10(Process, {
   })
 });
 
+// src/lib/runtimeBuildInfo.ts
+import { createHash as createHash3 } from "node:crypto";
+import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "node:fs";
+import path17 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+function packageInfo() {
+  try {
+    const raw4 = readFileSync2(new URL("../../package.json", import.meta.url), "utf8");
+    const parsed = JSON.parse(raw4);
+    const name = typeof parsed?.name === "string" && parsed.name.trim() ? parsed.name.trim() : "agent-remnote";
+    const version = typeof parsed?.version === "string" && parsed.version.trim() ? parsed.version.trim() : "0.0.0";
+    return { name, version };
+  } catch {
+    return { name: "agent-remnote", version: "0.0.0" };
+  }
+}
+function fileMtimeMs(targetPath) {
+  try {
+    return Math.floor(statSync(targetPath).mtimeMs);
+  } catch {
+    return 0;
+  }
+}
+function latestMtimeMs(dirPath) {
+  if (!existsSync2(dirPath))
+    return 0;
+  let max7 = 0;
+  const stack = [dirPath];
+  while (stack.length > 0) {
+    const current2 = stack.pop();
+    let entries2 = [];
+    try {
+      entries2 = readdirSync(current2);
+    } catch {
+      continue;
+    }
+    for (const entry of entries2) {
+      const full = path17.join(current2, entry);
+      let st;
+      try {
+        st = statSync(full);
+      } catch {
+        continue;
+      }
+      if (st.isDirectory()) {
+        stack.push(full);
+      } else if (st.isFile()) {
+        max7 = Math.max(max7, Math.floor(st.mtimeMs));
+      }
+    }
+  }
+  return max7;
+}
+function detectMode() {
+  const url2 = import.meta.url;
+  if (url2.includes("/src/"))
+    return "src";
+  if (url2.includes("/dist/"))
+    return "dist";
+  return "unknown";
+}
+function computeDefaultBuildInfo() {
+  const pkg = packageInfo();
+  const mode = detectMode();
+  const srcDir = new URL("../", import.meta.url);
+  const packageJson = new URL("../../package.json", import.meta.url);
+  const sourceStamp = Math.max(latestMtimeMs(fileURLToPath2(srcDir)), fileMtimeMs(fileURLToPath2(packageJson)));
+  const buildIdInput = `${pkg.name}
+${pkg.version}
+${mode}
+${sourceStamp}`;
+  const buildId = createHash3("sha256").update(buildIdInput).digest("hex").slice(0, 12);
+  return {
+    name: pkg.name,
+    version: pkg.version,
+    build_id: `${pkg.version}:${buildId}`,
+    built_at: sourceStamp || Date.now(),
+    source_stamp: sourceStamp || Date.now(),
+    mode
+  };
+}
+var cached4;
+function parseEnvNumber(raw4, fallback) {
+  const parsed = Number(raw4);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+function currentRuntimeBuildInfo() {
+  if (cached4)
+    return cached4;
+  const defaultInfo = computeDefaultBuildInfo();
+  cached4 = {
+    name: process.env.AGENT_REMNOTE_NAME?.trim() || defaultInfo.name,
+    version: process.env.AGENT_REMNOTE_VERSION?.trim() || defaultInfo.version,
+    build_id: process.env.AGENT_REMNOTE_BUILD_ID?.trim() || defaultInfo.build_id,
+    built_at: parseEnvNumber(process.env.AGENT_REMNOTE_BUILD_AT, defaultInfo.built_at),
+    source_stamp: parseEnvNumber(process.env.AGENT_REMNOTE_SOURCE_STAMP, defaultInfo.source_stamp),
+    mode: process.env.AGENT_REMNOTE_BUILD_MODE === "src" || process.env.AGENT_REMNOTE_BUILD_MODE === "dist" || process.env.AGENT_REMNOTE_BUILD_MODE === "unknown" ? process.env.AGENT_REMNOTE_BUILD_MODE : defaultInfo.mode
+  };
+  return cached4;
+}
+function runtimeVersionWarnings(params3) {
+  const warnings = [];
+  const compare2 = (label, other) => {
+    if (!other)
+      return;
+    if (other.build_id !== params3.current.build_id) {
+      warnings.push(`${label} build mismatch: current=${params3.current.build_id} live=${other.build_id}`);
+    }
+  };
+  compare2("daemon", params3.daemon);
+  compare2("plugin", params3.plugin);
+  compare2("api", params3.api);
+  return warnings;
+}
+
 // src/commands/ws/_shared.ts
 var WS_HEALTH_TIMEOUT_MS = 2000;
 var WS_START_WAIT_DEFAULT_MS = 15000;
@@ -91244,6 +91396,7 @@ function supervisorCommandLine(params3) {
 function toPidFileValue(params3) {
   return {
     pid: params3.pid,
+    build: currentRuntimeBuildInfo(),
     started_at: params3.startedAt,
     ws_url: params3.wsUrl,
     log_file: params3.logFile,
@@ -91294,7 +91447,7 @@ function toInitialSupervisorState(now2) {
   };
 }
 function defaultStateFilePathFromPidFile(pidFilePath) {
-  return path17.join(path17.dirname(pidFilePath), "ws.state.json");
+  return path18.join(path18.dirname(pidFilePath), "ws.state.json");
 }
 function startWsSupervisor(params3) {
   return gen2(function* () {
@@ -91409,6 +91562,21 @@ var doctorCommand = exports_Command.make("doctor", {}, () => gen2(function* () {
     const hasContents = !!db.prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='remsContents' LIMIT 1`).get();
     return { has_search_index: hasSearchInfos && hasContents };
   }).pipe(either3);
+  const schema2 = yield* try_3({
+    try: () => {
+      const db = openStoreDb(cfg.storeDb);
+      try {
+        return readStoreSchemaStatus(db);
+      } finally {
+        db.close();
+      }
+    },
+    catch: (error4) => new CliError({
+      code: "DB_UNAVAILABLE",
+      message: `Failed to read store schema: ${String(error4?.message || error4)}`,
+      exitCode: 1
+    })
+  }).pipe(either3);
   const wsHealth = yield* ws.health({ url: cfg.wsUrl, timeoutMs: WS_HEALTH_TIMEOUT_MS }).pipe(either3);
   const wsClients = yield* ws.queryClients({ url: cfg.wsUrl, timeoutMs: WS_HEALTH_TIMEOUT_MS }).pipe(either3);
   const pidFilePath = daemonFiles.defaultPidFile();
@@ -91420,6 +91588,8 @@ var doctorCommand = exports_Command.make("doctor", {}, () => gen2(function* () {
     queue: {
       ok: queueStats2._tag === "Right",
       db_path: cfg.storeDb,
+      schema: schema2._tag === "Right" ? schema2.right : undefined,
+      schema_error: schema2._tag === "Left" ? schema2.left.message : undefined,
       writable: storeDbWritable.ok,
       writable_reason: storeDbWritable.reason,
       stats: queueStats2._tag === "Right" ? queueStats2.right : undefined,
@@ -91469,6 +91639,10 @@ var doctorCommand = exports_Command.make("doctor", {}, () => gen2(function* () {
     `- overall_ok: ${overallOk}`,
     `- queue_ok: ${data.queue.ok}`,
     `- store_db: ${data.queue.db_path}`,
+    `- store_schema_current_user_version: ${data.queue.schema?.current_user_version ?? ""}`,
+    `- store_schema_latest_supported_version: ${data.queue.schema?.latest_supported_version ?? ""}`,
+    `- store_schema_applied_migrations: ${data.queue.schema?.applied_migrations ?? ""}`,
+    `- store_schema_error: ${data.queue.schema_error ?? ""}`,
     `- remnote_db_ok: ${data.remnote_db.ok}`,
     `- remnote_db: ${data.remnote_db.db_path ?? ""}`,
     `- remnote_db_resolution: ${data.remnote_db.resolution ?? ""}`,
@@ -91802,24 +91976,24 @@ var wsLogsCommand = exports_Command.make("logs", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/ws/restart.ts
-import path19 from "node:path";
+import path20 from "node:path";
 
 // src/lib/statuslineArtifacts.ts
 import { promises as fs13 } from "node:fs";
 
 // src/services/StatusLineFile.ts
 import { promises as fs12 } from "node:fs";
-import path18 from "node:path";
+import path19 from "node:path";
 class StatusLineFile extends Tag2("StatusLineFile")() {
 }
 function defaultTextFile() {
-  return path18.join(homeDir(), ".agent-remnote", "status-line.txt");
+  return path19.join(homeDir(), ".agent-remnote", "status-line.txt");
 }
 function defaultJsonFile() {
-  return path18.join(homeDir(), ".agent-remnote", "status-line.json");
+  return path19.join(homeDir(), ".agent-remnote", "status-line.json");
 }
 function ensureDir6(p3) {
-  return fs12.mkdir(path18.dirname(p3), { recursive: true }).then(() => {
+  return fs12.mkdir(path19.dirname(p3), { recursive: true }).then(() => {
     return;
   });
 }
@@ -91932,7 +92106,7 @@ var wsRestartCommand = exports_Command.make("restart", {
   const pidFilePath = resolveUserFilePath(pidFile4 ?? daemonFiles.defaultPidFile());
   const existing = yield* daemonFiles.readPidFile(pidFilePath);
   let stopResult = { stopped: true, pid_file: pidFilePath };
-  const stateFilePath = resolveUserFilePath(existing?.state_file ?? path19.join(path19.dirname(pidFilePath), "ws.state.json"));
+  const stateFilePath = resolveUserFilePath(existing?.state_file ?? path20.join(path20.dirname(pidFilePath), "ws.state.json"));
   if (existing) {
     const alive = yield* proc.isPidRunning(existing.pid);
     if (!alive) {
@@ -92004,10 +92178,10 @@ function safeJsonParse2(text14) {
   }
 }
 var WsBridgeServerLive = succeed10(WsBridgeServer, {
-  listen: ({ port: port3, path: path20, host }) => acquireRelease2(gen2(function* () {
+  listen: ({ port: port3, path: path21, host }) => acquireRelease2(gen2(function* () {
     const events = yield* unbounded5();
     const sockets = new Map;
-    const wss = new import_websocket_server.default({ port: port3, host, path: path20 });
+    const wss = new import_websocket_server.default({ port: port3, host, path: path21 });
     wss.on("connection", (ws, req) => {
       const connId = randomUUID4();
       const remoteAddr = safeStringHeader(req?.socket?.remoteAddress);
@@ -92041,7 +92215,7 @@ var WsBridgeServerLive = succeed10(WsBridgeServer, {
     });
     const handle = {
       events,
-      serverInfo: { port: port3, path: path20 },
+      serverInfo: { port: port3, path: path21 },
       sendText: (connId, text14) => sync3(() => {
         const ws = sockets.get(connId);
         if (!ws)
@@ -92103,17 +92277,17 @@ var WsBridgeServerLive = succeed10(WsBridgeServer, {
     code: "WS_UNAVAILABLE",
     message: "Failed to start ws bridge server",
     exitCode: 1,
-    details: { error: String(error4?.message || error4), port: port3, path: path20, host }
+    details: { error: String(error4?.message || error4), port: port3, path: path21, host }
   }))))
 });
 
 // src/services/WsBridgeStateFile.ts
 import { promises as fs14 } from "node:fs";
-import path20 from "node:path";
+import path21 from "node:path";
 class WsBridgeStateFile extends Tag2("WsBridgeStateFile")() {
 }
 async function ensureDir7(filePath) {
-  await fs14.mkdir(path20.dirname(filePath), { recursive: true });
+  await fs14.mkdir(path21.dirname(filePath), { recursive: true });
 }
 async function writeTextAtomic2(filePath, content) {
   await ensureDir7(filePath);
@@ -92526,7 +92700,7 @@ function runWsBridgeRuntime(params3) {
     const heartbeatIntervalMs = params3.heartbeatIntervalMs ?? 30000;
     const core = makeWsBridgeCore({
       config: {
-        serverInfo: server.serverInfo,
+        serverInfo: { ...server.serverInfo, runtime: currentRuntimeBuildInfo() },
         queueDbPath: cfg.storeDb,
         stateFileEnabled: !cfg.wsStateFile.disabled,
         stateWriteMinIntervalMs: STATE_FILE_MIN_INTERVAL_MS,
@@ -92665,18 +92839,18 @@ function parseWsUrl(url2) {
   }
   const port3 = u.port ? Number(u.port) : u.protocol === "wss:" ? 443 : 80;
   const host = u.hostname && u.hostname.length > 0 ? u.hostname : "localhost";
-  const path21 = u.pathname && u.pathname.length > 0 ? u.pathname : "/ws";
+  const path22 = u.pathname && u.pathname.length > 0 ? u.pathname : "/ws";
   if (!Number.isFinite(port3) || port3 <= 0) {
     throw new CliError({ code: "INVALID_ARGS", message: `Invalid wsUrl port: ${url2}`, exitCode: 2 });
   }
-  if (!path21.startsWith("/")) {
+  if (!path22.startsWith("/")) {
     throw new CliError({ code: "INVALID_ARGS", message: `Invalid wsUrl path: ${url2}`, exitCode: 2 });
   }
-  return { host, port: port3, path: path21 };
+  return { host, port: port3, path: path22 };
 }
 var wsServeCommand = exports_Command.make("serve", {}, () => gen2(function* () {
   const cfg = yield* AppConfig;
-  const { host, port: port3, path: path21 } = yield* try_3({
+  const { host, port: port3, path: path22 } = yield* try_3({
     try: () => parseWsUrl(cfg.wsUrl),
     catch: (e) => isCliError(e) ? e : new CliError({
       code: "INVALID_ARGS",
@@ -92685,7 +92859,7 @@ var wsServeCommand = exports_Command.make("serve", {}, () => gen2(function* () {
       details: { ws_url: cfg.wsUrl, error: String(e?.message || e) }
     })
   });
-  yield* runWsBridgeRuntime({ host, port: port3, path: path21 });
+  yield* runWsBridgeRuntime({ host, port: port3, path: path22 });
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/ws/start.ts
@@ -92701,14 +92875,14 @@ function parseWsUrl2(url2) {
   }
   const port3 = u.port ? Number(u.port) : u.protocol === "wss:" ? 443 : 80;
   const host = u.hostname && u.hostname.length > 0 ? u.hostname : "localhost";
-  const path21 = u.pathname && u.pathname.length > 0 ? u.pathname : "/ws";
+  const path22 = u.pathname && u.pathname.length > 0 ? u.pathname : "/ws";
   if (!Number.isFinite(port3) || port3 <= 0) {
     throw new CliError({ code: "INVALID_ARGS", message: `Invalid wsUrl port: ${url2}`, exitCode: 2 });
   }
-  if (!path21.startsWith("/")) {
+  if (!path22.startsWith("/")) {
     throw new CliError({ code: "INVALID_ARGS", message: `Invalid wsUrl path: ${url2}`, exitCode: 2 });
   }
-  return { host, port: port3, path: path21 };
+  return { host, port: port3, path: path22 };
 }
 var pidFile4 = text9("pid-file").pipe(optional5, map34(optionToUndefined4));
 var logFile3 = text9("log-file").pipe(optional5, map34(optionToUndefined4));
@@ -92720,7 +92894,7 @@ var wsStartCommand = exports_Command.make("start", {
 }, ({ foreground, wait, pidFile: pidFile5, logFile: logFile4 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   if (foreground) {
-    const { host, port: port3, path: path21 } = yield* try_3({
+    const { host, port: port3, path: path22 } = yield* try_3({
       try: () => parseWsUrl2(cfg.wsUrl),
       catch: (e) => isCliError(e) ? e : new CliError({
         code: "INVALID_ARGS",
@@ -92729,7 +92903,7 @@ var wsStartCommand = exports_Command.make("start", {
         details: { ws_url: cfg.wsUrl, error: String(e?.message || e) }
       })
     });
-    yield* runWsBridgeRuntime({ host, port: port3, path: path21 });
+    yield* runWsBridgeRuntime({ host, port: port3, path: path22 });
     return;
   }
   const result = yield* startWsSupervisor({ waitMs: wait, pidFile: pidFile5, logFile: logFile4 });
@@ -92744,7 +92918,110 @@ var wsStartCommand = exports_Command.make("start", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/ws/status.ts
-import path21 from "node:path";
+import path24 from "node:path";
+
+// src/lib/pluginBuildInfo.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+import path23 from "node:path";
+
+// src/lib/pluginArtifacts.ts
+import { existsSync as existsSync3, statSync as statSync2 } from "node:fs";
+import path22 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+function currentDir(moduleUrl) {
+  return path22.dirname(fileURLToPath3(moduleUrl));
+}
+function isDirectory(targetPath) {
+  try {
+    return statSync2(targetPath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function isFile(targetPath) {
+  try {
+    return statSync2(targetPath).isFile();
+  } catch {
+    return false;
+  }
+}
+function distCandidates(moduleUrl) {
+  const dir2 = currentDir(moduleUrl);
+  return [
+    path22.resolve(dir2, "../../plugin-artifacts/dist"),
+    path22.resolve(dir2, "../plugin-artifacts/dist"),
+    path22.resolve(dir2, "../../../plugin/dist"),
+    path22.resolve(dir2, "../../plugin/dist")
+  ];
+}
+function validateDistPath(targetPath) {
+  return isDirectory(targetPath) && existsSync3(path22.join(targetPath, "manifest.json"));
+}
+function hasBuildInfo(targetPath) {
+  return isFile(path22.join(targetPath, "build-info.json"));
+}
+function resolvePluginDistPath(moduleUrl = import.meta.url) {
+  for (const candidate of distCandidates(moduleUrl)) {
+    if (validateDistPath(candidate) && hasBuildInfo(candidate))
+      return candidate;
+  }
+  for (const candidate of distCandidates(moduleUrl)) {
+    if (validateDistPath(candidate))
+      return candidate;
+  }
+  throw new CliError({
+    code: "DEPENDENCY_MISSING",
+    message: "Plugin build artifacts are unavailable",
+    exitCode: 1,
+    details: { candidates: distCandidates(moduleUrl) },
+    hint: [
+      "Run npm run build --workspace @remnote/plugin in the repository checkout",
+      "Or install a packaged agent-remnote release that includes plugin artifacts"
+    ]
+  });
+}
+
+// src/lib/pluginBuildInfo.ts
+function readPluginDistBuildInfo(distPath) {
+  const normalized = typeof distPath === "string" ? distPath.trim() : "";
+  if (!normalized)
+    return null;
+  const target2 = path23.join(normalized, "build-info.json");
+  try {
+    const raw4 = readFileSync3(target2, "utf8");
+    const parsed = JSON.parse(raw4);
+    if (typeof parsed?.name === "string" && typeof parsed?.version === "string" && typeof parsed?.build_id === "string" && typeof parsed?.built_at === "number" && typeof parsed?.source_stamp === "number") {
+      return {
+        name: parsed.name,
+        version: parsed.version,
+        build_id: parsed.build_id,
+        built_at: parsed.built_at,
+        source_stamp: parsed.source_stamp,
+        mode: parsed.mode === "src" || parsed.mode === "dist" || parsed.mode === "unknown" ? parsed.mode : "dist"
+      };
+    }
+  } catch {}
+  return null;
+}
+function currentExpectedPluginBuildInfo() {
+  try {
+    const dist = resolvePluginDistPath();
+    return readPluginDistBuildInfo(dist);
+  } catch {
+    return null;
+  }
+}
+function pluginBuildWarnings(params3) {
+  if (!params3.expected || !params3.live)
+    return [];
+  if (params3.expected.build_id === params3.live.build_id)
+    return [];
+  return [
+    `plugin build mismatch: expected=${params3.expected.build_id} live=${params3.live.build_id}`
+  ];
+}
+
+// src/commands/ws/status.ts
 function optionToUndefined5(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
@@ -92763,14 +93040,14 @@ var wsStatusCommand = exports_Command.make("status", { pidFile: pidFile5 }, ({ p
     if (!alive) {
       const stalePidInfo = pidInfo;
       yield* daemonFiles.deletePidFile(pidFilePath);
-      const staleStateFilePath = resolveUserFilePath(pidInfo.state_file ?? path21.join(path21.dirname(pidFilePath), "ws.state.json"));
+      const staleStateFilePath = resolveUserFilePath(pidInfo.state_file ?? path24.join(path24.dirname(pidFilePath), "ws.state.json"));
       yield* supervisorState.deleteStateFile(staleStateFilePath);
       selfHealCleanup = yield* cleanupStatuslineArtifacts(resolveStatuslineArtifactPaths({ cfg, pidInfo: stalePidInfo }));
       yield* sync3(() => refreshTmuxStatusLine());
       pidInfo = undefined;
     }
   }
-  const stateFilePath = resolveUserFilePath(pidInfo?.state_file ?? path21.join(path21.dirname(pidFilePath), "ws.state.json"));
+  const stateFilePath = resolveUserFilePath(pidInfo?.state_file ?? path24.join(path24.dirname(pidFilePath), "ws.state.json"));
   const state = yield* supervisorState.readStateFile(stateFilePath);
   const mode = pidInfo ? pidInfo.mode ?? "legacy" : "supervisor";
   const supervisorPid = pidInfo?.pid;
@@ -92780,10 +93057,23 @@ var wsStatusCommand = exports_Command.make("status", { pidFile: pidFile5 }, ({ p
   const childStartedAt = pidInfo?.child_started_at;
   const health = yield* ws.health({ url: cfg.wsUrl, timeoutMs: WS_HEALTH_TIMEOUT_MS }).pipe(either3);
   const clientsRes = yield* ws.queryClients({ url: cfg.wsUrl, timeoutMs: WS_HEALTH_TIMEOUT_MS }).pipe(either3);
+  const activeWorkerRuntime = isRight2(clientsRes) && typeof clientsRes.right.activeWorkerConnId === "string" ? clientsRes.right.clients.find((client) => client.connId === clientsRes.right.activeWorkerConnId)?.runtime ?? null : null;
+  const warnings = [
+    ...runtimeVersionWarnings({
+      current: currentRuntimeBuildInfo(),
+      daemon: pidInfo?.build
+    }),
+    ...pluginBuildWarnings({
+      expected: currentExpectedPluginBuildInfo(),
+      live: activeWorkerRuntime
+    })
+  ];
   const data = {
+    runtime: currentRuntimeBuildInfo(),
     service: {
       running: supervisorRunning,
       pid: supervisorPid,
+      build: pidInfo?.build ?? null,
       pid_file: pidFilePath,
       started_at: pidInfo?.started_at,
       log_file: pidInfo?.log_file,
@@ -92800,8 +93090,15 @@ var wsStatusCommand = exports_Command.make("status", { pidFile: pidFile5 }, ({ p
       error: isLeft2(health) ? health.left.message : undefined
     },
     active_worker_conn_id: isRight2(clientsRes) ? clientsRes.right.activeWorkerConnId ?? null : null,
-    clients: isRight2(clientsRes) ? clientsRes.right.clients : []
+    clients: isRight2(clientsRes) ? clientsRes.right.clients : [],
+    warnings
   };
+  if (data.service.running && !data.service.build) {
+    data.warnings.push("daemon pid metadata has no build info; restart the daemon to refresh runtime metadata");
+  }
+  if (data.active_worker_conn_id && !data.clients.find((client) => client.connId === data.active_worker_conn_id)?.runtime) {
+    data.warnings.push("active worker did not report runtime metadata; reload the RemNote plugin");
+  }
   const md = [
     `- service_running: ${data.service.running}`,
     `- pid: ${data.service.pid ?? ""}`,
@@ -92933,7 +93230,7 @@ var wsStatusLineCommand = exports_Command.make("status-line", { stateFile, stale
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/ws/stop.ts
-import path22 from "node:path";
+import path25 from "node:path";
 function optionToUndefined7(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
@@ -92961,7 +93258,7 @@ var wsStopCommand = exports_Command.make("stop", { force: boolean8("force"), pid
     });
     return;
   }
-  const stateFilePath = resolveUserFilePath(existing.state_file ?? path22.join(path22.dirname(pidFilePath), "ws.state.json"));
+  const stateFilePath = resolveUserFilePath(existing.state_file ?? path25.join(path25.dirname(pidFilePath), "ws.state.json"));
   const alive = yield* proc.isPidRunning(existing.pid);
   if (!alive) {
     yield* daemonFiles.deletePidFile(pidFilePath);
@@ -93156,7 +93453,7 @@ var ChildProcessLive = succeed10(ChildProcess2, {
 
 // src/services/LogWriter.ts
 import { promises as fs16 } from "node:fs";
-import path23 from "node:path";
+import path26 from "node:path";
 class LogWriterFactory extends Tag2("LogWriterFactory")() {
 }
 function sanitizePositiveInt(value8, fallback) {
@@ -93168,7 +93465,7 @@ function sanitizeMaxBytes(value8, fallback) {
   return Number.isFinite(value8) && value8 > 0 ? Math.floor(value8) : fallback;
 }
 async function ensureDir8(filePath) {
-  await fs16.mkdir(path23.dirname(filePath), { recursive: true });
+  await fs16.mkdir(path26.dirname(filePath), { recursive: true });
 }
 async function safeStat(filePath) {
   try {
@@ -93181,15 +93478,15 @@ async function safeStat(filePath) {
 async function rotateFiles(filePath, keep) {
   if (keep <= 0)
     return;
-  const dir2 = path23.dirname(filePath);
-  const base = path23.basename(filePath);
+  const dir2 = path26.dirname(filePath);
+  const base = path26.basename(filePath);
   let entries2 = [];
   try {
     entries2 = await fs16.readdir(dir2);
   } catch {
     return;
   }
-  const rotated = entries2.filter((name) => name.startsWith(`${base}.`)).map((name) => path23.join(dir2, name)).sort().reverse();
+  const rotated = entries2.filter((name) => name.startsWith(`${base}.`)).map((name) => path26.join(dir2, name)).sort().reverse();
   for (const p3 of rotated.slice(keep)) {
     try {
       await fs16.unlink(p3);
@@ -93294,6 +93591,7 @@ function makePidFileValue(params3) {
   return {
     mode: "supervisor",
     pid: params3.supervisorPid,
+    build: currentRuntimeBuildInfo(),
     child_pid: params3.childPid,
     child_started_at: params3.childStartedAt,
     started_at: params3.supervisorStartedAt,
@@ -94160,18 +94458,28 @@ var ACTIONS = {
     aliasRefAllowlist: ["parent_id"],
     compile: ({ input, aliasTempId }) => {
       const parent_id = input.parent_id;
+      const standalone = input.standalone === true;
       const text14 = input.text;
-      if (typeof parent_id !== "string" || !parent_id.trim()) {
-        throw new Error("write.bullet requires input.parent_id");
+      if (standalone && typeof parent_id === "string" && parent_id.trim()) {
+        throw new Error("write.bullet does not allow input.parent_id when input.standalone=true");
+      }
+      if (!standalone && (typeof parent_id !== "string" || !parent_id.trim())) {
+        throw new Error("write.bullet requires input.parent_id unless input.standalone=true");
       }
       if (typeof text14 !== "string") {
         throw new Error("write.bullet requires input.text");
       }
-      const payload = { parent_id, text: text14 };
+      const payload = { text: text14 };
+      if (standalone)
+        payload.standalone = true;
+      else
+        payload.parent_id = parent_id;
       if (input.is_document === true)
         payload.is_document = true;
       if (Array.isArray(input.tags))
         payload.tags = input.tags;
+      if (typeof input.position === "number")
+        payload.position = input.position;
       if (aliasTempId)
         payload.client_temp_id = aliasTempId;
       return { ops: [{ type: "create_rem", payload }] };
@@ -94322,9 +94630,9 @@ var ACTIONS = {
   },
   "portal.create": {
     opType: "create_portal",
-    supportsAs: false,
+    supportsAs: true,
     aliasRefAllowlist: ["parent_id", "target_rem_id"],
-    compile: ({ input }) => {
+    compile: ({ input, aliasTempId }) => {
       const parent_id = input.parent_id;
       const target_rem_id = input.target_rem_id;
       if (typeof parent_id !== "string" || !parent_id.trim()) {
@@ -94336,6 +94644,8 @@ var ACTIONS = {
       const payload = { parent_id, target_rem_id };
       if (typeof input.position === "number")
         payload.position = input.position;
+      if (aliasTempId)
+        payload.client_temp_id = aliasTempId;
       return { ops: [{ type: "create_portal", payload }] };
     }
   },
@@ -94415,6 +94725,37 @@ var ACTIONS = {
       return { ops: [{ type: "update_text", payload }] };
     }
   },
+  "rem.move": {
+    opType: "move_rem",
+    supportsAs: false,
+    aliasRefAllowlist: ["rem_id", "new_parent_id"],
+    compile: ({ input }) => {
+      const rem_id = input.rem_id;
+      const new_parent_id = input.new_parent_id;
+      const standalone = input.standalone === true;
+      if (typeof rem_id !== "string" || !rem_id.trim()) {
+        throw new Error("rem.move requires input.rem_id");
+      }
+      if (standalone && typeof new_parent_id === "string" && new_parent_id.trim()) {
+        throw new Error("rem.move does not allow input.new_parent_id when input.standalone=true");
+      }
+      if (!standalone && (typeof new_parent_id !== "string" || !new_parent_id.trim())) {
+        throw new Error("rem.move requires input.new_parent_id unless input.standalone=true");
+      }
+      const payload = { rem_id };
+      if (standalone)
+        payload.standalone = true;
+      else
+        payload.new_parent_id = new_parent_id;
+      if (typeof input.position === "number")
+        payload.position = input.position;
+      if (input.is_document === true)
+        payload.is_document = true;
+      if (input.leave_portal === true)
+        payload.leave_portal = true;
+      return { ops: [{ type: "move_rem", payload }] };
+    }
+  },
   "replace.block": {
     opType: "replace_selection_with_markdown",
     supportsAs: false,
@@ -94886,6 +95227,8 @@ function assertOpsNoOrphanCreates(ops) {
     }
     if (!OP_TYPES_REQUIRE_PARENT_ID.has(op.type))
       continue;
+    if (op.type === "create_rem" && op.payload?.standalone === true)
+      continue;
     const parentId = readParentIdFromPayload(op.payload);
     if (parentId)
       continue;
@@ -95005,7 +95348,7 @@ function normalizeOps(rawOps) {
 
 // src/services/RefResolver.ts
 import { homedir } from "node:os";
-import path24 from "node:path";
+import path27 from "node:path";
 
 // src/lib/workspaceResolver.ts
 import fs18 from "node:fs";
@@ -95456,8 +95799,8 @@ function normalizeDbPathInput(dbPath) {
   const raw4 = typeof dbPath === "string" ? dbPath.trim() : "";
   if (!raw4)
     return;
-  const expanded = raw4 === "~" ? homedir() : raw4.startsWith("~/") || raw4.startsWith("~\\") ? path24.join(homedir(), raw4.slice(2)) : raw4;
-  return path24.resolve(path24.normalize(expanded));
+  const expanded = raw4 === "~" ? homedir() : raw4.startsWith("~/") || raw4.startsWith("~\\") ? path27.join(homedir(), raw4.slice(2)) : raw4;
+  return path27.resolve(path27.normalize(expanded));
 }
 var RefResolverLive = succeed10(RefResolver, {
   resolve: (ref, options6) => gen2(function* () {
@@ -95551,8 +95894,8 @@ function resolveRefsInPayload(params3) {
     const out = structuredClone(params3.payload);
     const resolvedRefCache = new Map;
     const idPaths = idFieldPathsForOpType(params3.opType);
-    for (const path25 of idPaths) {
-      const tokens = parsePathTokens(path25);
+    for (const path28 of idPaths) {
+      const tokens = parsePathTokens(path28);
       if (tokens.length === 0)
         continue;
       const leaves = collectLeafValues(out, tokens);
@@ -95564,9 +95907,9 @@ function resolveRefsInPayload(params3) {
         const refValue = leaf.trim();
         if (!shouldResolveRef(refValue))
           return leaf;
-        const cached4 = resolvedRefCache.get(refValue);
-        if (cached4)
-          return cached4;
+        const cached5 = resolvedRefCache.get(refValue);
+        if (cached5)
+          return cached5;
         const resolved = yield* refs.resolve(refValue);
         resolvedRefCache.set(refValue, resolved);
         return resolved;
@@ -96398,13 +96741,16 @@ function collectApiHealthUseCase(params3) {
     const clientsRes = yield* ws.queryClients({ url: cfg.wsUrl, timeoutMs: 2000 }).pipe(either3);
     const queueStats2 = yield* queue.stats({ dbPath: cfg.storeDb }).pipe(either3);
     return {
-      api: { running: true, healthy: true, pid: params3.pid, startedAt: params3.startedAt },
+      runtime: currentRuntimeBuildInfo(),
+      api: { running: true, healthy: true, pid: params3.pid, startedAt: params3.startedAt, build: currentRuntimeBuildInfo() },
       daemon: {
         running: wsHealth._tag === "Right",
         healthy: wsHealth._tag === "Right",
-        wsUrl: cfg.wsUrl
+        wsUrl: cfg.wsUrl,
+        build: null
       },
       activeWorkerConnId: clientsRes._tag === "Right" ? clientsRes.right.activeWorkerConnId ?? null : null,
+      clients: clientsRes._tag === "Right" ? clientsRes.right.clients : [],
       queue: queueStats2._tag === "Right" ? {
         available: true,
         pending: queueStats2.right.pending ?? 0,
@@ -96432,6 +96778,22 @@ function collectApiStatusUseCase(params3) {
     const queueReady = health.queue?.available === true;
     const writeReady = queueReady && pluginRpcReady;
     const bindingSource = workspaceResolution.bindingSource ?? (cfg.remnoteDb ? "config" : workspaceResolution.source === "unresolved" ? undefined : workspaceResolution.source);
+    const activeWorkerRuntime = typeof health.activeWorkerConnId === "string" && Array.isArray(health?.clients) ? health.clients.find((client) => client.connId === health.activeWorkerConnId)?.runtime ?? null : null;
+    const warnings = [
+      ...runtimeVersionWarnings({
+        current: currentRuntimeBuildInfo()
+      }),
+      ...pluginBuildWarnings({
+        expected: currentExpectedPluginBuildInfo(),
+        live: activeWorkerRuntime
+      })
+    ];
+    if (health.api?.running === true && !health?.api?.build) {
+      warnings.push("host api state has no build info; restart the api service to refresh runtime metadata");
+    }
+    if (health.activeWorkerConnId && !activeWorkerRuntime) {
+      warnings.push("active worker did not report runtime metadata; reload the RemNote plugin");
+    }
     return {
       ...health,
       capabilities: {
@@ -96451,7 +96813,11 @@ function collectApiStatusUseCase(params3) {
       },
       plugin: {
         ws_healthy: health.daemon.healthy,
-        active_worker_conn_id: health.activeWorkerConnId
+        active_worker_conn_id: health.activeWorkerConnId,
+        active_worker: health.activeWorkerConnId ? {
+          conn_id: health.activeWorkerConnId,
+          runtime: activeWorkerRuntime
+        } : null
       },
       write: {
         daemon_ready: health.daemon.healthy,
@@ -96459,7 +96825,8 @@ function collectApiStatusUseCase(params3) {
         worker_ready: pluginRpcReady
       },
       uiContext,
-      selection
+      selection,
+      warnings
     };
   });
 }
@@ -97636,11 +98003,11 @@ var applyCommand = exports_Command.make("apply", {
 
 // src/services/ApiDaemonFiles.ts
 import { promises as fs19 } from "node:fs";
-import path25 from "node:path";
+import path28 from "node:path";
 class ApiDaemonFiles extends Tag2("ApiDaemonFiles")() {
 }
 function ensureDir9(p3) {
-  return fs19.mkdir(path25.dirname(p3), { recursive: true }).then(() => {
+  return fs19.mkdir(path28.dirname(p3), { recursive: true }).then(() => {
     return;
   });
 }
@@ -97648,19 +98015,19 @@ function defaultPidFile2() {
   const envPidFile = process.env.REMNOTE_API_PID_FILE;
   if (typeof envPidFile === "string" && envPidFile.trim())
     return resolveUserFilePath(envPidFile);
-  return path25.join(homeDir(), ".agent-remnote", "api.pid");
+  return path28.join(homeDir(), ".agent-remnote", "api.pid");
 }
 function defaultLogFile2() {
   const envLogFile = process.env.REMNOTE_API_LOG_FILE;
   if (typeof envLogFile === "string" && envLogFile.trim())
     return resolveUserFilePath(envLogFile);
-  return path25.join(homeDir(), ".agent-remnote", "api.log");
+  return path28.join(homeDir(), ".agent-remnote", "api.log");
 }
 function defaultStateFile2() {
   const envStateFile = process.env.REMNOTE_API_STATE_FILE;
   if (typeof envStateFile === "string" && envStateFile.trim())
     return resolveUserFilePath(envStateFile);
-  return path25.join(homeDir(), ".agent-remnote", "api.state.json");
+  return path28.join(homeDir(), ".agent-remnote", "api.state.json");
 }
 function parseJson2(raw4, filePath) {
   try {
@@ -97806,6 +98173,7 @@ function childCommandLine2(params3) {
 function toPidFileValue2(params3) {
   return {
     pid: params3.pid,
+    build: currentRuntimeBuildInfo(),
     started_at: params3.startedAt,
     host: params3.host,
     port: params3.port,
@@ -98513,6 +98881,7 @@ function runHttpApiRuntime(params3) {
     yield* apiFiles.writeStateFile(stateFilePath, {
       running: true,
       pid: process.pid,
+      build: currentRuntimeBuildInfo(),
       host: host3,
       port: actualPort,
       basePath: basePath2,
@@ -98610,9 +98979,11 @@ var apiStatusCommand = exports_Command.make("status", { pidFile: pidFile12, stat
   const health = yield* api.health({ baseUrl: localBaseUrl, timeoutMs: API_HEALTH_TIMEOUT_MS }).pipe(either3);
   const status2 = yield* api.status({ baseUrl: localBaseUrl, timeoutMs: API_HEALTH_TIMEOUT_MS }).pipe(either3);
   const data = {
+    runtime: currentRuntimeBuildInfo(),
     service: {
       running: running4,
       pid: pid ?? null,
+      build: pidInfo?.build ?? state?.build ?? null,
       pid_file: pidFilePath,
       log_file: pidInfo?.log_file ?? cfg.apiLogFile ?? apiFiles.defaultLogFile(),
       state_file: pidInfo?.state_file ?? stateFilePath,
@@ -98625,7 +98996,16 @@ var apiStatusCommand = exports_Command.make("status", { pidFile: pidFile12, stat
       base_path: basePath2,
       status: status2._tag === "Right" ? status2.right : null,
       error: health._tag === "Left" ? health.left.message : undefined
-    }
+    },
+    warnings: status2._tag === "Right" ? runtimeVersionWarnings({
+      current: currentRuntimeBuildInfo(),
+      api: pidInfo?.build ?? state?.build ?? null,
+      daemon: status2.right?.daemon?.build ?? null,
+      plugin: status2.right?.plugin?.active_worker?.runtime ?? null
+    }) : runtimeVersionWarnings({
+      current: currentRuntimeBuildInfo(),
+      api: pidInfo?.build ?? state?.build ?? null
+    })
   };
   const md = [
     `- service_running: ${data.service.running}`,
@@ -99502,11 +99882,11 @@ function waitForPluginServerHealth(baseUrl, waitMs, timeoutMs3) {
 
 // src/services/PluginServerFiles.ts
 import { promises as fs20 } from "node:fs";
-import path26 from "node:path";
+import path29 from "node:path";
 class PluginServerFiles extends Tag2("PluginServerFiles")() {
 }
 function ensureDir10(p3) {
-  return fs20.mkdir(path26.dirname(p3), { recursive: true }).then(() => {
+  return fs20.mkdir(path29.dirname(p3), { recursive: true }).then(() => {
     return;
   });
 }
@@ -99514,19 +99894,19 @@ function defaultPidFile3() {
   const envPidFile = process.env.REMNOTE_PLUGIN_SERVER_PID_FILE;
   if (typeof envPidFile === "string" && envPidFile.trim())
     return resolveUserFilePath(envPidFile);
-  return path26.join(homeDir(), ".agent-remnote", "plugin-server.pid");
+  return path29.join(homeDir(), ".agent-remnote", "plugin-server.pid");
 }
 function defaultLogFile3() {
   const envLogFile = process.env.REMNOTE_PLUGIN_SERVER_LOG_FILE;
   if (typeof envLogFile === "string" && envLogFile.trim())
     return resolveUserFilePath(envLogFile);
-  return path26.join(homeDir(), ".agent-remnote", "plugin-server.log");
+  return path29.join(homeDir(), ".agent-remnote", "plugin-server.log");
 }
 function defaultStateFile3() {
   const envStateFile = process.env.REMNOTE_PLUGIN_SERVER_STATE_FILE;
   if (typeof envStateFile === "string" && envStateFile.trim())
     return resolveUserFilePath(envStateFile);
-  return path26.join(homeDir(), ".agent-remnote", "plugin-server.state.json");
+  return path29.join(homeDir(), ".agent-remnote", "plugin-server.state.json");
 }
 function parseJson3(raw4, filePath) {
   try {
@@ -99674,6 +100054,7 @@ function childCommandLine3(params3) {
 function toPidFileValue3(params3) {
   return {
     pid: params3.pid,
+    build: currentRuntimeBuildInfo(),
     started_at: params3.startedAt,
     host: params3.host,
     port: params3.port,
@@ -99978,55 +100359,12 @@ var pluginSearchCommand = exports_Command.make("search", { query: text9("query")
 `) });
 }).pipe(catchAll2(writeFailure)));
 
-// src/lib/pluginArtifacts.ts
-import { existsSync as existsSync2, statSync } from "node:fs";
-import path27 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-function currentDir(moduleUrl) {
-  return path27.dirname(fileURLToPath2(moduleUrl));
-}
-function isDirectory(targetPath) {
-  try {
-    return statSync(targetPath).isDirectory();
-  } catch {
-    return false;
-  }
-}
-function distCandidates(moduleUrl) {
-  const dir2 = currentDir(moduleUrl);
-  return [
-    path27.resolve(dir2, "../../plugin-artifacts/dist"),
-    path27.resolve(dir2, "../plugin-artifacts/dist"),
-    path27.resolve(dir2, "../../../plugin/dist"),
-    path27.resolve(dir2, "../../plugin/dist")
-  ];
-}
-function validateDistPath(targetPath) {
-  return isDirectory(targetPath) && existsSync2(path27.join(targetPath, "manifest.json"));
-}
-function resolvePluginDistPath(moduleUrl = import.meta.url) {
-  for (const candidate of distCandidates(moduleUrl)) {
-    if (validateDistPath(candidate))
-      return candidate;
-  }
-  throw new CliError({
-    code: "DEPENDENCY_MISSING",
-    message: "Plugin build artifacts are unavailable",
-    exitCode: 1,
-    details: { candidates: distCandidates(moduleUrl) },
-    hint: [
-      "Run npm run build --workspace @remnote/plugin in the repository checkout",
-      "Or install a packaged agent-remnote release that includes plugin artifacts"
-    ]
-  });
-}
-
 // src/runtime/plugin-static/runPluginStaticRuntime.ts
 import { createServer as createServer2 } from "node:http";
 
 // src/lib/pluginStaticFiles.ts
 import { promises as fs21 } from "node:fs";
-import path28 from "node:path";
+import path30 from "node:path";
 var CONTENT_TYPES = new Map([
   [".css", "text/css; charset=utf-8"],
   [".html", "text/html; charset=utf-8"],
@@ -100036,7 +100374,7 @@ var CONTENT_TYPES = new Map([
   [".txt", "text/plain; charset=utf-8"]
 ]);
 function contentTypeFor(filePath) {
-  return CONTENT_TYPES.get(path28.extname(filePath).toLowerCase()) ?? "application/octet-stream";
+  return CONTENT_TYPES.get(path30.extname(filePath).toLowerCase()) ?? "application/octet-stream";
 }
 function normalizeAssetPath(pathname) {
   let decoded;
@@ -100046,7 +100384,7 @@ function normalizeAssetPath(pathname) {
     return null;
   }
   const raw4 = decoded === "/" ? "index.html" : decoded.replace(/^\/+/, "");
-  const normalized = path28.posix.normalize(raw4);
+  const normalized = path30.posix.normalize(raw4);
   if (!normalized || normalized === "." || normalized.startsWith("../") || normalized === "..")
     return null;
   return normalized;
@@ -100060,8 +100398,8 @@ async function readPluginStaticAsset(params3) {
   if (!relativePath) {
     return { ok: false, statusCode: 404, message: "Not found" };
   }
-  const filePath = path28.resolve(params3.distPath, relativePath);
-  if (filePath !== params3.distPath && !filePath.startsWith(`${params3.distPath}${path28.sep}`)) {
+  const filePath = path30.resolve(params3.distPath, relativePath);
+  if (filePath !== params3.distPath && !filePath.startsWith(`${params3.distPath}${path30.sep}`)) {
     return { ok: false, statusCode: 404, message: "Not found" };
   }
   try {
@@ -100219,6 +100557,8 @@ var pluginServeCommand = exports_Command.make("serve", { host: host7, port: port
         yield* files.writeStateFile(stateFilePath, {
           running: true,
           pid: process.pid,
+          build: currentRuntimeBuildInfo(),
+          plugin_build: readPluginDistBuildInfo(distPath2) ?? undefined,
           host: host9,
           port: port11,
           startedAt: Date.now(),
@@ -100292,10 +100632,29 @@ function getPluginStatus(params3) {
     const port11 = pidInfo?.port ?? state?.port ?? PLUGIN_SERVER_DEFAULT_PORT;
     const baseUrl = pluginServerLocalBaseUrl(host9, port11);
     const health = yield* checkPluginServerHealth(baseUrl, PLUGIN_SERVER_HEALTH_TIMEOUT_MS).pipe(either3);
+    const runtime6 = currentRuntimeBuildInfo();
+    const serviceBuild = pidInfo?.build ?? state?.build ?? null;
+    const pluginBuild = state?.plugin_build ?? null;
+    const warnings = [];
+    if (serviceBuild && serviceBuild.build_id !== runtime6.build_id) {
+      warnings.push(`plugin server process build mismatch: current=${runtime6.build_id} live=${serviceBuild.build_id}`);
+    }
+    const expectedPluginBuild = currentExpectedPluginBuildInfo();
+    if (expectedPluginBuild && pluginBuild && pluginBuild.build_id !== expectedPluginBuild.build_id) {
+      warnings.push(`served plugin build mismatch: expected=${expectedPluginBuild.build_id} live=${pluginBuild.build_id}`);
+    }
+    if (running4 && !serviceBuild) {
+      warnings.push("plugin server pid/state metadata has no build info; restart plugin server to refresh runtime metadata");
+    }
+    if (running4 && !pluginBuild) {
+      warnings.push("served plugin artifact build info is unavailable; rebuild plugin artifacts and restart plugin server");
+    }
     return {
+      runtime: runtime6,
       service: {
         running: running4,
         pid: pid ?? null,
+        build: serviceBuild,
         pid_file: params3.pidFilePath,
         log_file: pidInfo?.log_file ?? files.defaultLogFile(),
         state_file: effectiveStateFilePath,
@@ -100308,8 +100667,10 @@ function getPluginStatus(params3) {
         host: host9,
         port: port11,
         dist_path: state?.distPath ?? "",
+        build: pluginBuild,
         error: health._tag === "Left" ? health.left.message : undefined
-      }
+      },
+      warnings: warnings.length > 0 ? warnings : undefined
     };
   });
 }
@@ -101091,6 +101452,237 @@ function compileTableValueOps(params3) {
   return ops;
 }
 
+// src/commands/write/_refValue.ts
+function invalidArgs(message2, details) {
+  return new CliError({
+    code: "INVALID_ARGS",
+    message: message2,
+    exitCode: 2,
+    details
+  });
+}
+function normalizeRefValue(raw4) {
+  const trimmed2 = raw4.trim();
+  const link3 = tryParseRemnoteLink(trimmed2);
+  if (link3?.remId)
+    return link3.remId;
+  return trimmed2;
+}
+function looksLikeRefValue(raw4) {
+  const value8 = raw4.trim();
+  if (!value8)
+    return false;
+  if (value8.startsWith("remnote://") || value8.startsWith("http://") || value8.startsWith("https://"))
+    return true;
+  const idx = value8.indexOf(":");
+  if (idx <= 0)
+    return false;
+  const prefix2 = value8.slice(0, idx).trim().toLowerCase();
+  return prefix2 === "id" || prefix2 === "page" || prefix2 === "title" || prefix2 === "daily";
+}
+function resolveRefValue(raw4) {
+  return gen2(function* () {
+    const normalized = normalizeRefValue(raw4);
+    if (!normalized) {
+      return yield* fail8(invalidArgs(`Invalid ref value: ${raw4}`));
+    }
+    if (!looksLikeRefValue(raw4))
+      return normalized;
+    const refs = yield* RefResolver;
+    return yield* refs.resolve(raw4);
+  });
+}
+
+// src/commands/write/_placementSpec.ts
+function invalidArgs2(message2, details) {
+  return new CliError({
+    code: "INVALID_ARGS",
+    message: message2,
+    exitCode: 2,
+    details
+  });
+}
+function invalidPlacementSpec(optionName, raw4) {
+  return new CliError({
+    code: "INVALID_ARGS",
+    message: `Invalid ${optionName} placement spec: ${raw4}`,
+    exitCode: 2,
+    details: { option: optionName, value: raw4 },
+    hint: [
+      `Examples: ${optionName} standalone`,
+      `Examples: ${optionName} parent:id:P1`,
+      `Examples: ${optionName} parent[2]:id:P1`,
+      `Examples: ${optionName} before:id:R1`,
+      `Examples: ${optionName} after:id:R1`
+    ]
+  });
+}
+function parsePlacementSpec(raw4, options6) {
+  return gen2(function* () {
+    const optionName = options6?.optionName ?? "--at";
+    const allowStandalone = options6?.allowStandalone !== false;
+    const text15 = raw4.trim();
+    if (!text15) {
+      return yield* fail8(invalidArgs2(`${optionName} requires a placement spec`, { option: optionName, value: raw4 }));
+    }
+    if (text15 === "standalone") {
+      if (!allowStandalone) {
+        return yield* fail8(invalidArgs2(`${optionName} does not allow standalone placement`, { option: optionName, value: raw4 }));
+      }
+      return { kind: "standalone" };
+    }
+    const parentMatch = /^parent(?:\[(\d+)\])?:(.+)$/.exec(text15);
+    if (parentMatch) {
+      const positionText = parentMatch[1];
+      const parentRef = normalizeRefValue(parentMatch[2] ?? "");
+      if (!parentRef) {
+        return yield* fail8(invalidPlacementSpec(optionName, raw4));
+      }
+      const parsedPosition = positionText === undefined ? undefined : Number.parseInt(positionText, 10);
+      if (positionText !== undefined && (parsedPosition === undefined || !Number.isFinite(parsedPosition) || parsedPosition < 0)) {
+        return yield* fail8(invalidPlacementSpec(optionName, raw4));
+      }
+      const position3 = parsedPosition;
+      return {
+        kind: "parent",
+        parentRef,
+        ...position3 !== undefined ? { position: position3 } : {}
+      };
+    }
+    const beforeMatch = /^before:(.+)$/.exec(text15);
+    if (beforeMatch) {
+      const anchorRef = normalizeRefValue(beforeMatch[1] ?? "");
+      if (!anchorRef) {
+        return yield* fail8(invalidPlacementSpec(optionName, raw4));
+      }
+      return { kind: "before", anchorRef };
+    }
+    const afterMatch = /^after:(.+)$/.exec(text15);
+    if (afterMatch) {
+      const anchorRef = normalizeRefValue(afterMatch[1] ?? "");
+      if (!anchorRef) {
+        return yield* fail8(invalidPlacementSpec(optionName, raw4));
+      }
+      return { kind: "after", anchorRef };
+    }
+    return yield* fail8(invalidPlacementSpec(optionName, raw4));
+  });
+}
+function fetchRemLayouts(db, ids3) {
+  const unique = Array.from(new Set(ids3.map((id3) => String(id3 ?? "").trim()).filter(Boolean)));
+  if (unique.length === 0)
+    return new Map;
+  const placeholders = unique.map(() => "?").join(",");
+  const stmt = db.prepare(`SELECT _id AS id,
+            json_extract(doc, '$.parent') AS parentId,
+            json_extract(doc, '$.f') AS sortKey
+       FROM quanta
+      WHERE _id IN (${placeholders})`);
+  const rows = stmt.all(...unique);
+  const out = new Map;
+  for (const row of rows) {
+    const id3 = String(row.id ?? "").trim();
+    if (!id3)
+      continue;
+    out.set(id3, {
+      id: id3,
+      parentId: typeof row.parentId === "string" && row.parentId.trim() ? row.parentId.trim() : null,
+      sortKey: typeof row.sortKey === "string" && row.sortKey.trim() ? row.sortKey.trim() : null
+    });
+  }
+  return out;
+}
+function listSiblingOrder(db, parentId) {
+  const stmt = db.prepare(`SELECT _id AS id
+       FROM quanta
+      WHERE json_extract(doc, '$.parent') = ?
+      ORDER BY json_extract(doc, '$.f')`);
+  const rows = stmt.all(parentId);
+  return rows.map((row) => String(row.id ?? "").trim()).filter(Boolean);
+}
+function resolveLocalDbPath() {
+  return gen2(function* () {
+    yield* failInRemoteMode({
+      command: "write placement resolution",
+      reason: "this path still reads local RemNote hierarchy metadata to resolve before/after placement"
+    });
+    const cfg = yield* AppConfig;
+    if (cfg.remnoteDb)
+      return cfg.remnoteDb;
+    const workspace = yield* resolveWorkspaceSnapshot({}).pipe(catchAll2(() => succeed8(undefined)));
+    const dbPath = workspace?.resolved ? workspace.dbPath : undefined;
+    if (dbPath)
+      return dbPath;
+    return yield* fail8(new CliError({
+      code: "WORKSPACE_UNRESOLVED",
+      message: "Workspace is unresolved for write placement resolution",
+      exitCode: 1
+    }));
+  });
+}
+function resolveAnchorPlacement(params3) {
+  return gen2(function* () {
+    const remDb = yield* RemDb;
+    const dbPath = yield* resolveLocalDbPath();
+    const anchorId = yield* resolveRefValue(params3.anchorRef);
+    const layouts = yield* remDb.withDb(dbPath, async (db) => fetchRemLayouts(db, [anchorId])).pipe(map17((result) => result.result));
+    const layout = layouts.get(anchorId);
+    if (!layout) {
+      return yield* fail8(invalidArgs2(`Anchor Rem not found: ${params3.anchorRef}`, { anchor_ref: params3.anchorRef }));
+    }
+    if (!layout.parentId) {
+      return yield* fail8(invalidArgs2("Anchor-relative placement requires an anchor with a parent (top-level anchors are unsupported)", {
+        anchor_ref: params3.anchorRef,
+        anchor_id: anchorId
+      }));
+    }
+    const siblingOrder = yield* remDb.withDb(dbPath, async (db) => listSiblingOrder(db, layout.parentId)).pipe(map17((result) => result.result));
+    const index = siblingOrder.indexOf(anchorId);
+    if (index < 0) {
+      return yield* fail8(invalidArgs2("Failed to resolve anchor sibling position", {
+        anchor_ref: params3.anchorRef,
+        anchor_id: anchorId
+      }));
+    }
+    return {
+      parentId: layout.parentId,
+      position: index + params3.offset
+    };
+  });
+}
+function resolvePlacementSpec(spec) {
+  return gen2(function* () {
+    switch (spec.kind) {
+      case "standalone":
+        return { kind: "standalone" };
+      case "parent":
+        return {
+          kind: "parent",
+          parentId: yield* resolveRefValue(spec.parentRef),
+          ...spec.position !== undefined ? { position: spec.position } : {}
+        };
+      case "before": {
+        const resolved = yield* resolveAnchorPlacement({ anchorRef: spec.anchorRef, offset: 0 });
+        return { kind: "before", parentId: resolved.parentId, position: resolved.position };
+      }
+      case "after": {
+        const resolved = yield* resolveAnchorPlacement({ anchorRef: spec.anchorRef, offset: 1 });
+        return { kind: "after", parentId: resolved.parentId, position: resolved.position };
+      }
+    }
+  });
+}
+function resolveTreePlacementSpec(spec, options6) {
+  return gen2(function* () {
+    const optionName = options6?.optionName ?? "--at";
+    const resolved = yield* resolvePlacementSpec(spec);
+    if (resolved.kind === "standalone") {
+      return yield* fail8(invalidArgs2(`${optionName} does not allow standalone placement`, { option: optionName }));
+    }
+    return resolved;
+  });
+}
+
 // src/commands/write/_shared.ts
 function optionToUndefined43(opt) {
   return isSome2(opt) ? opt.value : undefined;
@@ -101110,6 +101702,71 @@ var writeCommonOptions = {
   idempotencyKey: readOptionalText3("idempotency-key"),
   meta: readOptionalText3("meta")
 };
+function invalidArgs3(message2, details) {
+  return new CliError({
+    code: "INVALID_ARGS",
+    message: message2,
+    exitCode: 2,
+    details
+  });
+}
+function normalizeOptionalText2(raw4) {
+  const trimmed2 = typeof raw4 === "string" ? raw4.trim() : "";
+  return trimmed2 ? trimmed2 : undefined;
+}
+function normalizeString2(value8) {
+  return typeof value8 === "string" ? value8.trim() : "";
+}
+function requireStableSiblingRange(params3) {
+  return gen2(function* () {
+    const remDb = yield* RemDb;
+    const dbPath = yield* resolveLocalDbPath();
+    const layouts = yield* remDb.withDb(dbPath, async (db) => fetchRemLayouts(db, params3.remIds)).pipe(map17((result) => result.result));
+    const entries2 = params3.remIds.map((id3) => layouts.get(id3)).filter((value8) => Boolean(value8));
+    if (entries2.length !== params3.remIds.length) {
+      return yield* fail8(invalidArgs3(params3.missingMessage, {
+        expected: params3.remIds.length,
+        resolved: entries2.length
+      }));
+    }
+    const parentIds = Array.from(new Set(entries2.map((entry) => entry.parentId).filter((value8) => Boolean(value8))));
+    if (parentIds.length !== 1) {
+      return yield* fail8(invalidArgs3(params3.mismatchMessage, {
+        parent_count: parentIds.length
+      }));
+    }
+    const siblingOrder = yield* remDb.withDb(dbPath, async (db) => listSiblingOrder(db, parentIds[0])).pipe(map17((result) => result.result));
+    const indexed = entries2.map((entry) => ({ id: entry.id, index: siblingOrder.indexOf(entry.id) })).sort((a, b) => a.index - b.index);
+    const first3 = indexed[0];
+    if (!first3 || first3.index < 0) {
+      return yield* fail8(invalidArgs3("Failed to resolve sibling placement"));
+    }
+    for (let offset3 = 0;offset3 < indexed.length; offset3 += 1) {
+      const current2 = indexed[offset3];
+      if (current2.index !== first3.index + offset3) {
+        return yield* fail8(invalidArgs3(params3.mismatchMessage, {
+          actual_positions: indexed.map((item) => item.index)
+        }));
+      }
+    }
+    return {
+      orderedRemIds: indexed.map((item) => item.id),
+      parentId: parentIds[0],
+      position: first3.index
+    };
+  });
+}
+function resolveCreateDestinationTitle(params3) {
+  return gen2(function* () {
+    const destinationTitle = params3.explicitTitle ?? params3.inferredTitle;
+    if (destinationTitle)
+      return destinationTitle;
+    if (params3.sourceKind === "explicit_from") {
+      return yield* fail8(invalidArgs3(params3.sourceCount > 1 ? "rem create with multiple --from values requires --title" : "rem create could not infer a title from the single --from Rem; pass --title explicitly"));
+    }
+    return yield* fail8(invalidArgs3(params3.sourceCount > 1 ? "rem create --from-selection with multiple selected roots requires --title" : "rem create --from-selection could not infer a title from the single selected Rem; pass --title explicitly"));
+  });
+}
 
 // src/commands/write/powerup/apply.ts
 var dispatchMode = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
@@ -103094,186 +103751,36 @@ var readResolveRefCommand = exports_Command.make("resolve-ref", {
   yield* writeSuccess({ data: result, md: result.markdown ?? "" });
 }).pipe(catchAll2(writeFailure)));
 
-// src/commands/write/rem/create.ts
-function normalizeRemIdInput2(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
-}
-var tag8 = text9("tag").pipe(repeated5);
-var writeRemCreateCommand = exports_Command.make("create", {
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
-  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
-  isDocument: boolean8("is-document"),
-  tag: tag8,
-  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
-  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined43)),
-  forceText: boolean8("force-text"),
-  notify: writeCommonOptions.notify,
-  ensureDaemon: writeCommonOptions.ensureDaemon,
-  wait: writeCommonOptions.wait,
-  timeoutMs: writeCommonOptions.timeoutMs,
-  pollMs: writeCommonOptions.pollMs,
-  dryRun: writeCommonOptions.dryRun,
-  priority: writeCommonOptions.priority,
-  clientId: writeCommonOptions.clientId,
-  idempotencyKey: writeCommonOptions.idempotencyKey,
-  meta: writeCommonOptions.meta
-}, ({
-  parent,
-  ref: ref3,
-  text: text16,
-  isDocument,
-  tag: tag9,
-  position: position3,
-  clientTempId,
-  forceText: forceText2,
-  notify: notify3,
-  ensureDaemon: ensureDaemon5,
-  wait: wait3,
-  timeoutMs: timeoutMs4,
-  pollMs: pollMs3,
-  dryRun,
-  priority: priority3,
-  clientId: clientId3,
-  idempotencyKey: idempotencyKey3,
-  meta
-}) => gen2(function* () {
-  if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Use --wait to enable --timeout-ms/--poll-ms",
-      exitCode: 2
-    }));
-  }
-  if (dryRun && wait3) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "--wait is not compatible with --dry-run",
-      exitCode: 2
-    }));
-  }
-  if (parent && ref3) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Choose only one of --parent or --ref",
-      exitCode: 2
-    }));
-  }
-  if (!parent && !ref3) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "You must provide --parent or --ref",
-      exitCode: 2
-    }));
-  }
-  if (position3 !== undefined && (!Number.isFinite(position3) || position3 < 0)) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "--position must be a non-negative integer",
-      exitCode: 2,
-      details: { position: position3 }
-    }));
-  }
-  const cfg = yield* AppConfig;
-  const refs = yield* RefResolver;
-  const payloadSvc = yield* Payload;
-  const resolvedRef = ref3 ?? "";
-  const parentId = typeof parent === "string" ? normalizeRemIdInput2(parent) : dryRun ? normalizeRemIdInput2(resolvedRef) : yield* refs.resolve(resolvedRef);
-  const tags2 = Array.isArray(tag9) ? tag9.map(normalizeRemIdInput2).filter(Boolean) : [];
-  const remClientTempId = clientTempId ? String(clientTempId).trim() : makeTempId();
-  const textValue = text16 !== undefined ? trimBoundaryBlankLines(text16) : undefined;
-  if (textValue && !forceText2 && looksLikeStructuredMarkdown2(textValue)) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Input passed to --text looks like structured Markdown. Use rem children append --rem <parentRemId> --markdown ... instead, or pass --force-text to keep it literal.",
-      exitCode: 2
-    }));
-  }
-  const payload2 = {
-    parentId,
-    clientTempId: remClientTempId
-  };
-  if (textValue !== undefined)
-    payload2.text = textValue;
-  if (isDocument)
-    payload2.isDocument = true;
-  if (tags2.length > 0)
-    payload2.tags = tags2;
-  if (position3 !== undefined)
-    payload2.position = position3;
-  const op2 = yield* try_3({
-    try: () => normalizeOp({ type: "create_rem", payload: payload2 }, payloadSvc.normalizeKeys),
-    catch: (e) => isCliError(e) ? e : new CliError({
-      code: "INVALID_PAYLOAD",
-      message: "Failed to generate op",
-      exitCode: 2,
-      details: { error: String(e?.message || e) }
-    })
-  });
-  const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
-  if (dryRun) {
-    yield* writeSuccess({
-      data: {
-        dry_run: true,
-        rem_client_temp_id: remClientTempId,
-        ops: [op2],
-        meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined
-      },
-      md: `- dry_run: true
-- op: create_rem
-- rem_client_temp_id: ${remClientTempId}
-`
-    });
-    return;
-  }
-  const data = yield* enqueueOps({
-    ops: [op2],
-    priority: priority3,
-    clientId: clientId3,
-    idempotencyKey: idempotencyKey3,
-    meta: metaValue,
-    notify: notify3,
-    ensureDaemon: ensureDaemon5
+// src/commands/write/_portalStrategy.ts
+function invalidArgs4(message2, details) {
+  return new CliError({
+    code: "INVALID_ARGS",
+    message: message2,
+    exitCode: 2,
+    details
   });
-  const waited = wait3 ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs4, pollMs: pollMs3 }) : null;
-  const queue = yield* Queue;
-  const created = waited && waited.is_success === true ? yield* gen2(function* () {
-    let idMap = Array.isArray(waited?.id_map) ? waited.id_map : [];
-    if (idMap.length === 0) {
-      const inspected = yield* queue.inspect({ dbPath: cfg.storeDb, txnId: data.txn_id }).pipe(catchAll2(() => succeed8({ id_map: [] })));
-      idMap = Array.isArray(inspected?.id_map) ? inspected.id_map : [];
+}
+function parsePortalStrategy(raw4) {
+  return gen2(function* () {
+    const text16 = typeof raw4 === "string" ? raw4.trim() : "";
+    if (!text16)
+      return { kind: "none" };
+    if (text16 === "in-place")
+      return { kind: "in_place" };
+    if (!text16.startsWith("at:")) {
+      return yield* fail8(invalidArgs4(`Invalid --portal strategy: ${raw4}`, { option: "--portal", value: raw4 }));
     }
-    const match24 = idMap.find((r) => String(r?.client_temp_id ?? "") === remClientTempId);
-    const remoteId = match24?.remote_id ? String(match24.remote_id) : "";
-    return remoteId ? { rem_id: remoteId, id_map: idMap } : { id_map: idMap };
-  }) : {};
-  const out = waited ? { ...data, ...waited, rem_client_temp_id: remClientTempId, ...created } : { ...data, rem_client_temp_id: remClientTempId };
-  yield* writeSuccess({
-    data: out,
-    ids: [data.txn_id, ...data.op_ids],
-    md: [
-      `- txn_id: ${data.txn_id}`,
-      `- op_ids: ${data.op_ids.length}`,
-      `- notified: ${data.notified}`,
-      `- sent: ${data.sent ?? ""}`,
-      `- rem_client_temp_id: ${remClientTempId}`,
-      ...waited ? [`- status: ${waited.status}`, `- elapsed_ms: ${waited.elapsed_ms}`] : []
-    ].join(`
-`)
+    const placement = yield* parsePlacementSpec(text16.slice(3), {
+      optionName: "--portal",
+      allowStandalone: false
+    });
+    return { kind: "at", placement };
   });
-}).pipe(catchAll2(writeFailure)));
+}
 
 // src/commands/write/rem/children/common.ts
-function normalizeRemIdInput3(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
+function resolveSubjectRemId(raw4) {
+  return resolveRefValue(raw4);
 }
 function ensureWaitArgs(params3) {
   return gen2(function* () {
@@ -103449,9 +103956,720 @@ function extractReplaceBackupSummary(txnDetail) {
   };
 }
 
+// src/commands/write/rem/_promotion.ts
+var DURABLE_TARGET_ALIAS = "durable_target";
+var PORTAL_REM_ALIAS = "portal_rem";
+function truncateText3(value8, maxLength) {
+  const normalized = value8.replace(/\s+/g, " ").trim();
+  if (!normalized)
+    return "";
+  if (normalized.length <= maxLength)
+    return normalized;
+  return `${normalized.slice(0, maxLength)}...`;
+}
+function pickTitle3(kt, ke, r) {
+  const combined = [kt, ke].map(normalizeString2).filter(Boolean).join(" | ");
+  const raw4 = combined || normalizeString2(r);
+  if (!raw4)
+    return "";
+  const normalized = raw4.replace(/\s+/g, " ").trim();
+  const title = normalized.split(/\n| - |——|。|！|？|\.|: /)[0]?.trim() || normalized;
+  return truncateText3(title, 80);
+}
+function fetchRemTitleMap3(db, ids4) {
+  const unique = Array.from(new Set(ids4.map((id5) => String(id5 ?? "").trim()).filter(Boolean)));
+  if (unique.length === 0)
+    return new Map;
+  const placeholders = unique.map(() => "?").join(",");
+  const stmt = db.prepare(`SELECT id,
+            json_extract(doc, '$.kt') AS kt,
+            json_extract(doc, '$.ke') AS ke,
+            json_extract(doc, '$.r') AS r
+       FROM remsSearchInfos
+      WHERE id IN (${placeholders})`);
+  const rows = stmt.all(...unique);
+  const map39 = new Map;
+  for (const row of rows) {
+    const id5 = String(row.id ?? "").trim();
+    if (!id5)
+      continue;
+    map39.set(id5, pickTitle3(row.kt, row.ke, row.r));
+  }
+  return map39;
+}
+function readSingleRemTitle(params3) {
+  return gen2(function* () {
+    const ids4 = Array.from(new Set(params3.ids.map((id5) => String(id5 ?? "").trim()).filter(Boolean)));
+    if (ids4.length !== 1)
+      return;
+    const selectionTitle = normalizeOptionalText2(params3.selectionTitle);
+    if (selectionTitle)
+      return selectionTitle;
+    const cfg = yield* AppConfig;
+    if (cfg.apiBaseUrl)
+      return;
+    const remDb = yield* RemDb;
+    const workspace = cfg.remnoteDb ? undefined : yield* resolveWorkspaceSnapshot({}).pipe(catchAll2(() => succeed8(undefined)));
+    const dbPath = cfg.remnoteDb ?? (workspace?.resolved ? workspace.dbPath : undefined);
+    if (!dbPath)
+      return;
+    const titleMap = yield* remDb.withDb(dbPath, async (db) => fetchRemTitleMap3(db, ids4)).pipe(map17((value8) => value8.result), catchAll2(() => succeed8(new Map)));
+    return normalizeOptionalText2(titleMap.get(ids4[0]));
+  });
+}
+function convertPortalAtPlacement(strategy) {
+  return gen2(function* () {
+    if (strategy.kind !== "at" || strategy.placement.kind === "standalone") {
+      return yield* fail8(invalidArgs3("Invalid --portal strategy", { portal: strategy }));
+    }
+    switch (strategy.placement.kind) {
+      case "parent":
+        return { kind: "parent", parentRef: strategy.placement.parentRef };
+      case "before":
+        return { kind: "before", anchorRef: strategy.placement.anchorRef };
+      case "after":
+        return { kind: "after", anchorRef: strategy.placement.anchorRef };
+    }
+  });
+}
+function convertMovePortalPlacement(strategy) {
+  return gen2(function* () {
+    if (strategy.kind === "none")
+      return { kind: "none" };
+    if (strategy.kind === "in_place")
+      return { kind: "in_place_single_rem" };
+    const converted = yield* convertPortalAtPlacement(strategy);
+    return converted;
+  });
+}
+function normalizeExplicitFromSource(params3) {
+  return gen2(function* () {
+    const uniqueRemIds = Array.from(new Set(params3.remIds.map((id5) => String(id5 ?? "").trim()).filter(Boolean)));
+    if (uniqueRemIds.length === 0) {
+      return { orderedRemIds: [] };
+    }
+    if (params3.requireInPlaceRange) {
+      const range3 = yield* requireStableSiblingRange({
+        remIds: uniqueRemIds,
+        missingMessage: "Explicit --from refs could not be fully resolved from the local RemNote DB",
+        mismatchMessage: "Explicit --from refs must resolve to contiguous sibling Rems under the same parent for --portal in-place"
+      });
+      return {
+        orderedRemIds: range3.orderedRemIds,
+        inPlaceRange: range3
+      };
+    }
+    const maybeRange = yield* requireStableSiblingRange({
+      remIds: uniqueRemIds,
+      missingMessage: "Explicit --from refs could not be fully resolved from the local RemNote DB",
+      mismatchMessage: "Explicit --from refs are not one contiguous sibling range under the same parent"
+    }).pipe(option2);
+    if (maybeRange._tag === "Some") {
+      return { orderedRemIds: maybeRange.value.orderedRemIds };
+    }
+    return { orderedRemIds: uniqueRemIds };
+  });
+}
+function addResolvedPlacementToInput(input, placement) {
+  if (placement.kind === "standalone") {
+    input.standalone = true;
+    return;
+  }
+  if (typeof placement.parentId === "string" && placement.parentId.trim()) {
+    input.parent_id = placement.parentId;
+  }
+  if (typeof placement.position === "number") {
+    input.position = placement.position;
+  }
+}
+function normalizeCreatePromotionIntent(args2) {
+  return gen2(function* () {
+    const contentPlacement = yield* gen2(function* () {
+      return yield* parsePlacementSpec(args2.at, { optionName: "--at" });
+    });
+    const portalStrategy = yield* parsePortalStrategy(args2.portal);
+    const textValue = args2.text !== undefined ? trimBoundaryBlankLines(args2.text) : undefined;
+    const hasTextSource = textValue !== undefined;
+    const hasMarkdownSource = normalizeOptionalText2(args2.markdown) !== undefined;
+    const resolvedExplicitFrom = yield* forEach9(args2.from, (value8) => resolveRefValue(value8));
+    const hasExplicitFrom = resolvedExplicitFrom.length > 0;
+    const hasSelectionSource = args2.fromSelection === true;
+    const sourceCount = (hasTextSource ? 1 : 0) + (hasMarkdownSource ? 1 : 0) + (hasExplicitFrom ? 1 : 0) + (hasSelectionSource ? 1 : 0);
+    if (sourceCount > 1) {
+      return yield* fail8(invalidArgs3("Choose exactly one content source: --text, --markdown, repeated --from, or --from-selection"));
+    }
+    if (sourceCount === 0) {
+      return yield* fail8(invalidArgs3("You must provide one content source: --text, --markdown, repeated --from, or --from-selection"));
+    }
+    const title = normalizeOptionalText2(args2.title);
+    if (hasMarkdownSource && !title) {
+      return yield* fail8(invalidArgs3("rem create --markdown requires --title"));
+    }
+    if (hasSelectionSource && (hasTextSource || hasMarkdownSource || hasExplicitFrom)) {
+      return yield* fail8(invalidArgs3("--from-selection cannot be combined with --text, --markdown, or explicit --from"));
+    }
+    if (hasTextSource && textValue && !args2.forceText && looksLikeStructuredMarkdown2(textValue)) {
+      return yield* fail8(invalidArgs3("Input passed to --text looks like structured Markdown. Use --markdown instead, or pass --force-text to keep it literal."));
+    }
+    if (portalStrategy.kind === "in_place" && (hasTextSource || hasMarkdownSource)) {
+      return yield* fail8(invalidArgs3("--portal in-place is only supported with --from-selection or repeated --from"));
+    }
+    const tags2 = yield* forEach9(args2.tag, (value8) => resolveRefValue(value8)).pipe(map17((values5) => values5.filter(Boolean)));
+    if (hasMarkdownSource) {
+      const markdown2 = yield* readMarkdownArg(args2.markdown);
+      const portalPlacement2 = portalStrategy.kind === "none" ? { kind: "none" } : yield* convertPortalAtPlacement(portalStrategy);
+      return {
+        source: { kind: "markdown", markdown: markdown2 },
+        contentPlacement,
+        portalPlacement: portalPlacement2,
+        destinationTitle: title,
+        isDocument: args2.isDocument,
+        tags: tags2,
+        hasBodyTextChild: false
+      };
+    }
+    if (hasSelectionSource) {
+      const resolvedSelection = yield* resolveCurrentSelectionRemIds({});
+      const selectionRange = yield* requireStableSiblingRange({
+        remIds: resolvedSelection.rem_ids,
+        missingMessage: "Current selection could not be fully resolved from the local RemNote DB",
+        mismatchMessage: "Current selection must resolve to contiguous sibling Rems under the same parent"
+      });
+      const inferredTitle = !title ? yield* readSingleRemTitle({
+        ids: selectionRange.orderedRemIds,
+        selectionTitle: selectionRange.orderedRemIds.length === 1 && String(resolvedSelection?.selection?.current?.id ?? "").trim() === selectionRange.orderedRemIds[0] ? normalizeOptionalText2(String(resolvedSelection?.selection?.current?.title ?? "")) : undefined
+      }) : undefined;
+      const destinationTitle = yield* resolveCreateDestinationTitle({
+        explicitTitle: title,
+        inferredTitle,
+        sourceKind: "selection",
+        sourceCount: selectionRange.orderedRemIds.length
+      });
+      const portalPlacement2 = portalStrategy.kind === "in_place" ? {
+        kind: "in_place_selection_range",
+        parentId: selectionRange.parentId,
+        position: selectionRange.position
+      } : portalStrategy.kind === "none" ? { kind: "none" } : yield* convertPortalAtPlacement(portalStrategy);
+      return {
+        source: { kind: "targets", remIds: selectionRange.orderedRemIds, sourceOrigin: "selection" },
+        contentPlacement,
+        portalPlacement: portalPlacement2,
+        destinationTitle,
+        isDocument: args2.isDocument,
+        tags: tags2,
+        hasBodyTextChild: false
+      };
+    }
+    if (hasExplicitFrom) {
+      const explicitSource = yield* normalizeExplicitFromSource({
+        remIds: resolvedExplicitFrom,
+        requireInPlaceRange: portalStrategy.kind === "in_place"
+      });
+      const inferredTitle = !title ? yield* readSingleRemTitle({ ids: explicitSource.orderedRemIds }) : undefined;
+      const destinationTitle = yield* resolveCreateDestinationTitle({
+        explicitTitle: title,
+        inferredTitle,
+        sourceKind: "explicit_from",
+        sourceCount: explicitSource.orderedRemIds.length
+      });
+      const portalPlacement2 = portalStrategy.kind === "in_place" ? {
+        kind: "in_place_selection_range",
+        parentId: explicitSource.inPlaceRange.parentId,
+        position: explicitSource.inPlaceRange.position
+      } : portalStrategy.kind === "none" ? { kind: "none" } : yield* convertPortalAtPlacement(portalStrategy);
+      return {
+        source: { kind: "targets", remIds: explicitSource.orderedRemIds, sourceOrigin: "explicit_from" },
+        contentPlacement,
+        portalPlacement: portalPlacement2,
+        destinationTitle,
+        isDocument: args2.isDocument,
+        tags: tags2,
+        hasBodyTextChild: false
+      };
+    }
+    const normalizedText = textValue ?? "";
+    const portalPlacement = portalStrategy.kind === "none" ? { kind: "none" } : yield* convertPortalAtPlacement(portalStrategy);
+    return {
+      source: { kind: "text", text: normalizedText },
+      contentPlacement,
+      portalPlacement,
+      destinationTitle: title ?? normalizedText,
+      isDocument: args2.isDocument,
+      tags: tags2,
+      hasBodyTextChild: Boolean(title)
+    };
+  });
+}
+function buildCreatePromotionActions(intent) {
+  return gen2(function* () {
+    const resolvedContentPlacement = yield* resolvePlacementSpec(intent.contentPlacement);
+    const destinationInput = {
+      text: intent.destinationTitle,
+      ...intent.isDocument ? { is_document: true } : {},
+      ...intent.tags.length > 0 ? { tags: intent.tags } : {}
+    };
+    addResolvedPlacementToInput(destinationInput, resolvedContentPlacement);
+    const actions = [
+      {
+        as: DURABLE_TARGET_ALIAS,
+        action: "write.bullet",
+        input: destinationInput
+      }
+    ];
+    if (intent.source.kind === "markdown") {
+      actions.push({
+        action: "rem.children.append",
+        input: {
+          rem_id: `@${DURABLE_TARGET_ALIAS}`,
+          markdown: intent.source.markdown
+        }
+      });
+    }
+    if (intent.source.kind === "text" && intent.hasBodyTextChild) {
+      actions.push({
+        action: "write.bullet",
+        input: {
+          parent_id: `@${DURABLE_TARGET_ALIAS}`,
+          text: intent.source.text
+        }
+      });
+    }
+    if (intent.source.kind === "targets") {
+      for (const remId of intent.source.remIds) {
+        actions.push({
+          action: "rem.move",
+          input: {
+            rem_id: remId,
+            new_parent_id: `@${DURABLE_TARGET_ALIAS}`
+          }
+        });
+      }
+    }
+    switch (intent.portalPlacement.kind) {
+      case "none":
+        break;
+      case "parent":
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: yield* resolveRefValue(intent.portalPlacement.parentRef),
+            target_rem_id: `@${DURABLE_TARGET_ALIAS}`
+          }
+        });
+        break;
+      case "before": {
+        const resolved = yield* resolvePlacementSpec({ kind: "before", anchorRef: intent.portalPlacement.anchorRef });
+        if (resolved.kind === "standalone") {
+          return yield* fail8(invalidArgs3("Invalid portal placement"));
+        }
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: resolved.parentId,
+            position: resolved.position,
+            target_rem_id: `@${DURABLE_TARGET_ALIAS}`
+          }
+        });
+        break;
+      }
+      case "after": {
+        const resolved = yield* resolvePlacementSpec({ kind: "after", anchorRef: intent.portalPlacement.anchorRef });
+        if (resolved.kind === "standalone") {
+          return yield* fail8(invalidArgs3("Invalid portal placement"));
+        }
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: resolved.parentId,
+            position: resolved.position,
+            target_rem_id: `@${DURABLE_TARGET_ALIAS}`
+          }
+        });
+        break;
+      }
+      case "in_place_selection_range":
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: intent.portalPlacement.parentId,
+            position: intent.portalPlacement.position,
+            target_rem_id: `@${DURABLE_TARGET_ALIAS}`
+          }
+        });
+        break;
+    }
+    return actions;
+  });
+}
+function normalizeMovePromotionIntent(args2) {
+  return gen2(function* () {
+    const contentPlacement = yield* gen2(function* () {
+      return yield* parsePlacementSpec(args2.at, { optionName: "--at" });
+    });
+    const portalPlacement = yield* parsePortalStrategy(args2.portal).pipe(flatMap9(convertMovePortalPlacement));
+    return {
+      remId: yield* resolveRefValue(args2.subject),
+      contentPlacement,
+      isDocument: args2.isDocument,
+      portalPlacement
+    };
+  });
+}
+function buildMovePromotionActions(intent) {
+  return gen2(function* () {
+    const resolvedContentPlacement = yield* resolvePlacementSpec(intent.contentPlacement);
+    const moveInput = {
+      rem_id: intent.remId,
+      ...intent.isDocument ? { is_document: true } : {},
+      ...intent.portalPlacement.kind === "in_place_single_rem" ? { leave_portal: true } : {}
+    };
+    if (resolvedContentPlacement.kind === "standalone") {
+      moveInput.standalone = true;
+    } else {
+      moveInput.new_parent_id = resolvedContentPlacement.parentId;
+      if (resolvedContentPlacement.position !== undefined) {
+        moveInput.position = resolvedContentPlacement.position;
+      }
+    }
+    const actions = [
+      {
+        action: "rem.move",
+        input: moveInput
+      }
+    ];
+    switch (intent.portalPlacement.kind) {
+      case "none":
+      case "in_place_single_rem":
+        break;
+      case "parent":
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: yield* resolveRefValue(intent.portalPlacement.parentRef),
+            target_rem_id: intent.remId
+          }
+        });
+        break;
+      case "before": {
+        const resolved = yield* resolvePlacementSpec({ kind: "before", anchorRef: intent.portalPlacement.anchorRef });
+        if (resolved.kind === "standalone") {
+          return yield* fail8(invalidArgs3("Invalid portal placement"));
+        }
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: resolved.parentId,
+            position: resolved.position,
+            target_rem_id: intent.remId
+          }
+        });
+        break;
+      }
+      case "after": {
+        const resolved = yield* resolvePlacementSpec({ kind: "after", anchorRef: intent.portalPlacement.anchorRef });
+        if (resolved.kind === "standalone") {
+          return yield* fail8(invalidArgs3("Invalid portal placement"));
+        }
+        actions.push({
+          as: PORTAL_REM_ALIAS,
+          action: "portal.create",
+          input: {
+            parent_id: resolved.parentId,
+            position: resolved.position,
+            target_rem_id: intent.remId
+          }
+        });
+        break;
+      }
+    }
+    return actions;
+  });
+}
+
+// src/commands/write/rem/create.ts
+function findRemoteId(idMap, clientTempId) {
+  if (!clientTempId || !Array.isArray(idMap))
+    return;
+  const match24 = idMap.find((entry) => String(entry?.client_temp_id ?? "") === clientTempId);
+  const remoteId = typeof match24?.remote_id === "string" ? match24.remote_id.trim() : "";
+  return remoteId || undefined;
+}
+function parseResultJson2(raw4) {
+  const resultJson = raw4?.result_json;
+  if (typeof resultJson === "string" && resultJson.trim()) {
+    try {
+      return JSON.parse(resultJson);
+    } catch {}
+  }
+  return null;
+}
+function replaceStringRecursive(value8, from, to) {
+  if (typeof value8 === "string")
+    return value8 === from ? to : value8;
+  if (Array.isArray(value8))
+    return value8.map((item) => replaceStringRecursive(item, from, to));
+  if (!value8 || typeof value8 !== "object")
+    return value8;
+  const out = {};
+  for (const [key, entry] of Object.entries(value8)) {
+    out[key] = replaceStringRecursive(entry, from, to);
+  }
+  return out;
+}
+function remapDurableTargetTempId(params3) {
+  const nextTempId = normalizeString2(params3.nextTempId);
+  if (!nextTempId || !params3.compiled.aliasMap || typeof params3.compiled.aliasMap !== "object")
+    return params3.compiled;
+  const aliasMap = params3.compiled.aliasMap;
+  const current2 = normalizeString2(aliasMap[DURABLE_TARGET_ALIAS]);
+  if (!current2 || current2 === nextTempId)
+    return params3.compiled;
+  return {
+    kind: params3.compiled.kind,
+    ops: replaceStringRecursive(params3.compiled.ops, current2, nextTempId),
+    aliasMap: {
+      ...aliasMap,
+      [DURABLE_TARGET_ALIAS]: nextTempId
+    }
+  };
+}
+function buildPartialCreateReceipt(params3) {
+  const idMap = Array.isArray(params3.detail?.id_map) ? params3.detail.id_map : [];
+  const remId = findRemoteId(idMap, params3.remClientTempId);
+  if (!remId)
+    return;
+  const ops = Array.isArray(params3.detail?.ops) ? params3.detail.ops : [];
+  const nonPortalFailed = ops.some((op2) => String(op2?.type ?? "") !== "create_portal" && String(op2?.status ?? "") !== "succeeded");
+  const portalOp = ops.find((op2) => String(op2?.type ?? "") === "create_portal");
+  const portalFailed = portalOp && String(portalOp?.status ?? "") !== "succeeded";
+  if (nonPortalFailed || !portalFailed)
+    return;
+  const portalResult = parseResultJson2(portalOp?.result);
+  const portalError = normalizeString2(portalResult?.error) || normalizeString2(portalOp?.result?.error_message) || "portal insertion failed after durable target creation";
+  const portalRemId = findRemoteId(idMap, params3.portalClientTempId);
+  return {
+    partial_success: true,
+    txn_id: params3.txnId,
+    op_ids: ops.map((op2) => String(op2?.op_id ?? "")).filter(Boolean),
+    status: "partial_success",
+    id_map: idMap,
+    ...params3.remClientTempId ? { rem_client_temp_id: params3.remClientTempId } : {},
+    ...params3.portalClientTempId ? { portal_client_temp_id: params3.portalClientTempId } : {},
+    rem_id: remId,
+    durable_target: {
+      rem_id: remId,
+      is_document: params3.intent.isDocument,
+      placement_kind: params3.intent.contentPlacement.kind
+    },
+    source_context: {
+      source_kind: params3.intent.source.kind,
+      ...params3.intent.source.kind === "targets" ? { source_origin: params3.intent.source.sourceOrigin } : {}
+    },
+    portal: {
+      requested: params3.intent.portalPlacement.kind !== "none",
+      created: false,
+      ...portalRemId ? { rem_id: portalRemId } : {},
+      ...params3.intent.portalPlacement.kind !== "none" ? { placement_kind: params3.intent.portalPlacement.kind } : {}
+    },
+    warnings: [portalError],
+    nextActions: [`agent-remnote queue inspect --txn ${params3.txnId}`]
+  };
+}
+var tag8 = text9("tag").pipe(repeated5);
+var writeRemCreateCommand = exports_Command.make("create", {
+  at: text9("at").pipe(withDescription5("Examples: standalone, parent:id:P1, parent[2]:id:P1, before:id:R1, after:id:R1.")),
+  title: readOptionalText3("title"),
+  text: readOptionalText3("text"),
+  markdown: readOptionalText3("markdown"),
+  from: text9("from").pipe(repeated5, withDescription5("Advanced path: combine repeated --from with --portal in-place only for one contiguous sibling range under one parent.")),
+  fromSelection: boolean8("from-selection").pipe(withDescription5("Preferred default for --portal in-place when the current UI selection already matches the intended source range.")),
+  portal: readOptionalText3("portal").pipe(withDescription5("Use in-place for original-slot backfill, or at:<placement-spec> for explicit portal placement.")),
+  isDocument: boolean8("is-document"),
+  tag: tag8,
+  clientTempId: readOptionalText3("client-temp-id"),
+  forceText: boolean8("force-text"),
+  notify: writeCommonOptions.notify,
+  ensureDaemon: writeCommonOptions.ensureDaemon,
+  wait: writeCommonOptions.wait,
+  timeoutMs: writeCommonOptions.timeoutMs,
+  pollMs: writeCommonOptions.pollMs,
+  dryRun: writeCommonOptions.dryRun,
+  priority: writeCommonOptions.priority,
+  clientId: writeCommonOptions.clientId,
+  idempotencyKey: writeCommonOptions.idempotencyKey,
+  meta: writeCommonOptions.meta
+}, ({
+  at,
+  title,
+  text: text16,
+  markdown: markdown2,
+  from,
+  fromSelection,
+  portal,
+  isDocument,
+  tag: tag9,
+  clientTempId,
+  forceText: forceText2,
+  notify: notify3,
+  ensureDaemon: ensureDaemon5,
+  wait: wait3,
+  timeoutMs: timeoutMs4,
+  pollMs: pollMs3,
+  dryRun,
+  priority: priority3,
+  clientId: clientId3,
+  idempotencyKey: idempotencyKey3,
+  meta
+}) => gen2(function* () {
+  yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
+  const payloadSvc = yield* Payload;
+  const intent = yield* normalizeCreatePromotionIntent({
+    at,
+    text: text16,
+    markdown: markdown2,
+    from,
+    fromSelection,
+    title,
+    isDocument,
+    tag: tag9,
+    forceText: forceText2,
+    portal
+  });
+  const actions = yield* buildCreatePromotionActions(intent);
+  const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
+  const body = {
+    version: 1,
+    kind: "actions",
+    actions,
+    ...priority3 !== undefined ? { priority: priority3 } : {},
+    ...clientId3 ? { client_id: clientId3 } : {},
+    ...idempotencyKey3 ? { idempotency_key: idempotencyKey3 } : {},
+    ...metaValue !== undefined ? { meta: metaValue } : {},
+    notify: notify3,
+    ensure_daemon: ensureDaemon5
+  };
+  const compiledBase = yield* dryRunEnvelope(body);
+  const compiled = remapDurableTargetTempId({ compiled: compiledBase, nextTempId: clientTempId });
+  const aliasMap = compiled.aliasMap && typeof compiled.aliasMap === "object" ? compiled.aliasMap : undefined;
+  const remClientTempId = aliasMap?.[DURABLE_TARGET_ALIAS];
+  const portalClientTempId = aliasMap?.[PORTAL_REM_ALIAS];
+  if (dryRun) {
+    yield* writeSuccess({
+      data: {
+        dry_run: true,
+        kind: compiled.kind,
+        rem_client_temp_id: remClientTempId,
+        ...portalClientTempId ? { portal_client_temp_id: portalClientTempId } : {},
+        ops: compiled.ops,
+        alias_map: aliasMap,
+        meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined
+      },
+      md: [
+        "- dry_run: true",
+        "- kind: actions",
+        ...remClientTempId ? [`- rem_client_temp_id: ${remClientTempId}`] : []
+      ].join(`
+`)
+    });
+    return;
+  }
+  const submitBody = {
+    version: 1,
+    kind: "ops",
+    ops: compiled.ops,
+    ...priority3 !== undefined ? { priority: priority3 } : {},
+    ...clientId3 ? { client_id: clientId3 } : {},
+    ...idempotencyKey3 ? { idempotency_key: idempotencyKey3 } : {},
+    ...metaValue !== undefined ? { meta: metaValue } : {},
+    notify: notify3,
+    ensure_daemon: ensureDaemon5
+  };
+  const submitted = yield* submitActionEnvelope({
+    body: submitBody,
+    wait: wait3,
+    timeoutMs: timeoutMs4,
+    pollMs: pollMs3
+  }).pipe(either3);
+  if (submitted._tag === "Left") {
+    const txnId = String(submitted.left?.details?.txn_id ?? "").trim();
+    if (wait3 && txnId) {
+      const detail = yield* loadTxnDetail({ txnId }).pipe(catchAll2(() => succeed8(null)));
+      const partial2 = detail ? buildPartialCreateReceipt({
+        txnId,
+        detail,
+        remClientTempId,
+        portalClientTempId,
+        intent
+      }) : undefined;
+      if (partial2) {
+        yield* writeSuccess({
+          data: partial2,
+          ids: [txnId, ...Array.isArray(partial2.op_ids) ? partial2.op_ids : []],
+          md: [
+            `- txn_id: ${txnId}`,
+            "- status: partial_success",
+            ...remClientTempId ? [`- rem_client_temp_id: ${remClientTempId}`] : [],
+            ...portalClientTempId ? [`- portal_client_temp_id: ${portalClientTempId}`] : []
+          ].join(`
+`)
+        });
+        return;
+      }
+    }
+    return yield* fail8(submitted.left);
+  }
+  const out = submitted.right;
+  const remId = findRemoteId(out?.id_map, remClientTempId);
+  const portalRemId = findRemoteId(out?.id_map, portalClientTempId);
+  const enriched = {
+    ...out,
+    rem_client_temp_id: remClientTempId,
+    ...portalClientTempId ? { portal_client_temp_id: portalClientTempId } : {},
+    ...remId ? { rem_id: remId } : {},
+    ...portalRemId ? { portal_rem_id: portalRemId } : {},
+    ...remId ? {
+      durable_target: {
+        rem_id: remId,
+        is_document: intent.isDocument,
+        placement_kind: intent.contentPlacement.kind
+      }
+    } : {},
+    source_context: {
+      source_kind: intent.source.kind,
+      ...intent.source.kind === "targets" ? { source_origin: intent.source.sourceOrigin } : {}
+    },
+    portal: {
+      requested: intent.portalPlacement.kind !== "none",
+      created: Boolean(portalRemId),
+      ...portalRemId ? { rem_id: portalRemId } : {},
+      ...intent.portalPlacement.kind !== "none" ? { placement_kind: intent.portalPlacement.kind } : {}
+    }
+  };
+  yield* writeSuccess({
+    data: enriched,
+    ids: Array.isArray(out?.op_ids) ? [out.txn_id, ...out.op_ids] : [out.txn_id],
+    md: [
+      `- txn_id: ${out.txn_id}`,
+      `- op_ids: ${Array.isArray(out.op_ids) ? out.op_ids.length : ""}`,
+      `- notified: ${out.notified}`,
+      `- sent: ${out.sent ?? ""}`,
+      ...remClientTempId ? [`- rem_client_temp_id: ${remClientTempId}`] : [],
+      ...portalClientTempId ? [`- portal_client_temp_id: ${portalClientTempId}`] : [],
+      ...out.status ? [`- status: ${out.status}`, `- elapsed_ms: ${out.elapsed_ms ?? ""}`] : []
+    ].join(`
+`)
+  });
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Create a new durable subject from text, markdown, explicit refs, or the current selection."));
+
 // src/commands/write/rem/children/append.ts
 var writeRemChildrenAppendCommand = exports_Command.make("append", {
-  rem: text9("rem"),
+  subject: text9("subject"),
   markdown: text9("markdown"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -103463,9 +104681,9 @@ var writeRemChildrenAppendCommand = exports_Command.make("append", {
   clientId: writeCommonOptions.clientId,
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
-}, ({ rem, markdown: markdown2, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
+}, ({ subject, markdown: markdown2, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
   yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
-  const remId = normalizeRemIdInput3(rem);
+  const remId = yield* resolveSubjectRemId(subject);
   const markdownValue = yield* readMarkdownArg(markdown2);
   const body = yield* buildActionEnvelope({
     action: "rem.children.append",
@@ -103506,7 +104724,7 @@ var writeRemChildrenAppendCommand = exports_Command.make("append", {
 
 // src/commands/write/rem/children/clear.ts
 var writeRemChildrenClearCommand = exports_Command.make("clear", {
-  rem: text9("rem"),
+  subject: text9("subject"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103517,9 +104735,9 @@ var writeRemChildrenClearCommand = exports_Command.make("clear", {
   clientId: writeCommonOptions.clientId,
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
-}, ({ rem, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
+}, ({ subject, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
   yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
-  const remId = normalizeRemIdInput3(rem);
+  const remId = yield* resolveSubjectRemId(subject);
   const body = yield* buildActionEnvelope({
     action: "rem.children.clear",
     remId,
@@ -103558,7 +104776,7 @@ var writeRemChildrenClearCommand = exports_Command.make("clear", {
 
 // src/commands/write/rem/children/prepend.ts
 var writeRemChildrenPrependCommand = exports_Command.make("prepend", {
-  rem: text9("rem"),
+  subject: text9("subject"),
   markdown: text9("markdown"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -103570,9 +104788,9 @@ var writeRemChildrenPrependCommand = exports_Command.make("prepend", {
   clientId: writeCommonOptions.clientId,
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
-}, ({ rem, markdown: markdown2, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
+}, ({ subject, markdown: markdown2, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
   yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
-  const remId = normalizeRemIdInput3(rem);
+  const remId = yield* resolveSubjectRemId(subject);
   const markdownValue = yield* readMarkdownArg(markdown2);
   const body = yield* buildActionEnvelope({
     action: "rem.children.prepend",
@@ -103616,7 +104834,7 @@ function optionToUndefined53(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
-  rem: text9("rem").pipe(optional5, map34(optionToUndefined53)),
+  subject: text9("subject").pipe(optional5, map34(optionToUndefined53)),
   selection: boolean8("selection"),
   stateFile: text9("state-file").pipe(optional5, map34(optionToUndefined53)),
   staleMs: integer7("stale-ms").pipe(optional5, map34(optionToUndefined53)),
@@ -103634,7 +104852,7 @@ var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
 }, ({
-  rem,
+  subject,
   selection,
   stateFile: stateFile24,
   staleMs: staleMs11,
@@ -103653,18 +104871,18 @@ var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
   meta
 }) => gen2(function* () {
   yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
-  const hasRem = typeof rem === "string" && rem.trim().length > 0;
-  const targetCount = Number(hasRem) + Number(selection === true);
+  const hasSubject = typeof subject === "string" && subject.trim().length > 0;
+  const targetCount = Number(hasSubject) + Number(selection === true);
   if (targetCount !== 1) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "Provide exactly one target via --rem or --selection",
+      message: "Provide exactly one target via --subject or --selection",
       exitCode: 2
     }));
   }
   const target2 = selection ? yield* resolveCurrentSelectionRemId({ stateFile: stateFile24, staleMs: staleMs11 }) : {
-    source: "rem",
-    rem_id: normalizeRemIdInput3(String(rem))
+    source: "subject",
+    rem_id: yield* resolveSubjectRemId(String(subject))
   };
   const remId = target2.rem_id;
   const markdownValue = yield* readMarkdownArg(markdown2);
@@ -103731,7 +104949,7 @@ function optionToUndefined54(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 var writeRemDeleteCommand = exports_Command.make("delete", {
-  rem: text9("rem"),
+  subject: text9("subject"),
   maxDeleteSubtreeNodes: integer7("max-delete-subtree-nodes").pipe(optional5, map34(optionToUndefined54)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -103744,7 +104962,7 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
 }, ({
-  rem,
+  subject,
   maxDeleteSubtreeNodes,
   notify: notify3,
   ensureDaemon: ensureDaemon5,
@@ -103779,11 +104997,12 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
     }));
   }
   const payloadSvc = yield* Payload;
+  const remId = yield* resolveRefValue(subject);
   const op2 = yield* try_3({
     try: () => normalizeOp({
       type: "delete_rem",
       payload: {
-        remId: rem,
+        remId,
         ...maxDeleteSubtreeNodes !== undefined ? { maxDeleteSubtreeNodes } : {}
       }
     }, payloadSvc.normalizeKeys),
@@ -103800,7 +105019,7 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
       data: { dry_run: true, ops: [op2], meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
       md: `- dry_run: true
 - op: delete_rem
-- rem_id: ${rem}
+- rem_id: ${remId}
 `
     });
     return;
@@ -103831,18 +105050,27 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/write/rem/move.ts
-function normalizeRemIdInput4(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
+function parseResultJson3(raw4) {
+  const resultJson = raw4?.result_json;
+  if (typeof resultJson === "string" && resultJson.trim()) {
+    try {
+      return JSON.parse(resultJson);
+    } catch {}
+  }
+  return null;
+}
+function findRemoteId2(idMap, clientTempId) {
+  if (!clientTempId || !Array.isArray(idMap))
+    return;
+  const match24 = idMap.find((entry) => String(entry?.client_temp_id ?? "") === clientTempId);
+  const remoteId = typeof match24?.remote_id === "string" ? match24.remote_id.trim() : "";
+  return remoteId || undefined;
 }
 var writeRemMoveCommand = exports_Command.make("move", {
-  rem: text9("rem"),
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
-  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
+  subject: text9("subject").pipe(withDescription5("Existing durable subject to relocate.")),
+  at: text9("at").pipe(withDescription5("Examples: standalone, parent:id:P1, parent[2]:id:P1, before:id:R1, after:id:R1.")),
+  portal: readOptionalText3("portal").pipe(withDescription5("Use in-place to leave a portal at the original location, or at:<placement-spec> for explicit portal placement.")),
+  isDocument: boolean8("is-document"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103854,10 +105082,10 @@ var writeRemMoveCommand = exports_Command.make("move", {
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
 }, ({
-  rem,
-  parent,
-  ref: ref3,
-  position: position3,
+  subject,
+  at,
+  portal,
+  isDocument,
   notify: notify3,
   ensureDaemon: ensureDaemon5,
   wait: wait3,
@@ -103869,72 +105097,282 @@ var writeRemMoveCommand = exports_Command.make("move", {
   idempotencyKey: idempotencyKey3,
   meta
 }) => gen2(function* () {
-  if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
+  yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
+  const payloadSvc = yield* Payload;
+  const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
+  const intent = yield* normalizeMovePromotionIntent({
+    subject,
+    at,
+    isDocument,
+    portal
+  });
+  const actions = yield* buildMovePromotionActions(intent);
+  const body = {
+    version: 1,
+    kind: "actions",
+    actions,
+    ...priority3 !== undefined ? { priority: priority3 } : {},
+    ...clientId3 ? { client_id: clientId3 } : {},
+    ...idempotencyKey3 ? { idempotency_key: idempotencyKey3 } : {},
+    ...metaValue !== undefined ? { meta: metaValue } : {},
+    notify: notify3,
+    ensure_daemon: ensureDaemon5
+  };
+  if (dryRun) {
+    const compiled = yield* dryRunEnvelope(body);
+    yield* writeSuccess({
+      data: {
+        dry_run: true,
+        kind: compiled.kind,
+        ops: compiled.ops,
+        alias_map: compiled.aliasMap,
+        meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined
+      },
+      md: `- dry_run: true
+- action: rem.move
+- rem_id: ${intent.remId}
+`
+    });
+    return;
+  }
+  const out = yield* submitActionEnvelope({
+    body,
+    wait: wait3,
+    timeoutMs: timeoutMs4,
+    pollMs: pollMs3
+  });
+  const detail = wait3 && typeof out?.txn_id === "string" ? yield* loadTxnDetail({ txnId: String(out.txn_id) }).pipe(catchAll2(() => succeed8(null))) : null;
+  const aliasMap = detail?.alias_map && typeof detail.alias_map === "object" ? detail.alias_map : out?.alias_map && typeof out.alias_map === "object" ? out.alias_map : undefined;
+  const portalClientTempId = aliasMap?.[PORTAL_REM_ALIAS];
+  const idMap = Array.isArray(detail?.id_map) ? detail.id_map : Array.isArray(out?.id_map) ? out.id_map : [];
+  const portalRemId = findRemoteId2(idMap, portalClientTempId);
+  const moveOp = Array.isArray(detail?.ops) ? detail.ops.find((op2) => String(op2?.type ?? "").trim() === "move_rem") : Array.isArray(out?.ops) ? out.ops.find((op2) => String(op2?.type ?? "").trim() === "move_rem") : null;
+  const moveResult = parseResultJson3(moveOp?.result);
+  const warnings = [
+    ...Array.isArray(out?.warnings) ? out.warnings : [],
+    ...Array.isArray(moveResult?.warnings) ? moveResult.warnings : []
+  ];
+  const nextActions = [
+    ...Array.isArray(out?.nextActions) ? out.nextActions : [],
+    ...Array.isArray(moveResult?.nextActions) ? moveResult.nextActions : []
+  ];
+  const inPlacePortalId = typeof moveResult?.portal_id === "string" && moveResult.portal_id.trim() ? moveResult.portal_id.trim() : undefined;
+  const portalPlacementKind = intent.portalPlacement.kind === "none" ? undefined : intent.portalPlacement.kind;
+  const portalCreated = intent.portalPlacement.kind === "in_place_single_rem" ? moveResult?.portal_created === true : Boolean(portalRemId);
+  const effectivePortalRemId = intent.portalPlacement.kind === "in_place_single_rem" ? inPlacePortalId : portalRemId;
+  const enriched = {
+    ...out,
+    rem_id: intent.remId,
+    durable_target: {
+      rem_id: intent.remId,
+      is_document: intent.isDocument,
+      placement_kind: intent.contentPlacement.kind
+    },
+    source_context: {
+      source_kind: "targets",
+      source_origin: "move_single_rem",
+      ...typeof moveResult?.source_parent_id === "string" && moveResult.source_parent_id.trim() ? { parent_id: moveResult.source_parent_id.trim() } : {}
+    },
+    portal: {
+      requested: intent.portalPlacement.kind !== "none",
+      created: portalCreated,
+      ...effectivePortalRemId ? { rem_id: effectivePortalRemId } : {},
+      ...portalPlacementKind ? { placement_kind: portalPlacementKind } : {}
+    },
+    ...warnings.length > 0 ? { warnings } : {},
+    ...nextActions.length > 0 ? { nextActions } : {}
+  };
+  yield* writeSuccess({
+    data: enriched,
+    ids: Array.isArray(out?.op_ids) ? [out.txn_id, ...out.op_ids] : [out.txn_id],
+    md: [
+      `- txn_id: ${out.txn_id}`,
+      `- op_ids: ${Array.isArray(out.op_ids) ? out.op_ids.length : ""}`,
+      `- notified: ${out.notified}`,
+      `- sent: ${out.sent ?? ""}`,
+      ...out.status ? [`- status: ${out.status}`, `- elapsed_ms: ${out.elapsed_ms ?? ""}`] : []
+    ].join(`
+`)
+  });
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Move an existing durable subject to a new placement, optionally leaving a portal behind."));
+
+// src/commands/write/_subjectOptions.ts
+var subjectOption = text9("subject");
+var optionalSubjectOption = text9("subject").pipe(optional5, map34(optionToUndefined43));
+var repeatedSubjectOption = text9("subject").pipe(repeated5);
+
+// src/commands/write/rem/replace.ts
+var writeRemReplaceCommand = exports_Command.make("replace", {
+  subject: repeatedSubjectOption,
+  selection: boolean8("selection"),
+  stateFile: text9("state-file").pipe(optional5, map34(optionToUndefined43)),
+  staleMs: integer7("stale-ms").pipe(optional5, map34(optionToUndefined43)),
+  surface: choice5("surface", ["children", "self"]),
+  markdown: text9("markdown"),
+  assert: choice5("assert", ["single-root", "preserve-anchor", "no-literal-bullet"]).pipe(repeated5),
+  notify: writeCommonOptions.notify,
+  ensureDaemon: writeCommonOptions.ensureDaemon,
+  wait: writeCommonOptions.wait,
+  timeoutMs: writeCommonOptions.timeoutMs,
+  pollMs: writeCommonOptions.pollMs,
+  dryRun: writeCommonOptions.dryRun,
+  priority: writeCommonOptions.priority,
+  clientId: writeCommonOptions.clientId,
+  idempotencyKey: writeCommonOptions.idempotencyKey,
+  meta: writeCommonOptions.meta
+}, ({
+  subject,
+  selection,
+  stateFile: stateFile24,
+  staleMs: staleMs11,
+  surface,
+  markdown: markdown2,
+  assert: assert2,
+  notify: notify3,
+  ensureDaemon: ensureDaemon5,
+  wait: wait3,
+  timeoutMs: timeoutMs4,
+  pollMs: pollMs3,
+  dryRun,
+  priority: priority3,
+  clientId: clientId3,
+  idempotencyKey: idempotencyKey3,
+  meta
+}) => gen2(function* () {
+  yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
+  const explicitIds = yield* forEach9(subject, (value8) => resolveRefValue(value8)).pipe(map17((ids4) => ids4.filter(Boolean)));
+  if (explicitIds.length === 0 && !selection || explicitIds.length > 0 && selection) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "Use --wait to enable --timeout-ms/--poll-ms",
+      message: "Provide exactly one target selector via repeated --subject or --selection",
       exitCode: 2
     }));
   }
-  if (dryRun && wait3) {
+  const target2 = explicitIds.length > 0 ? {
+    source: "explicit",
+    rem_ids: Array.from(new Set(explicitIds))
+  } : yield* resolveCurrentSelectionRemIds({ stateFile: stateFile24, staleMs: staleMs11 });
+  if (surface === "children" && target2.rem_ids.length !== 1) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "--wait is not compatible with --dry-run",
-      exitCode: 2
+      message: "rem replace --surface children requires exactly one target Rem",
+      exitCode: 2,
+      details: { surface, target: target2 }
     }));
   }
-  if (parent && ref3) {
+  const assertions = assert2;
+  if (surface === "self" && assertions.includes("preserve-anchor")) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "Choose only one of --parent or --ref",
+      message: "rem replace --surface=self does not support --assert preserve-anchor",
       exitCode: 2
     }));
   }
-  if (!parent && !ref3) {
+  const markdownValue = yield* readMarkdownArg(markdown2);
+  const body = yield* buildActionEnvelope({
+    action: "rem.replace",
+    remId: target2.rem_ids[0] ?? "",
+    input: {
+      surface,
+      rem_ids: target2.rem_ids,
+      markdown: markdownValue,
+      ...assertions.length > 0 ? { assertions } : {}
+    },
+    priority: priority3,
+    clientId: clientId3,
+    idempotencyKey: idempotencyKey3,
+    metaSpec: meta,
+    notify: notify3,
+    ensureDaemon: ensureDaemon5
+  });
+  if (dryRun) {
+    const compiled = yield* dryRunEnvelope(body);
+    yield* writeSuccess({
+      data: { dry_run: true, target: { source: target2.source, rem_ids: target2.rem_ids }, ...compiled },
+      md: `- dry_run: true
+- action: rem.replace
+- surface: ${surface}
+- targets: ${target2.rem_ids.length}
+`
+    });
+    return;
+  }
+  const data = yield* submitActionEnvelope({ body, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3 });
+  yield* writeSuccess({
+    data,
+    ids: [data.txn_id, ...Array.isArray(data.op_ids) ? data.op_ids : []],
+    md: [
+      `- txn_id: ${data.txn_id}`,
+      `- op_ids: ${Array.isArray(data.op_ids) ? data.op_ids.length : ""}`,
+      `- notified: ${data.notified}`,
+      `- sent: ${data.sent ?? ""}`,
+      ...data.status ? [`- status: ${data.status}`, `- elapsed_ms: ${data.elapsed_ms ?? ""}`] : []
+    ].join(`
+`)
+  });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/write/tag/index.ts
+var writeTagAddCommand = exports_Command.make("add", {
+  tag: text9("tag").pipe(repeated5, withDescription5("Tag endpoint. May be repeated.")),
+  to: text9("to").pipe(repeated5, withDescription5("Rem endpoint. May be repeated.")),
+  notify: writeCommonOptions.notify,
+  ensureDaemon: writeCommonOptions.ensureDaemon,
+  wait: writeCommonOptions.wait,
+  timeoutMs: writeCommonOptions.timeoutMs,
+  pollMs: writeCommonOptions.pollMs,
+  dryRun: writeCommonOptions.dryRun,
+  priority: writeCommonOptions.priority,
+  clientId: writeCommonOptions.clientId,
+  idempotencyKey: writeCommonOptions.idempotencyKey,
+  meta: writeCommonOptions.meta
+}, ({ tag: tag9, to, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
+  if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "You must provide --parent or --ref",
+      message: "Use --wait to enable --timeout-ms/--poll-ms",
       exitCode: 2
     }));
   }
-  if (position3 !== undefined && (!Number.isFinite(position3) || position3 < 0)) {
+  if (dryRun && wait3) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "--position must be a non-negative integer",
-      exitCode: 2,
-      details: { position: position3 }
+      message: "--wait is not compatible with --dry-run",
+      exitCode: 2
     }));
   }
-  const refs = yield* RefResolver;
   const payloadSvc = yield* Payload;
-  const remId = normalizeRemIdInput4(rem);
-  const resolvedRef = ref3 ?? "";
-  const parentId = typeof parent === "string" ? normalizeRemIdInput4(parent) : dryRun ? resolvedRef : yield* refs.resolve(resolvedRef);
-  const payload2 = { remId, newParentId: parentId };
-  if (position3 !== undefined)
-    payload2.position = position3;
-  const op2 = yield* try_3({
-    try: () => normalizeOp({ type: "move_rem", payload: payload2 }, payloadSvc.normalizeKeys),
+  if (tag9.length === 0 || to.length === 0) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "tag add requires at least one --tag and at least one --to",
+      exitCode: 2
+    }));
+  }
+  const tagIds = yield* forEach9(tag9, (value8) => resolveRefValue(value8));
+  const remIds = yield* forEach9(to, (value8) => resolveRefValue(value8));
+  const ops = yield* forEach9(tagIds, (tagId) => forEach9(remIds, (remId) => try_3({
+    try: () => normalizeOp({ type: "add_tag", payload: { remId, tagId } }, payloadSvc.normalizeKeys),
     catch: (e) => isCliError(e) ? e : new CliError({
       code: "INVALID_PAYLOAD",
       message: "Failed to generate op",
       exitCode: 2,
       details: { error: String(e?.message || e) }
     })
-  });
+  }))).pipe(map17((rows) => rows.flat()));
   const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
   if (dryRun) {
     yield* writeSuccess({
-      data: { dry_run: true, ops: [op2], meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
+      data: { dry_run: true, ops, meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
       md: `- dry_run: true
-- op: move_rem
-- rem_id: ${remId}
+- op: add_tag
+- relations: ${ops.length}
 `
     });
     return;
   }
   const data = yield* enqueueOps({
-    ops: [op2],
+    ops,
     priority: priority3,
     clientId: clientId3,
     idempotencyKey: idempotencyKey3,
@@ -103956,17 +105394,11 @@ var writeRemMoveCommand = exports_Command.make("move", {
     ].join(`
 `)
   });
-}).pipe(catchAll2(writeFailure)));
-
-// src/commands/write/rem/replace.ts
-var writeRemReplaceCommand = exports_Command.make("replace", {
-  rem: text9("rem").pipe(repeated5),
-  selection: boolean8("selection"),
-  stateFile: text9("state-file").pipe(optional5, map34(optionToUndefined43)),
-  staleMs: integer7("stale-ms").pipe(optional5, map34(optionToUndefined43)),
-  surface: choice5("surface", ["children", "self"]),
-  markdown: text9("markdown"),
-  assert: choice5("assert", ["single-root", "preserve-anchor", "no-literal-bullet"]).pipe(repeated5),
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Relation write. Repeated --tag and repeated --to expand as a cross-product, not pairwise."));
+var writeTagRemoveCommand = exports_Command.make("remove", {
+  tag: text9("tag").pipe(repeated5, withDescription5("Tag endpoint. May be repeated.")),
+  to: text9("to").pipe(repeated5, withDescription5("Rem endpoint. May be repeated.")),
+  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103978,13 +105410,9 @@ var writeRemReplaceCommand = exports_Command.make("replace", {
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
 }, ({
-  rem,
-  selection,
-  stateFile: stateFile24,
-  staleMs: staleMs11,
-  surface,
-  markdown: markdown2,
-  assert: assert2,
+  tag: tag9,
+  to,
+  removeProperties,
   notify: notify3,
   ensureDaemon: ensureDaemon5,
   wait: wait3,
@@ -103996,101 +105424,6 @@ var writeRemReplaceCommand = exports_Command.make("replace", {
   idempotencyKey: idempotencyKey3,
   meta
 }) => gen2(function* () {
-  yield* ensureWaitArgs({ wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun });
-  const explicitIds = rem.map(normalizeRemIdInput3).filter(Boolean);
-  if (explicitIds.length === 0 && !selection || explicitIds.length > 0 && selection) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Provide exactly one target selector via repeated --rem or --selection",
-      exitCode: 2
-    }));
-  }
-  const target2 = explicitIds.length > 0 ? {
-    source: "explicit",
-    rem_ids: Array.from(new Set(explicitIds))
-  } : yield* resolveCurrentSelectionRemIds({ stateFile: stateFile24, staleMs: staleMs11 });
-  if (surface === "children" && target2.rem_ids.length !== 1) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "rem replace --surface children requires exactly one target Rem",
-      exitCode: 2,
-      details: { surface, target: target2 }
-    }));
-  }
-  const assertions = assert2;
-  if (surface === "self" && assertions.includes("preserve-anchor")) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "rem replace --surface=self does not support --assert preserve-anchor",
-      exitCode: 2
-    }));
-  }
-  const markdownValue = yield* readMarkdownArg(markdown2);
-  const body = yield* buildActionEnvelope({
-    action: "rem.replace",
-    remId: target2.rem_ids[0] ?? "",
-    input: {
-      surface,
-      rem_ids: target2.rem_ids,
-      markdown: markdownValue,
-      ...assertions.length > 0 ? { assertions } : {}
-    },
-    priority: priority3,
-    clientId: clientId3,
-    idempotencyKey: idempotencyKey3,
-    metaSpec: meta,
-    notify: notify3,
-    ensureDaemon: ensureDaemon5
-  });
-  if (dryRun) {
-    const compiled = yield* dryRunEnvelope(body);
-    yield* writeSuccess({
-      data: { dry_run: true, target: { source: target2.source, rem_ids: target2.rem_ids }, ...compiled },
-      md: `- dry_run: true
-- action: rem.replace
-- surface: ${surface}
-- targets: ${target2.rem_ids.length}
-`
-    });
-    return;
-  }
-  const data = yield* submitActionEnvelope({ body, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3 });
-  yield* writeSuccess({
-    data,
-    ids: [data.txn_id, ...Array.isArray(data.op_ids) ? data.op_ids : []],
-    md: [
-      `- txn_id: ${data.txn_id}`,
-      `- op_ids: ${Array.isArray(data.op_ids) ? data.op_ids.length : ""}`,
-      `- notified: ${data.notified}`,
-      `- sent: ${data.sent ?? ""}`,
-      ...data.status ? [`- status: ${data.status}`, `- elapsed_ms: ${data.elapsed_ms ?? ""}`] : []
-    ].join(`
-`)
-  });
-}).pipe(catchAll2(writeFailure)));
-
-// src/commands/write/tag/index.ts
-function normalizeRemIdInput5(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
-}
-var writeTagAddCommand = exports_Command.make("add", {
-  rem: text9("rem"),
-  tag: text9("tag"),
-  notify: writeCommonOptions.notify,
-  ensureDaemon: writeCommonOptions.ensureDaemon,
-  wait: writeCommonOptions.wait,
-  timeoutMs: writeCommonOptions.timeoutMs,
-  pollMs: writeCommonOptions.pollMs,
-  dryRun: writeCommonOptions.dryRun,
-  priority: writeCommonOptions.priority,
-  clientId: writeCommonOptions.clientId,
-  idempotencyKey: writeCommonOptions.idempotencyKey,
-  meta: writeCommonOptions.meta
-}, ({ rem, tag: tag9, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
   if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -104106,125 +105439,42 @@ var writeTagAddCommand = exports_Command.make("add", {
     }));
   }
   const payloadSvc = yield* Payload;
-  const remId = normalizeRemIdInput5(rem);
-  const tagId = normalizeRemIdInput5(tag9);
-  const op2 = yield* try_3({
-    try: () => normalizeOp({ type: "add_tag", payload: { remId, tagId } }, payloadSvc.normalizeKeys),
-    catch: (e) => isCliError(e) ? e : new CliError({
-      code: "INVALID_PAYLOAD",
-      message: "Failed to generate op",
-      exitCode: 2,
-      details: { error: String(e?.message || e) }
-    })
-  });
-  const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
-  if (dryRun) {
-    yield* writeSuccess({
-      data: { dry_run: true, ops: [op2], meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
-      md: `- dry_run: true
-- op: add_tag
-- rem_id: ${remId}
-- tag_id: ${tagId}
-`
-    });
-    return;
-  }
-  const data = yield* enqueueOps({
-    ops: [op2],
-    priority: priority3,
-    clientId: clientId3,
-    idempotencyKey: idempotencyKey3,
-    meta: metaValue,
-    notify: notify3,
-    ensureDaemon: ensureDaemon5
-  });
-  const waited = wait3 ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs4, pollMs: pollMs3 }) : null;
-  const out = waited ? { ...data, ...waited } : data;
-  yield* writeSuccess({
-    data: out,
-    ids: [data.txn_id, ...data.op_ids],
-    md: [
-      `- txn_id: ${data.txn_id}`,
-      `- op_ids: ${data.op_ids.length}`,
-      `- notified: ${data.notified}`,
-      `- sent: ${data.sent ?? ""}`,
-      ...waited ? [`- status: ${waited.status}`, `- elapsed_ms: ${waited.elapsed_ms}`] : []
-    ].join(`
-`)
-  });
-}).pipe(catchAll2(writeFailure)));
-var writeTagRemoveCommand = exports_Command.make("remove", {
-  rem: text9("rem"),
-  tag: text9("tag"),
-  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined43)),
-  notify: writeCommonOptions.notify,
-  ensureDaemon: writeCommonOptions.ensureDaemon,
-  wait: writeCommonOptions.wait,
-  timeoutMs: writeCommonOptions.timeoutMs,
-  pollMs: writeCommonOptions.pollMs,
-  dryRun: writeCommonOptions.dryRun,
-  priority: writeCommonOptions.priority,
-  clientId: writeCommonOptions.clientId,
-  idempotencyKey: writeCommonOptions.idempotencyKey,
-  meta: writeCommonOptions.meta
-}, ({
-  rem,
-  tag: tag9,
-  removeProperties,
-  notify: notify3,
-  ensureDaemon: ensureDaemon5,
-  wait: wait3,
-  timeoutMs: timeoutMs4,
-  pollMs: pollMs3,
-  dryRun,
-  priority: priority3,
-  clientId: clientId3,
-  idempotencyKey: idempotencyKey3,
-  meta
-}) => gen2(function* () {
-  if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Use --wait to enable --timeout-ms/--poll-ms",
-      exitCode: 2
-    }));
-  }
-  if (dryRun && wait3) {
+  if (tag9.length === 0 || to.length === 0) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
-      message: "--wait is not compatible with --dry-run",
+      message: "tag remove requires at least one --tag and at least one --to",
       exitCode: 2
     }));
   }
-  const payloadSvc = yield* Payload;
-  const remId = normalizeRemIdInput5(rem);
-  const tagId = normalizeRemIdInput5(tag9);
-  const payload2 = { remId, tagId };
-  if (removeProperties !== undefined)
-    payload2.removeProperties = removeProperties;
-  const op2 = yield* try_3({
-    try: () => normalizeOp({ type: "remove_tag", payload: payload2 }, payloadSvc.normalizeKeys),
-    catch: (e) => isCliError(e) ? e : new CliError({
-      code: "INVALID_PAYLOAD",
-      message: "Failed to generate op",
-      exitCode: 2,
-      details: { error: String(e?.message || e) }
-    })
-  });
+  const tagIds = yield* forEach9(tag9, (value8) => resolveRefValue(value8));
+  const remIds = yield* forEach9(to, (value8) => resolveRefValue(value8));
+  const ops = yield* forEach9(tagIds, (tagId) => forEach9(remIds, (remId) => {
+    const payload2 = { remId, tagId };
+    if (removeProperties !== undefined)
+      payload2.removeProperties = removeProperties;
+    return try_3({
+      try: () => normalizeOp({ type: "remove_tag", payload: payload2 }, payloadSvc.normalizeKeys),
+      catch: (e) => isCliError(e) ? e : new CliError({
+        code: "INVALID_PAYLOAD",
+        message: "Failed to generate op",
+        exitCode: 2,
+        details: { error: String(e?.message || e) }
+      })
+    });
+  })).pipe(map17((rows) => rows.flat()));
   const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
   if (dryRun) {
     yield* writeSuccess({
-      data: { dry_run: true, ops: [op2], meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
+      data: { dry_run: true, ops, meta: metaValue ? payloadSvc.normalizeKeys(metaValue) : undefined },
       md: `- dry_run: true
 - op: remove_tag
-- rem_id: ${remId}
-- tag_id: ${tagId}
+- relations: ${ops.length}
 `
     });
     return;
   }
   const data = yield* enqueueOps({
-    ops: [op2],
+    ops,
     priority: priority3,
     clientId: clientId3,
     idempotencyKey: idempotencyKey3,
@@ -104246,22 +105496,15 @@ var writeTagRemoveCommand = exports_Command.make("remove", {
     ].join(`
 `)
   });
-}).pipe(catchAll2(writeFailure)));
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Relation write. Repeated --tag and repeated --to expand as a cross-product, not pairwise."));
 var writeTagCommand = exports_Command.make("tag", {}).pipe(exports_Command.withSubcommands([writeTagAddCommand, writeTagRemoveCommand]));
 
 // src/commands/write/rem/tag/index.ts
 var writeRemTagCommand = exports_Command.make("tag", {}).pipe(exports_Command.withSubcommands([writeTagAddCommand, writeTagRemoveCommand]));
 
 // src/commands/write/rem/text.ts
-function normalizeRemIdInput6(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
-}
 var writeRemSetTextCommand = exports_Command.make("set-text", {
-  rem: text9("rem"),
+  subject: text9("subject"),
   text: text9("text"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -104273,7 +105516,7 @@ var writeRemSetTextCommand = exports_Command.make("set-text", {
   clientId: writeCommonOptions.clientId,
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
-}, ({ rem, text: text16, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
+}, ({ subject, text: text16, notify: notify3, ensureDaemon: ensureDaemon5, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3, dryRun, priority: priority3, clientId: clientId3, idempotencyKey: idempotencyKey3, meta }) => gen2(function* () {
   if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -104293,7 +105536,7 @@ var writeRemSetTextCommand = exports_Command.make("set-text", {
     reason: "this command enqueues writes to the local queue/store without a HostApiClient branch"
   });
   const payloadSvc = yield* Payload;
-  const remId = normalizeRemIdInput6(rem);
+  const remId = yield* resolveRefValue(subject);
   const textValue = trimBoundaryBlankLines(text16);
   const op2 = yield* try_3({
     try: () => normalizeOp({ type: "update_text", payload: { remId, text: textValue } }, payloadSvc.normalizeKeys),
@@ -105014,7 +106257,7 @@ var readSearchCommand = exports_Command.make("search", {
 var searchCommand = readSearchCommand;
 
 // src/commands/write/table/create.ts
-function normalizeRemIdInput7(raw4) {
+function normalizeRemIdInput2(raw4) {
   const trimmed2 = raw4.trim();
   const link3 = tryParseRemnoteLink(trimmed2);
   if (link3?.remId)
@@ -105093,7 +106336,7 @@ var writeTableCreateCommand = exports_Command.make("create", {
   const cfg = yield* AppConfig;
   const refs = yield* RefResolver;
   const payloadSvc = yield* Payload;
-  const tableTagId = normalizeRemIdInput7(tableTag);
+  const tableTagId = normalizeRemIdInput2(tableTag);
   if (!tableTagId) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -105102,7 +106345,7 @@ var writeTableCreateCommand = exports_Command.make("create", {
     }));
   }
   const resolvedRef = ref5 ?? "";
-  const parentId2 = typeof parent === "string" ? normalizeRemIdInput7(parent) : dryRun ? resolvedRef : yield* refs.resolve(resolvedRef);
+  const parentId2 = typeof parent === "string" ? normalizeRemIdInput2(parent) : dryRun ? resolvedRef : yield* refs.resolve(resolvedRef);
   const tableClientTempId = clientTempId ? String(clientTempId).trim() : makeTempId();
   const op2 = yield* try_3({
     try: () => normalizeOp({
@@ -106796,30 +108039,10 @@ var readTopicCommand = exports_Command.make("topic", {}).pipe(exports_Command.wi
 var topicCommand = readTopicCommand;
 
 // src/commands/write/portal/create.ts
-function normalizeRemIdInput8(raw4) {
-  const trimmed2 = raw4.trim();
-  const link3 = tryParseRemnoteLink(trimmed2);
-  if (link3?.remId)
-    return link3.remId;
-  return trimmed2;
-}
-function looksLikeRef(raw4) {
-  const s = raw4.trim();
-  if (!s)
-    return false;
-  if (s.startsWith("remnote://") || s.startsWith("http://") || s.startsWith("https://"))
-    return true;
-  const idx = s.indexOf(":");
-  if (idx <= 0)
-    return false;
-  const prefix2 = s.slice(0, idx).trim().toLowerCase();
-  return prefix2 === "id" || prefix2 === "page" || prefix2 === "title" || prefix2 === "daily";
-}
 var writePortalCreateCommand = exports_Command.make("create", {
-  parent: text9("parent"),
-  target: text9("target"),
-  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
-  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined43)),
+  to: text9("to").pipe(withDescription5("Target Rem that the portal should point to.")),
+  at: text9("at").pipe(withDescription5("Examples: parent:id:P1, parent[2]:id:P1, before:id:R1, after:id:R1. standalone is invalid for portal placement.")),
+  clientTempId: readOptionalText3("client-temp-id"),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -106830,22 +108053,7 @@ var writePortalCreateCommand = exports_Command.make("create", {
   clientId: writeCommonOptions.clientId,
   idempotencyKey: writeCommonOptions.idempotencyKey,
   meta: writeCommonOptions.meta
-}, ({
-  parent,
-  target: target2,
-  position: position3,
-  clientTempId,
-  notify: notify5,
-  ensureDaemon: ensureDaemon7,
-  wait: wait5,
-  timeoutMs: timeoutMs7,
-  pollMs: pollMs5,
-  dryRun,
-  priority: priority5,
-  clientId: clientId5,
-  idempotencyKey: idempotencyKey5,
-  meta
-}) => gen2(function* () {
+}, ({ to, at, clientTempId, notify: notify5, ensureDaemon: ensureDaemon7, wait: wait5, timeoutMs: timeoutMs7, pollMs: pollMs5, dryRun, priority: priority5, clientId: clientId5, idempotencyKey: idempotencyKey5, meta }) => gen2(function* () {
   if (!wait5 && (timeoutMs7 !== undefined || pollMs5 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -106860,43 +108068,19 @@ var writePortalCreateCommand = exports_Command.make("create", {
       exitCode: 2
     }));
   }
-  if (position3 !== undefined && (!Number.isFinite(position3) || position3 < 0)) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "--position must be a non-negative integer",
-      exitCode: 2,
-      details: { position: position3 }
-    }));
-  }
+  const placementSpec = yield* parsePlacementSpec(at, { optionName: "--at", allowStandalone: false });
+  const resolvedPlacement = yield* resolveTreePlacementSpec(placementSpec, { optionName: "--at" });
+  const targetRemId = yield* resolveRefValue(to);
   const cfg = yield* AppConfig;
-  const refs = yield* RefResolver;
   const payloadSvc = yield* Payload;
-  const parentIdInput = parent;
-  const targetIdInput = target2;
-  const parentId2 = looksLikeRef(parentIdInput) && !dryRun ? yield* refs.resolve(parentIdInput) : normalizeRemIdInput8(parentIdInput);
-  const targetRemId = looksLikeRef(targetIdInput) && !dryRun ? yield* refs.resolve(targetIdInput) : normalizeRemIdInput8(targetIdInput);
-  if (!parentId2) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Missing --parent",
-      exitCode: 2
-    }));
-  }
-  if (!targetRemId) {
-    return yield* fail8(new CliError({
-      code: "INVALID_ARGS",
-      message: "Missing --target",
-      exitCode: 2
-    }));
-  }
-  const portalClientTempId = clientTempId ? String(clientTempId).trim() : makeTempId();
+  const portalClientTempId = clientTempId?.trim() || makeTempId();
   const op2 = yield* try_3({
     try: () => normalizeOp({
       type: "create_portal",
       payload: {
-        parentId: parentId2,
+        parentId: resolvedPlacement.parentId,
         targetRemId,
-        ...position3 !== undefined ? { position: position3 } : {},
+        ...resolvedPlacement.position !== undefined ? { position: resolvedPlacement.position } : {},
         clientTempId: portalClientTempId
       }
     }, payloadSvc.normalizeKeys),
@@ -106958,7 +108142,7 @@ var writePortalCreateCommand = exports_Command.make("create", {
     ].join(`
 `)
   });
-}).pipe(catchAll2(writeFailure)));
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Create one portal relation by pointing at a target Rem and inserting the portal into the tree."));
 
 // src/commands/write/portal/index.ts
 var writePortalCommand = exports_Command.make("portal", {}).pipe(exports_Command.withSubcommands([writePortalCreateCommand]));
@@ -107024,7 +108208,7 @@ var stackEnsureCommand = exports_Command.make("ensure", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/stack/status.ts
-import path29 from "node:path";
+import path31 from "node:path";
 var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function* () {
   const cfg = yield* AppConfig;
   const daemonFiles = yield* DaemonFiles;
@@ -107045,11 +108229,14 @@ var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function*
   const apiBaseUrl = apiLocalBaseUrl(apiPidInfo?.port ?? cfg.apiPort ?? 3000, apiBasePath);
   const apiStatus = yield* api.status({ baseUrl: apiBaseUrl, timeoutMs: 2000 }).pipe(either3);
   const queueStats2 = yield* queue.stats({ dbPath: cfg.storeDb }).pipe(either3);
-  const stateFilePath = resolveUserFilePath(daemonPidInfo?.state_file ?? path29.join(path29.dirname(daemonPidFile), "ws.state.json"));
+  const stateFilePath = resolveUserFilePath(daemonPidInfo?.state_file ?? path31.join(path31.dirname(daemonPidFile), "ws.state.json"));
+  const activeWorkerRuntime = clients._tag === "Right" && typeof clients.right.activeWorkerConnId === "string" ? clients.right.clients.find((client) => client.connId === clients.right.activeWorkerConnId)?.runtime ?? null : null;
   const data = {
+    runtime: currentRuntimeBuildInfo(),
     daemon: {
       running: daemonRunning,
       pid: daemonPidInfo?.pid ?? null,
+      build: daemonPidInfo?.build ?? null,
       pid_file: daemonPidFile,
       ws_url: cfg.wsUrl,
       healthy: wsHealth._tag === "Right",
@@ -107058,6 +108245,7 @@ var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function*
     api: {
       running: apiRunning,
       pid: apiPidInfo?.pid ?? null,
+      build: apiPidInfo?.build ?? null,
       pid_file: apiPidFile,
       base_url: apiBaseUrl,
       base_path: apiBasePath,
@@ -107065,7 +108253,19 @@ var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function*
       status: apiStatus._tag === "Right" ? apiStatus.right : null
     },
     active_worker_conn_id: clients._tag === "Right" ? clients.right.activeWorkerConnId ?? null : null,
-    queue: queueStats2._tag === "Right" ? queueStats2.right : null
+    active_worker: clients._tag === "Right" && typeof clients.right.activeWorkerConnId === "string" ? clients.right.clients.find((client) => client.connId === clients.right.activeWorkerConnId) ?? null : null,
+    queue: queueStats2._tag === "Right" ? queueStats2.right : null,
+    warnings: [
+      ...runtimeVersionWarnings({
+        current: currentRuntimeBuildInfo(),
+        daemon: daemonPidInfo?.build ?? null,
+        api: apiPidInfo?.build ?? null
+      }),
+      ...pluginBuildWarnings({
+        expected: currentExpectedPluginBuildInfo(),
+        live: activeWorkerRuntime
+      })
+    ]
   };
   const md = [
     `- daemon_running: ${data.daemon.running}`,
@@ -107091,7 +108291,7 @@ var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function*
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/stack/stop.ts
-import path30 from "node:path";
+import path32 from "node:path";
 var stackStopCommand = exports_Command.make("stop", {}, () => gen2(function* () {
   const apiFiles = yield* ApiDaemonFiles;
   const daemonFiles = yield* DaemonFiles;
@@ -107128,7 +108328,7 @@ var stackStopCommand = exports_Command.make("stop", {}, () => gen2(function* ()
     }
   }
   yield* daemonFiles.deletePidFile(daemonPidFile).pipe(catchAll2(() => _void));
-  yield* supervisorState.deleteStateFile(resolveUserFilePath(daemonPidInfo?.state_file ?? path30.join(path30.dirname(daemonPidFile), "ws.state.json"))).pipe(catchAll2(() => _void));
+  yield* supervisorState.deleteStateFile(resolveUserFilePath(daemonPidInfo?.state_file ?? path32.join(path32.dirname(daemonPidFile), "ws.state.json"))).pipe(catchAll2(() => _void));
   yield* writeSuccess({
     data: { stopped: true, api_stopped: apiStopped, daemon_stopped: daemonStopped },
     md: `- stopped: true
@@ -107305,7 +108505,7 @@ function buildCliEnvConfigProvider(params3) {
 // src/main.ts
 function packageVersion() {
   try {
-    const raw4 = readFileSync2(new URL("../package.json", import.meta.url), "utf8");
+    const raw4 = readFileSync4(new URL("../package.json", import.meta.url), "utf8");
     const parsed = JSON.parse(raw4);
     if (typeof parsed?.version === "string" && parsed.version.length > 0)
       return parsed.version;
@@ -107315,6 +108515,17 @@ function packageVersion() {
 var version = packageVersion();
 if (!process.env.AGENT_REMNOTE_VERSION)
   process.env.AGENT_REMNOTE_VERSION = version;
+var buildInfo = currentRuntimeBuildInfo();
+if (!process.env.AGENT_REMNOTE_NAME)
+  process.env.AGENT_REMNOTE_NAME = buildInfo.name;
+if (!process.env.AGENT_REMNOTE_BUILD_ID)
+  process.env.AGENT_REMNOTE_BUILD_ID = buildInfo.build_id;
+if (!process.env.AGENT_REMNOTE_BUILD_AT)
+  process.env.AGENT_REMNOTE_BUILD_AT = String(buildInfo.built_at);
+if (!process.env.AGENT_REMNOTE_SOURCE_STAMP)
+  process.env.AGENT_REMNOTE_SOURCE_STAMP = String(buildInfo.source_stamp);
+if (!process.env.AGENT_REMNOTE_BUILD_MODE)
+  process.env.AGENT_REMNOTE_BUILD_MODE = buildInfo.mode;
 var cli = exports_Command.run(rootCommand, {
   name: "agent-remnote",
   version