agent-remnote 1.1.0 → 1.2.0

package/dist/main.js

@@ -75988,7 +75988,37 @@ var migration6 = {
 };
 
 // src/internal/store/migrations/index.ts
-var migrationSpecs = [migration, migration2, migration3, migration4, migration5, migration6];
+var BACKUP_ARTIFACTS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS backup_artifacts (
+  source_op_id      TEXT PRIMARY KEY,
+  source_txn        TEXT NOT NULL,
+  source_op_type    TEXT NOT NULL CHECK (source_op_type IN ('replace_children_with_markdown','replace_selection_with_markdown')),
+  backup_kind       TEXT NOT NULL CHECK (backup_kind IN ('children_replace','selection_replace')),
+  cleanup_policy    TEXT NOT NULL CHECK (cleanup_policy IN ('auto','visible')),
+  cleanup_state     TEXT NOT NULL CHECK (cleanup_state IN ('pending','orphan','retained','cleaned')),
+  backup_rem_id     TEXT,
+  source_parent_id  TEXT,
+  source_anchor_id  TEXT,
+  result_json       TEXT NOT NULL DEFAULT '{}',
+  created_at        INTEGER NOT NULL,
+  updated_at        INTEGER NOT NULL,
+  cleaned_at        INTEGER
+);`;
+var IDX_BACKUP_ARTIFACTS_STATE_SQL = `CREATE INDEX IF NOT EXISTS idx_backup_artifacts_state ON backup_artifacts(cleanup_state, updated_at DESC);`;
+var IDX_BACKUP_ARTIFACTS_KIND_SQL = `CREATE INDEX IF NOT EXISTS idx_backup_artifacts_kind ON backup_artifacts(backup_kind, updated_at DESC);`;
+var UQ_BACKUP_ARTIFACTS_REM_SQL = `CREATE UNIQUE INDEX IF NOT EXISTS uq_backup_artifacts_backup_rem_id ON backup_artifacts(backup_rem_id) WHERE backup_rem_id IS NOT NULL;`;
+var m0007 = {
+  version: 7,
+  name: "add_backup_artifacts",
+  checksumInput: [BACKUP_ARTIFACTS_TABLE_SQL, IDX_BACKUP_ARTIFACTS_STATE_SQL, IDX_BACKUP_ARTIFACTS_KIND_SQL, UQ_BACKUP_ARTIFACTS_REM_SQL].join(`
+`),
+  apply: (db) => {
+    db.exec(BACKUP_ARTIFACTS_TABLE_SQL);
+    db.exec(IDX_BACKUP_ARTIFACTS_STATE_SQL);
+    db.exec(IDX_BACKUP_ARTIFACTS_KIND_SQL);
+    db.exec(UQ_BACKUP_ARTIFACTS_REM_SQL);
+  }
+};
+var migrationSpecs = [migration, migration2, migration3, migration4, migration5, migration6, m0007];
 
 // src/internal/store/db.ts
 class StoreSchemaError extends Error {
@@ -76128,6 +76158,32 @@ CREATE UNIQUE INDEX IF NOT EXISTS uq_workspace_bindings_current
 
 CREATE INDEX IF NOT EXISTS idx_workspace_bindings_updated_at
   ON workspace_bindings(updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS backup_artifacts (
+  source_op_id      TEXT PRIMARY KEY,
+  source_txn        TEXT NOT NULL,
+  source_op_type    TEXT NOT NULL CHECK (source_op_type IN ('replace_children_with_markdown','replace_selection_with_markdown')),
+  backup_kind       TEXT NOT NULL CHECK (backup_kind IN ('children_replace','selection_replace')),
+  cleanup_policy    TEXT NOT NULL CHECK (cleanup_policy IN ('auto','visible')),
+  cleanup_state     TEXT NOT NULL CHECK (cleanup_state IN ('pending','orphan','retained','cleaned')),
+  backup_rem_id     TEXT,
+  source_parent_id  TEXT,
+  source_anchor_id  TEXT,
+  result_json       TEXT NOT NULL DEFAULT '{}',
+  created_at        INTEGER NOT NULL,
+  updated_at        INTEGER NOT NULL,
+  cleaned_at        INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_backup_artifacts_state
+  ON backup_artifacts(cleanup_state, updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_backup_artifacts_kind
+  ON backup_artifacts(backup_kind, updated_at DESC);
+
+CREATE UNIQUE INDEX IF NOT EXISTS uq_backup_artifacts_backup_rem_id
+  ON backup_artifacts(backup_rem_id)
+  WHERE backup_rem_id IS NOT NULL;
 `;
 function absoluteDefaultStorePath() {
   return path12.join(homeDir(), ".agent-remnote", "store.sqlite");
@@ -76496,6 +76552,102 @@ function maybeInitializeDefaultStoreFromLegacy(resolvedStorePath, params3) {
     } catch {}
   }
 }
+
+// src/internal/store/index.ts
+function normalizeString(value8) {
+  return typeof value8 === "string" ? value8.trim() : "";
+}
+function normalizeNullableString(value8) {
+  const normalized = normalizeString(value8);
+  return normalized || null;
+}
+function upsertBackupArtifact(db, params3) {
+  const sourceOpId = normalizeString(params3.sourceOpId);
+  const sourceTxn = normalizeString(params3.sourceTxn);
+  const sourceOpType = normalizeString(params3.sourceOpType);
+  if (!sourceOpId || !sourceTxn || !sourceOpType)
+    return;
+  const now2 = Number.isFinite(params3.now) ? Math.floor(params3.now) : Date.now();
+  const existing = db.prepare(`SELECT created_at FROM backup_artifacts WHERE source_op_id=?`).get(sourceOpId);
+  const createdAt = Number.isFinite(existing?.created_at) ? Math.floor(existing.created_at) : now2;
+  const cleanedAt = params3.cleanedAt === null ? null : Number.isFinite(params3.cleanedAt) ? Math.floor(params3.cleanedAt) : params3.cleanupState === "cleaned" ? now2 : null;
+  db.prepare(`INSERT INTO backup_artifacts(
+       source_op_id, source_txn, source_op_type, backup_kind, cleanup_policy, cleanup_state,
+       backup_rem_id, source_parent_id, source_anchor_id, result_json, created_at, updated_at, cleaned_at
+     ) VALUES (
+       @source_op_id, @source_txn, @source_op_type, @backup_kind, @cleanup_policy, @cleanup_state,
+       @backup_rem_id, @source_parent_id, @source_anchor_id, @result_json, @created_at, @updated_at, @cleaned_at
+     )
+     ON CONFLICT(source_op_id) DO UPDATE SET
+       source_txn=excluded.source_txn,
+       source_op_type=excluded.source_op_type,
+       backup_kind=excluded.backup_kind,
+       cleanup_policy=excluded.cleanup_policy,
+       cleanup_state=excluded.cleanup_state,
+       backup_rem_id=excluded.backup_rem_id,
+       source_parent_id=excluded.source_parent_id,
+       source_anchor_id=excluded.source_anchor_id,
+       result_json=excluded.result_json,
+       updated_at=excluded.updated_at,
+       cleaned_at=excluded.cleaned_at`).run({
+    source_op_id: sourceOpId,
+    source_txn: sourceTxn,
+    source_op_type: sourceOpType,
+    backup_kind: params3.backupKind,
+    cleanup_policy: params3.cleanupPolicy,
+    cleanup_state: params3.cleanupState,
+    backup_rem_id: normalizeNullableString(params3.backupRemId),
+    source_parent_id: normalizeNullableString(params3.sourceParentId),
+    source_anchor_id: normalizeNullableString(params3.sourceAnchorId),
+    result_json: JSON.stringify(params3.result ?? {}),
+    created_at: createdAt,
+    updated_at: now2,
+    cleaned_at: cleanedAt
+  });
+}
+function listBackupArtifacts(db, params3) {
+  const states = Array.isArray(params3?.states) && params3.states.length > 0 ? Array.from(new Set(params3.states)) : [];
+  const kinds = Array.isArray(params3?.kinds) && params3.kinds.length > 0 ? Array.from(new Set(params3.kinds)) : [];
+  const limitRaw = Number(params3?.limit ?? 100);
+  const limit = Number.isFinite(limitRaw) && limitRaw > 0 ? Math.min(500, Math.floor(limitRaw)) : 100;
+  const where = [];
+  const args2 = [];
+  if (!params3?.includeCleaned && states.length === 0) {
+    where.push(`cleanup_state != 'cleaned'`);
+  }
+  if (states.length > 0) {
+    where.push(`cleanup_state IN (${states.map(() => "?").join(", ")})`);
+    args2.push(...states);
+  }
+  if (kinds.length > 0) {
+    where.push(`backup_kind IN (${kinds.map(() => "?").join(", ")})`);
+    args2.push(...kinds);
+  }
+  const backupRemId = normalizeString(params3?.backupRemId);
+  if (backupRemId) {
+    where.push(`backup_rem_id = ?`);
+    args2.push(backupRemId);
+  }
+  const olderThanHours = Number(params3?.olderThanHours);
+  if (Number.isFinite(olderThanHours) && olderThanHours > 0) {
+    where.push(`created_at <= ?`);
+    args2.push(Date.now() - Math.floor(olderThanHours * 60 * 60 * 1000));
+  }
+  const sql = `SELECT * FROM backup_artifacts` + (where.length > 0 ? ` WHERE ${where.join(" AND ")}` : "") + ` ORDER BY updated_at DESC LIMIT ${limit}`;
+  return db.prepare(sql).all(...args2);
+}
+function updateBackupArtifactsCleanupState(db, params3) {
+  const sourceOpIds = Array.from(new Set(params3.sourceOpIds.map((item) => normalizeString(item)).filter(Boolean)));
+  if (sourceOpIds.length === 0)
+    return 0;
+  const now2 = Number.isFinite(params3.now) ? Math.floor(params3.now) : Date.now();
+  const cleanedAt = params3.cleanupState === "cleaned" ? now2 : null;
+  const result = db.prepare(`UPDATE backup_artifacts
+       SET cleanup_state=?, updated_at=?, cleaned_at=?
+       WHERE source_op_id IN (${sourceOpIds.map(() => "?").join(", ")})`).run(params3.cleanupState, now2, cleanedAt, ...sourceOpIds);
+  return Number(result.changes ?? 0);
+}
+
 // src/internal/queue/db.ts
 class QueueSchemaError extends Error {
   _tag = "QueueSchemaError";
@@ -76610,10 +76762,16 @@ var OP_CATALOG = {
   delete_rem: {
     op_type: "delete_rem",
     aliases: ["rem.delete"],
-    payload: { required: ["rem_id"], optional: [] },
+    payload: { required: ["rem_id"], optional: ["max_delete_subtree_nodes"] },
     description: "Delete a Rem.",
     id_fields: ["rem_id"]
   },
+  delete_backup_artifact: {
+    op_type: "delete_backup_artifact",
+    payload: { required: ["rem_id"], optional: ["max_delete_subtree_nodes"] },
+    description: "Delete a backup artifact and verify the Rem is actually gone.",
+    id_fields: ["rem_id"]
+  },
   create_single_rem_with_markdown: {
     op_type: "create_single_rem_with_markdown",
     aliases: ["rem.createSingleWithMarkdown"],
@@ -76644,7 +76802,7 @@ var OP_CATALOG = {
     op_type: "replace_children_with_markdown",
     payload: {
       required: ["parent_id", "markdown"],
-      optional: ["indent_mode", "indent_size", "parse_mode", "prepared", "staged", "bundle"]
+      optional: ["indent_mode", "indent_size", "parse_mode", "prepared", "staged", "bundle", "backup", "assertions"]
     },
     description: "Replace the direct children of a Rem with Markdown.",
     id_fields: ["parent_id"]
@@ -76872,7 +77030,7 @@ function isCreateOp(opType) {
   return opType.startsWith("create_") || opType === "create_tree_with_markdown" || opType === "create_single_rem_with_markdown" || opType === "create_link_rem";
 }
 function isStructureOp(opType) {
-  return opType === "move_rem" || opType === "delete_rem" || opType === "replace_selection_with_markdown" || opType === "replace_children_with_markdown";
+  return opType === "move_rem" || opType === "delete_rem" || opType === "delete_backup_artifact" || opType === "replace_selection_with_markdown" || opType === "replace_children_with_markdown";
 }
 function deriveConflictKeys(opTypeRaw, payload) {
   const opType = canonicalizeOpType(opTypeRaw);
@@ -77463,11 +77621,11 @@ function riskScore(risk) {
   }
 }
 function computeConflictClusterRisk(params3) {
-  const hasDelete = params3.opTypes.has("delete_rem");
+  const hasDelete = params3.opTypes.has("delete_rem") || params3.opTypes.has("delete_backup_artifact");
   if (hasDelete && params3.opCount > 0) {
     return {
       risk: "high",
-      note: "delete_rem mixed with other ops; execution order matters and may require manual review"
+      note: "destructive delete op mixed with other ops; execution order matters and may require manual review"
     };
   }
   if (params3.conflictKey.startsWith("global:")) {
@@ -77857,6 +78015,21 @@ function handleOpAckMessage(params3) {
       }
     }
   ];
+  try {
+    syncBackupArtifactFromAck(params3.db, {
+      now: params3.now,
+      opId,
+      status: status2,
+      result: params3.msg?.result ?? null
+    });
+  } catch (error4) {
+    actions.push({
+      _tag: "Log",
+      level: "warn",
+      event: "backup_artifact_sync_failed",
+      details: { connId: params3.connId, opId, attemptId, status: status2, error: String(error4) }
+    });
+  }
   if (status2 === "success" && ackRes.duplicate === false) {
     try {
       const mappings = [];
@@ -77950,6 +78123,36 @@ function handleOpAckMessage(params3) {
   });
   return { actions, touchAckTimestamp: true, invalidateStatusLineReason: "op_acked" };
 }
+function syncBackupArtifactFromAck(db, params3) {
+  const opRow = db.prepare(`SELECT txn_id, type, payload_json FROM queue_ops WHERE op_id=?`).get(params3.opId);
+  const opType = typeof opRow?.type === "string" ? opRow.type : "";
+  if (opType !== "replace_children_with_markdown" && opType !== "replace_selection_with_markdown")
+    return;
+  let payload = {};
+  try {
+    payload = JSON.parse(String(opRow?.payload_json ?? "{}"));
+  } catch {}
+  const backupPolicy = typeof payload?.backup === "string" && payload.backup.trim() === "visible" ? "visible" : "auto";
+  const backupKind = opType === "replace_children_with_markdown" ? "children_replace" : "selection_replace";
+  const backupRemId = typeof params3.result?.backup_rem_id === "string" && params3.result.backup_rem_id.trim() ? params3.result.backup_rem_id.trim() : null;
+  const cleanupState = params3.status === "success" ? backupPolicy === "visible" && backupRemId ? "retained" : backupRemId ? params3.result?.backup_hidden === true || params3.result?.backup_cleanup_state === "pending" ? "pending" : "orphan" : "cleaned" : backupRemId ? backupPolicy === "visible" ? "retained" : params3.status === "retry" ? "pending" : "orphan" : null;
+  if (!cleanupState)
+    return;
+  upsertBackupArtifact(db, {
+    sourceOpId: params3.opId,
+    sourceTxn: typeof opRow?.txn_id === "string" ? opRow.txn_id : "",
+    sourceOpType: opType,
+    backupKind,
+    cleanupPolicy: backupPolicy,
+    cleanupState,
+    backupRemId,
+    sourceParentId: typeof params3.result?.parent_id === "string" ? params3.result.parent_id : typeof payload?.parent_id === "string" ? payload.parent_id : null,
+    sourceAnchorId: opType === "replace_children_with_markdown" ? typeof payload?.parent_id === "string" ? payload.parent_id : null : Array.isArray(params3.result?.selection_rem_ids) ? String(params3.result.selection_rem_ids[0] ?? "") : Array.isArray(payload?.target?.rem_ids) ? String(payload.target.rem_ids[0] ?? "") : null,
+    result: params3.result ?? {},
+    now: params3.now,
+    cleanedAt: cleanupState === "cleaned" ? params3.now : null
+  });
+}
 // src/kernel/op-catalog/idFields.ts
 function idFieldPathsForOpType(opTypeRaw) {
   const opType = canonicalizeOpType(opTypeRaw);
@@ -93473,6 +93676,11 @@ function requireOkUiContext(snapshot2) {
 }
 // src/kernel/write-plan/compile.ts
 var ALIAS_RE = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+var WRITE_STRUCTURE_ASSERTIONS = new Set([
+  "single-root",
+  "preserve-anchor",
+  "no-literal-bullet"
+]);
 function getObject(value8) {
   return value8 && typeof value8 === "object" && !Array.isArray(value8) ? value8 : null;
 }
@@ -93686,6 +93894,16 @@ var ACTIONS = {
       }
       const payload = { parent_id: rem_id, markdown };
       Object.assign(payload, buildMarkdownPayloadFields(input));
+      if (typeof input.backup === "string")
+        payload.backup = input.backup;
+      if (Array.isArray(input.assertions)) {
+        const assertions = input.assertions;
+        const valid = assertions.every((value8) => typeof value8 === "string" && WRITE_STRUCTURE_ASSERTIONS.has(value8));
+        if (!valid) {
+          throw new Error("rem.children.replace input.assertions must only include: single-root, preserve-anchor, no-literal-bullet");
+        }
+        payload.assertions = assertions;
+      }
       return { ops: [{ type: "replace_children_with_markdown", payload }] };
     }
   },
@@ -93814,6 +94032,100 @@ function compileWritePlanV1(plan, params3) {
   }
   return { alias_map: aliasMap, ops };
 }
+// src/kernel/write-plan/shape.ts
+var STRUCTURED_MARKDOWN_LINE_RE = /^\s{0,3}(?:#{1,6}\s+\S|[-*+]\s+\S|\d+\.\s+\S|```|~~~)/m;
+var ROOT_HEADING_RE = /^#{1,6}\s+\S/;
+var ROOT_LIST_ITEM_RE = /^(?:[-*+]|\d+\.)\s+\S/;
+function looksLikeStructuredMarkdown(input) {
+  const normalized = input.replace(/\r\n?/g, `
+`).trim();
+  if (!normalized)
+    return false;
+  return STRUCTURED_MARKDOWN_LINE_RE.test(normalized);
+}
+function trimBoundaryBlankLinesLocal(input) {
+  const normalized = input.replace(/\r\n?/g, `
+`);
+  const lines3 = normalized.split(`
+`);
+  let start4 = 0;
+  while (start4 < lines3.length && lines3[start4]?.trim().length === 0)
+    start4 += 1;
+  if (start4 >= lines3.length)
+    return "";
+  let end6 = lines3.length - 1;
+  while (end6 >= start4 && lines3[end6]?.trim().length === 0)
+    end6 -= 1;
+  if (end6 < start4)
+    return "";
+  let inFence = false;
+  for (let i = start4;i <= end6; i += 1) {
+    if (/^\s*```/.test(lines3[i] ?? ""))
+      inFence = !inFence;
+  }
+  const keptEnd = inFence ? lines3.length - 1 : end6;
+  return lines3.slice(start4, keptEnd + 1).join(`
+`);
+}
+function countTopLevelMarkdownRoots(input) {
+  const normalized = trimBoundaryBlankLinesLocal(input.replace(/\r\n?/g, `
+`));
+  if (!normalized)
+    return 0;
+  const lines3 = normalized.split(`
+`);
+  const commonIndent = lines3.filter((line4) => line4.trim().length > 0).reduce((min5, line4) => {
+    const indent3 = line4.match(/^[ \t]*/)?.[0].length ?? 0;
+    return min5 === null ? indent3 : Math.min(min5, indent3);
+  }, null) ?? 0;
+  let inFence = false;
+  let count4 = 0;
+  for (const rawLine of lines3) {
+    const line4 = rawLine.slice(commonIndent);
+    if (/^\s*(```|~~~)/.test(line4)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence)
+      continue;
+    const trimmed2 = line4.trim();
+    if (!trimmed2)
+      continue;
+    if (/^[ \t]/.test(line4))
+      continue;
+    if (ROOT_HEADING_RE.test(trimmed2)) {
+      count4 += 1;
+      continue;
+    }
+    if (ROOT_LIST_ITEM_RE.test(trimmed2))
+      count4 += 1;
+  }
+  return count4;
+}
+function decideOutlineWriteShape(params3) {
+  if (params3.preserveAnchor === true) {
+    return {
+      shape: "expand_in_place",
+      outline_suitable: true,
+      top_level_roots: 0
+    };
+  }
+  const markdown = typeof params3.markdown === "string" ? params3.markdown : "";
+  const topLevelRoots = countTopLevelMarkdownRoots(markdown);
+  const structured = looksLikeStructuredMarkdown(markdown);
+  if (structured && topLevelRoots === 1) {
+    return {
+      shape: "single_root_outline",
+      outline_suitable: true,
+      top_level_roots: 1
+    };
+  }
+  return {
+    shape: "normal",
+    outline_suitable: false,
+    top_level_roots: topLevelRoots
+  };
+}
 // src/services/Payload.ts
 import { promises as fs17 } from "node:fs";
 class Payload extends Tag2("Payload")() {
@@ -95202,13 +95514,54 @@ function trimBoundaryBlankLines(input) {
   return lines3.slice(start4, keptEnd + 1).join(`
 `);
 }
-var STRUCTURED_MARKDOWN_LINE_RE = /^\s{0,3}(?:#{1,6}\s+\S|[-*+]\s+\S|\d+\.\s+\S|```|~~~)/m;
-function looksLikeStructuredMarkdown(input) {
+var STRUCTURED_MARKDOWN_LINE_RE2 = /^\s{0,3}(?:#{1,6}\s+\S|[-*+]\s+\S|\d+\.\s+\S|```|~~~)/m;
+var ROOT_HEADING_RE2 = /^#{1,6}\s+\S/;
+var ROOT_LIST_ITEM_RE2 = /^(?:[-*+]|\d+\.)\s+\S/;
+function looksLikeStructuredMarkdown2(input) {
   const normalized = input.replace(/\r\n?/g, `
 `).trim();
   if (!normalized)
     return false;
-  return STRUCTURED_MARKDOWN_LINE_RE.test(normalized);
+  return STRUCTURED_MARKDOWN_LINE_RE2.test(normalized);
+}
+function countTopLevelMarkdownRoots2(input) {
+  const normalized = trimBoundaryBlankLines(input.replace(/\r\n?/g, `
+`));
+  if (!normalized)
+    return 0;
+  const lines3 = normalized.split(`
+`);
+  const commonIndent = lines3.filter((line4) => line4.trim().length > 0).reduce((min5, line4) => {
+    const indent3 = line4.match(/^[ \t]*/)?.[0].length ?? 0;
+    return min5 === null ? indent3 : Math.min(min5, indent3);
+  }, null) ?? 0;
+  let inFence = false;
+  let count4 = 0;
+  for (const rawLine of lines3) {
+    const line4 = rawLine.slice(commonIndent);
+    if (/^\s*(```|~~~)/.test(line4)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence)
+      continue;
+    const trimmed2 = line4.trim();
+    if (!trimmed2)
+      continue;
+    if (/^[ \t]/.test(line4))
+      continue;
+    if (ROOT_HEADING_RE2.test(trimmed2)) {
+      count4 += 1;
+      continue;
+    }
+    if (ROOT_LIST_ITEM_RE2.test(trimmed2)) {
+      count4 += 1;
+    }
+  }
+  return count4;
+}
+function isSingleRootOutlineMarkdown(input) {
+  return countTopLevelMarkdownRoots2(input) === 1;
 }
 
 // src/lib/hostApiUseCases.ts
@@ -95301,24 +95654,91 @@ function executeReadOutlineUseCase(params3) {
     if (!resolvedId) {
       return yield* fail8(new CliError({ code: "INVALID_ARGS", message: "You must provide --id or --ref", exitCode: 2 }));
     }
-    return yield* tryPromise2({
+    const activeBackupRemIds = yield* sync3(() => {
+      const db = openStoreDb(cfg.storeDb);
+      try {
+        return new Set(listBackupArtifacts(db, { includeCleaned: false, limit: 1000 }).map((item) => String(item.backup_rem_id ?? "").trim()).filter(Boolean));
+      } finally {
+        db.close();
+      }
+    }).pipe(catchAll2(() => succeed8(new Set)));
+    const result = yield* tryPromise2({
       try: async () => await executeOutlineRemSubtree({
         id: resolvedId,
         dbPath: cfg.remnoteDb ?? workspace.dbPath,
         maxDepth: params3.depth,
         startOffset: params3.offset,
         maxNodes: params3.nodes,
-        format: params3.format === "json" ? "json" : "markdown",
+        format: "json",
         excludeProperties: params3.excludeProperties === true,
         includeEmpty: params3.includeEmpty === true,
         expandReferences: params3.expandReferences === false ? false : undefined,
         maxReferenceDepth: params3.maxReferenceDepth,
-        detail: params3.detail === true
+        detail: true
       }),
       catch: (error4) => cliErrorFromUnknown(error4, { code: "DB_UNAVAILABLE" })
     });
+    if (activeBackupRemIds.size === 0) {
+      if (params3.format === "json")
+        return result;
+      const tree2 = Array.isArray(result.tree) ? result.tree : [];
+      return {
+        ...result,
+        markdown: outlineNodesToMarkdown(tree2),
+        ...params3.detail === true ? {} : { tree: simplifyOutlineTree(tree2) }
+      };
+    }
+    const tree = Array.isArray(result.tree) ? result.tree : [];
+    const filteredTree = filterOutlineTreeByHiddenBackupSubtrees(tree, activeBackupRemIds, resolvedId);
+    const filtered = {
+      ...result,
+      nodeCount: filteredTree.length,
+      totalNodeCount: filteredTree.length,
+      hasMore: Boolean(result.hasMore),
+      nextOffset: result.nextOffset ?? null,
+      markdown: outlineNodesToMarkdown(filteredTree),
+      tree: params3.detail === true ? filteredTree : simplifyOutlineTree(filteredTree)
+    };
+    if (params3.format === "json")
+      return filtered;
+    return filtered;
   });
 }
+function filterOutlineTreeByHiddenBackupSubtrees(tree, hiddenIds, rootId) {
+  const out = [];
+  let skipDepth = null;
+  for (const node of tree) {
+    const depth = Number(node?.depth ?? 0);
+    if (skipDepth !== null) {
+      if (depth > skipDepth)
+        continue;
+      skipDepth = null;
+    }
+    const id2 = typeof node?.id === "string" ? node.id : "";
+    if (id2 && id2 !== rootId && hiddenIds.has(id2)) {
+      skipDepth = depth;
+      continue;
+    }
+    out.push(node);
+  }
+  return out;
+}
+function outlineNodesToMarkdown(nodes) {
+  return nodes.map((node) => {
+    const depth = Number(node?.depth ?? 0);
+    const text14 = typeof node?.text === "string" && node.text.trim() ? node.text : "(empty)";
+    return `${"  ".repeat(Math.max(0, depth))}- ${text14}`;
+  }).join(`
+`);
+}
+function simplifyOutlineTree(nodes) {
+  return nodes.map((node) => ({
+    id: node.id,
+    depth: node.depth,
+    text: node.text,
+    references: Array.isArray(node.references) ? node.references : []
+  }));
+}
 function executeDailyRemIdUseCase(params3) {
   return gen2(function* () {
     if (params3.date && params3.offsetDays !== undefined) {
@@ -96013,7 +96433,7 @@ var dailyWriteCommand = exports_Command.make("write", {
   const markdownRaw = markdownInput !== undefined ? yield* readMarkdownTextFromInputSpec(markdownInput) : undefined;
   const markdownValue = markdownRaw !== undefined ? trimBoundaryBlankLines(markdownRaw) : undefined;
   const textValue = text15 !== undefined ? trimBoundaryBlankLines(text15) : undefined;
-  if (textValue && !forceText2 && looksLikeStructuredMarkdown(textValue)) {
+  if (textValue && !forceText2 && looksLikeStructuredMarkdown2(textValue)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
       message: "Input passed to --text looks like structured Markdown. Use --markdown instead.",
@@ -96036,7 +96456,8 @@ var dailyWriteCommand = exports_Command.make("write", {
   const lines3 = content.split(`
 `).length;
   const chars = content.length;
-  const shouldBundle = bulkMode === "always" || bulkMode === "auto" && (hasBundleTitle || lines3 >= BULK_THRESHOLD_LINES || chars >= BULK_THRESHOLD_CHARS);
+  const writeShape = decideOutlineWriteShape({ markdown: markdownValue });
+  const shouldBundle = bulkMode === "always" || bulkMode === "auto" && (hasBundleTitle || (lines3 >= BULK_THRESHOLD_LINES || chars >= BULK_THRESHOLD_CHARS) && !(markdownValue !== undefined && !hasBundleTitle && writeShape.shape === "single_root_outline" && isSingleRootOutlineMarkdown(markdownValue)));
   const metaValue = meta ? yield* payloadSvc.readJson(meta) : undefined;
   const body = {
     version: 1,
@@ -96321,6 +96742,200 @@ var readDbCommand = exports_Command.make("db", {}).pipe(exports_Command.withSubc
 // src/commands/db/index.ts
 var dbCommand = readDbCommand;
 
+// src/commands/backup/cleanup.ts
+function optionToUndefined14(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var backupCleanupCommand = exports_Command.make("cleanup", {
+  apply: boolean8("apply"),
+  backupRemId: text9("backup-rem-id").pipe(optional5, map34(optionToUndefined14)),
+  maxDeleteSubtreeNodes: integer7("max-delete-subtree-nodes").pipe(optional5, map34(optionToUndefined14)),
+  state: choice5("state", ["pending", "orphan", "retained", "cleaned"]).pipe(repeated5),
+  kind: choice5("kind", ["children_replace", "selection_replace"]).pipe(repeated5),
+  olderThanHours: integer7("older-than-hours").pipe(optional5, map34(optionToUndefined14)),
+  limit: integer7("limit").pipe(withDefault5(100)),
+  wait: boolean8("wait"),
+  timeoutMs: integer7("timeout-ms").pipe(optional5, map34(optionToUndefined14)),
+  pollMs: integer7("poll-ms").pipe(optional5, map34(optionToUndefined14)),
+  notify: boolean8("no-notify").pipe(map34((value8) => !value8)),
+  ensureDaemon: boolean8("no-ensure-daemon").pipe(map34((value8) => !value8))
+}, ({
+  apply,
+  backupRemId,
+  maxDeleteSubtreeNodes,
+  state,
+  kind,
+  olderThanHours,
+  limit: limit2,
+  wait: wait2,
+  timeoutMs: timeoutMs2,
+  pollMs: pollMs2,
+  notify: notify2,
+  ensureDaemon: ensureDaemon3
+}) => gen2(function* () {
+  if (maxDeleteSubtreeNodes !== undefined && maxDeleteSubtreeNodes <= 0) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--max-delete-subtree-nodes must be >= 1",
+      exitCode: 2
+    }));
+  }
+  if (olderThanHours !== undefined && olderThanHours < 0) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--older-than-hours must be a non-negative integer",
+      exitCode: 2
+    }));
+  }
+  if (limit2 < 1) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--limit must be >= 1",
+      exitCode: 2
+    }));
+  }
+  if (!wait2 && (timeoutMs2 !== undefined || pollMs2 !== undefined)) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "Use --wait to enable --timeout-ms/--poll-ms",
+      exitCode: 2
+    }));
+  }
+  if (!apply && wait2) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--wait requires --apply",
+      exitCode: 2
+    }));
+  }
+  yield* failInRemoteMode({
+    command: "backup cleanup",
+    reason: "backup governance currently reads and updates the local store registry directly"
+  });
+  const cfg = yield* AppConfig;
+  const payloadSvc = yield* Payload;
+  const db = openStoreDb(cfg.storeDb);
+  try {
+    const states = state.length > 0 ? state : backupRemId ? [] : ["orphan"];
+    const items = listBackupArtifacts(db, {
+      states,
+      kinds: kind,
+      backupRemId,
+      olderThanHours,
+      limit: limit2
+    }).filter((item) => typeof item.backup_rem_id === "string" && item.backup_rem_id.length > 0);
+    if (backupRemId && items.length === 0) {
+      return yield* fail8(new CliError({
+        code: "INVALID_ARGS",
+        message: `No backup artifact found for --backup-rem-id ${backupRemId}`,
+        exitCode: 2
+      }));
+    }
+    if (!apply) {
+      yield* writeSuccess({
+        data: { dry_run: true, items, count: items.length },
+        ids: items.map((item) => item.backup_rem_id).filter(Boolean),
+        md: [`- dry_run: true`, `- count: ${items.length}`].join(`
+`)
+      });
+      return;
+    }
+    const ops = items.map((item) => normalizeOp({
+      type: "delete_backup_artifact",
+      payload: {
+        rem_id: item.backup_rem_id,
+        ...maxDeleteSubtreeNodes !== undefined ? { max_delete_subtree_nodes: maxDeleteSubtreeNodes } : {}
+      }
+    }, payloadSvc.normalizeKeys));
+    const data = ops.length > 0 ? yield* enqueueOps({
+      ops,
+      notify: notify2,
+      ensureDaemon: ensureDaemon3
+    }) : { txn_id: "", op_ids: [], notified: false };
+    updateBackupArtifactsCleanupState(db, {
+      sourceOpIds: items.map((item) => item.source_op_id),
+      cleanupState: wait2 && ops.length === 0 ? "cleaned" : "pending"
+    });
+    const waited = wait2 && data.txn_id ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs2, pollMs: pollMs2 }) : null;
+    if (waited?.status === "succeeded") {
+      updateBackupArtifactsCleanupState(db, {
+        sourceOpIds: items.map((item) => item.source_op_id),
+        cleanupState: "cleaned"
+      });
+    }
+    yield* writeSuccess({
+      data: {
+        dry_run: false,
+        items,
+        count: items.length,
+        ...data.txn_id ? data : {},
+        ...waited ? waited : {}
+      },
+      ids: [data.txn_id, ...data.op_ids].filter(Boolean),
+      md: [
+        `- dry_run: false`,
+        `- count: ${items.length}`,
+        ...data.txn_id ? [`- txn_id: ${data.txn_id}`] : [],
+        ...waited ? [`- status: ${waited.status}`, `- elapsed_ms: ${waited.elapsed_ms ?? ""}`] : []
+      ].join(`
+`)
+    });
+  } finally {
+    db.close();
+  }
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("Dry-run by default. Use --apply to enqueue delete_backup_artifact cleanup for backup artifacts."));
+
+// src/commands/backup/list.ts
+function optionToUndefined15(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var backupListCommand = exports_Command.make("list", {
+  state: choice5("state", ["pending", "orphan", "retained", "cleaned"]).pipe(repeated5),
+  kind: choice5("kind", ["children_replace", "selection_replace"]).pipe(repeated5),
+  olderThanHours: integer7("older-than-hours").pipe(optional5, map34(optionToUndefined15)),
+  limit: integer7("limit").pipe(withDefault5(100))
+}, ({ state, kind, olderThanHours, limit: limit2 }) => gen2(function* () {
+  if (olderThanHours !== undefined && olderThanHours < 0) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--older-than-hours must be a non-negative integer",
+      exitCode: 2
+    }));
+  }
+  if (limit2 < 1) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--limit must be >= 1",
+      exitCode: 2
+    }));
+  }
+  yield* failInRemoteMode({
+    command: "backup list",
+    reason: "backup governance currently reads the local store registry directly"
+  });
+  const cfg = yield* AppConfig;
+  const db = openStoreDb(cfg.storeDb);
+  try {
+    const items = listBackupArtifacts(db, {
+      states: state,
+      kinds: kind,
+      olderThanHours,
+      limit: limit2
+    });
+    yield* writeSuccess({
+      data: { items, count: items.length },
+      ids: items.map((item) => item.backup_rem_id).filter((item) => typeof item === "string" && item.length > 0),
+      md: [`- count: ${items.length}`, ...items.map((item) => `- ${item.source_op_id}: ${item.cleanup_state}`)].join(`
+`)
+    });
+  } finally {
+    db.close();
+  }
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("List backup artifacts from the local store registry."));
+
+// src/commands/backup/index.ts
+var backupCommand = exports_Command.make("backup", {}).pipe(exports_Command.withSubcommands([backupListCommand, backupCleanupCommand]), exports_Command.withDescription("Backup artifact governance commands."));
+
 // src/commands/ops/list.ts
 var opsListCommand = exports_Command.make("list", {}, () => gen2(function* () {
   const types = Object.keys(TYPES).sort();
@@ -96411,22 +97026,22 @@ var opsSchemaCommand = exports_Command.make("schema", { type: text9("type") }, (
 var opsCommand = exports_Command.make("ops", {}).pipe(exports_Command.withSubcommands([opsListCommand, opsSchemaCommand]));
 
 // src/commands/apply.ts
-function optionToUndefined14(opt) {
+function optionToUndefined16(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 function readOptionalText2(name) {
-  return text9(name).pipe(optional5, map34(optionToUndefined14));
+  return text9(name).pipe(optional5, map34(optionToUndefined16));
 }
 var payloadSpec = text9("payload");
 var metaSpec2 = readOptionalText2("meta");
 var clientId2 = readOptionalText2("client-id");
 var idempotencyKey2 = readOptionalText2("idempotency-key");
-var priority2 = integer7("priority").pipe(optional5, map34(optionToUndefined14));
+var priority2 = integer7("priority").pipe(optional5, map34(optionToUndefined16));
 var notify2 = boolean8("no-notify").pipe(map34((v) => !v));
 var ensureDaemon3 = boolean8("no-ensure-daemon").pipe(map34((v) => !v));
 var wait2 = boolean8("wait");
-var timeoutMs2 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined14));
-var pollMs2 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined14));
+var timeoutMs2 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined16));
+var pollMs2 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined16));
 var applyCommand = exports_Command.make("apply", {
   payload: payloadSpec,
   notify: notify2,
@@ -96861,14 +97476,14 @@ function ensureApiDaemon(params3) {
 }
 
 // src/commands/api/ensure.ts
-function optionToUndefined15(opt) {
+function optionToUndefined17(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var host = text9("host").pipe(optional5, map34(optionToUndefined15));
-var port3 = integer7("port").pipe(optional5, map34(optionToUndefined15));
-var pidFile8 = text9("pid-file").pipe(optional5, map34(optionToUndefined15));
-var logFile5 = text9("log-file").pipe(optional5, map34(optionToUndefined15));
-var stateFile3 = text9("state-file").pipe(optional5, map34(optionToUndefined15));
+var host = text9("host").pipe(optional5, map34(optionToUndefined17));
+var port3 = integer7("port").pipe(optional5, map34(optionToUndefined17));
+var pidFile8 = text9("pid-file").pipe(optional5, map34(optionToUndefined17));
+var logFile5 = text9("log-file").pipe(optional5, map34(optionToUndefined17));
+var stateFile3 = text9("state-file").pipe(optional5, map34(optionToUndefined17));
 var apiEnsureCommand = exports_Command.make("ensure", {
   host,
   port: port3,
@@ -96891,11 +97506,11 @@ var apiEnsureCommand = exports_Command.make("ensure", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/api/logs.ts
-function optionToUndefined16(opt) {
+function optionToUndefined18(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var pidFile9 = text9("pid-file").pipe(optional5, map34(optionToUndefined16));
-var file7 = text9("file").pipe(optional5, map34(optionToUndefined16));
+var pidFile9 = text9("pid-file").pipe(optional5, map34(optionToUndefined18));
+var file7 = text9("file").pipe(optional5, map34(optionToUndefined18));
 var apiLogsCommand = exports_Command.make("logs", { pidFile: pidFile9, file: file7, lines: integer7("lines").pipe(withDefault5(200)), follow: boolean8("follow") }, ({ pidFile: pidFile10, file: file8, lines: lines3, follow }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const apiFiles = yield* ApiDaemonFiles;
@@ -96948,14 +97563,14 @@ var apiLogsCommand = exports_Command.make("logs", { pidFile: pidFile9, file: fil
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/api/restart.ts
-function optionToUndefined17(opt) {
+function optionToUndefined19(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var host2 = text9("host").pipe(optional5, map34(optionToUndefined17));
-var port4 = integer7("port").pipe(optional5, map34(optionToUndefined17));
-var pidFile10 = text9("pid-file").pipe(optional5, map34(optionToUndefined17));
-var logFile6 = text9("log-file").pipe(optional5, map34(optionToUndefined17));
-var stateFile4 = text9("state-file").pipe(optional5, map34(optionToUndefined17));
+var host2 = text9("host").pipe(optional5, map34(optionToUndefined19));
+var port4 = integer7("port").pipe(optional5, map34(optionToUndefined19));
+var pidFile10 = text9("pid-file").pipe(optional5, map34(optionToUndefined19));
+var logFile6 = text9("log-file").pipe(optional5, map34(optionToUndefined19));
+var stateFile4 = text9("state-file").pipe(optional5, map34(optionToUndefined19));
 var apiRestartCommand = exports_Command.make("restart", {
   force: boolean8("force"),
   host: host2,
@@ -97446,23 +98061,23 @@ function runHttpApiRuntime(params3) {
 }
 
 // src/commands/api/serve.ts
-function optionToUndefined18(opt) {
+function optionToUndefined20(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var host3 = text9("host").pipe(optional5, map34(optionToUndefined18));
-var port5 = integer7("port").pipe(optional5, map34(optionToUndefined18));
-var stateFile5 = text9("state-file").pipe(optional5, map34(optionToUndefined18));
+var host3 = text9("host").pipe(optional5, map34(optionToUndefined20));
+var port5 = integer7("port").pipe(optional5, map34(optionToUndefined20));
+var stateFile5 = text9("state-file").pipe(optional5, map34(optionToUndefined20));
 var apiServeCommand = exports_Command.make("serve", { host: host3, port: port5, stateFile: stateFile5 }, ({ host: host4, port: port6, stateFile: stateFile6 }) => runHttpApiRuntime({ host: host4, port: port6, stateFile: stateFile6 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/api/start.ts
-function optionToUndefined19(opt) {
+function optionToUndefined21(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var host4 = text9("host").pipe(optional5, map34(optionToUndefined19));
-var port6 = integer7("port").pipe(optional5, map34(optionToUndefined19));
-var pidFile11 = text9("pid-file").pipe(optional5, map34(optionToUndefined19));
-var logFile7 = text9("log-file").pipe(optional5, map34(optionToUndefined19));
-var stateFile6 = text9("state-file").pipe(optional5, map34(optionToUndefined19));
+var host4 = text9("host").pipe(optional5, map34(optionToUndefined21));
+var port6 = integer7("port").pipe(optional5, map34(optionToUndefined21));
+var pidFile11 = text9("pid-file").pipe(optional5, map34(optionToUndefined21));
+var logFile7 = text9("log-file").pipe(optional5, map34(optionToUndefined21));
+var stateFile6 = text9("state-file").pipe(optional5, map34(optionToUndefined21));
 var apiStartCommand = exports_Command.make("start", {
   host: host4,
   port: port6,
@@ -97485,11 +98100,11 @@ var apiStartCommand = exports_Command.make("start", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/api/status.ts
-function optionToUndefined20(opt) {
+function optionToUndefined22(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var pidFile12 = text9("pid-file").pipe(optional5, map34(optionToUndefined20));
-var stateFile7 = text9("state-file").pipe(optional5, map34(optionToUndefined20));
+var pidFile12 = text9("pid-file").pipe(optional5, map34(optionToUndefined22));
+var stateFile7 = text9("state-file").pipe(optional5, map34(optionToUndefined22));
 var apiStatusCommand = exports_Command.make("status", { pidFile: pidFile12, stateFile: stateFile7 }, ({ pidFile: pidFile13, stateFile: stateFile8 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const apiFiles = yield* ApiDaemonFiles;
@@ -97548,11 +98163,11 @@ var apiStatusCommand = exports_Command.make("status", { pidFile: pidFile12, stat
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/api/stop.ts
-function optionToUndefined21(opt) {
+function optionToUndefined23(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var pidFile13 = text9("pid-file").pipe(optional5, map34(optionToUndefined21));
-var stateFile8 = text9("state-file").pipe(optional5, map34(optionToUndefined21));
+var pidFile13 = text9("pid-file").pipe(optional5, map34(optionToUndefined23));
+var stateFile8 = text9("state-file").pipe(optional5, map34(optionToUndefined23));
 var apiStopCommand = exports_Command.make("stop", { force: boolean8("force"), pidFile: pidFile13, stateFile: stateFile8 }, ({ force, pidFile: pidFile14, stateFile: stateFile9 }) => gen2(function* () {
   const apiFiles = yield* ApiDaemonFiles;
   const proc = yield* Process;
@@ -97628,11 +98243,11 @@ var apiCommand = exports_Command.make("api", {}).pipe(exports_Command.withSubcom
 ]));
 
 // src/commands/read/selection/current.ts
-function optionToUndefined22(opt) {
+function optionToUndefined24(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile9 = text9("state-file").pipe(optional5, map34(optionToUndefined22));
-var staleMs2 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined22));
+var stateFile9 = text9("state-file").pipe(optional5, map34(optionToUndefined24));
+var staleMs2 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined24));
 function toCompact(data) {
   return {
     selection_kind: data?.selection_kind ?? "",
@@ -97678,11 +98293,11 @@ var readSelectionCurrentCommand = exports_Command.make("current", { stateFile: s
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/selection/outline.ts
-function optionToUndefined23(opt) {
+function optionToUndefined25(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile10 = text9("state-file").pipe(optional5, map34(optionToUndefined23));
-var staleMs3 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined23));
+var stateFile10 = text9("state-file").pipe(optional5, map34(optionToUndefined25));
+var staleMs3 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined25));
 var maxDepth = integer7("max-depth").pipe(withDefault5(10));
 var maxNodes = integer7("max-nodes").pipe(withDefault5(1000));
 var readSelectionOutlineCommand = exports_Command.make("outline", {
@@ -97693,7 +98308,7 @@ var readSelectionOutlineCommand = exports_Command.make("outline", {
   excludeProperties: boolean8("exclude-properties"),
   includeEmpty: boolean8("include-empty"),
   expandReferences: boolean8("expand-references"),
-  maxReferenceDepth: integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined23)),
+  maxReferenceDepth: integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined25)),
   detail: boolean8("detail")
 }, ({
   stateFile: stateFile11,
@@ -97836,11 +98451,11 @@ var readSelectionOutlineCommand = exports_Command.make("outline", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/selection/roots.ts
-function optionToUndefined24(opt) {
+function optionToUndefined26(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile11 = text9("state-file").pipe(optional5, map34(optionToUndefined24));
-var staleMs4 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined24));
+var stateFile11 = text9("state-file").pipe(optional5, map34(optionToUndefined26));
+var staleMs4 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined26));
 var readSelectionRootsCommand = exports_Command.make("roots", { stateFile: stateFile11, staleMs: staleMs4 }, ({ stateFile: stateFile12, staleMs: staleMs5 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -97877,11 +98492,11 @@ var readSelectionRootsCommand = exports_Command.make("roots", { stateFile: state
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/selection/snapshot.ts
-function optionToUndefined25(opt) {
+function optionToUndefined27(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile12 = text9("state-file").pipe(optional5, map34(optionToUndefined25));
-var staleMs5 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined25));
+var stateFile12 = text9("state-file").pipe(optional5, map34(optionToUndefined27));
+var staleMs5 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined27));
 var readSelectionSnapshotCommand = exports_Command.make("snapshot", { stateFile: stateFile12, staleMs: staleMs5 }, ({ stateFile: stateFile13, staleMs: staleMs6 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -97928,11 +98543,11 @@ var readSelectionSnapshotCommand = exports_Command.make("snapshot", { stateFile:
 var readSelectionCommand = exports_Command.make("selection", {}).pipe(exports_Command.withSubcommands([readSelectionSnapshotCommand, readSelectionRootsCommand, readSelectionCurrentCommand, readSelectionOutlineCommand]));
 
 // src/commands/read/uiContext/describe.ts
-function optionToUndefined26(opt) {
+function optionToUndefined28(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile13 = text9("state-file").pipe(optional5, map34(optionToUndefined26));
-var staleMs6 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined26));
+var stateFile13 = text9("state-file").pipe(optional5, map34(optionToUndefined28));
+var staleMs6 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined28));
 var selectionLimit = integer7("selection-limit").pipe(withDefault5(5));
 function normalizeText4(value8) {
   return typeof value8 === "string" ? value8.trim() : "";
@@ -98191,11 +98806,11 @@ var readUiContextDescribeCommand = exports_Command.make("describe", { stateFile:
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/uiContext/focused-rem.ts
-function optionToUndefined27(opt) {
+function optionToUndefined29(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile14 = text9("state-file").pipe(optional5, map34(optionToUndefined27));
-var staleMs7 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined27));
+var stateFile14 = text9("state-file").pipe(optional5, map34(optionToUndefined29));
+var staleMs7 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined29));
 var readUiContextFocusedRemCommand = exports_Command.make("focused-rem", { stateFile: stateFile14, staleMs: staleMs7 }, ({ stateFile: stateFile15, staleMs: staleMs8 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -98223,11 +98838,11 @@ var readUiContextFocusedRemCommand = exports_Command.make("focused-rem", { state
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/uiContext/page.ts
-function optionToUndefined28(opt) {
+function optionToUndefined30(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile15 = text9("state-file").pipe(optional5, map34(optionToUndefined28));
-var staleMs8 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined28));
+var stateFile15 = text9("state-file").pipe(optional5, map34(optionToUndefined30));
+var staleMs8 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined30));
 var readUiContextPageCommand = exports_Command.make("page", { stateFile: stateFile15, staleMs: staleMs8 }, ({ stateFile: stateFile16, staleMs: staleMs9 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -98255,11 +98870,11 @@ var readUiContextPageCommand = exports_Command.make("page", { stateFile: stateFi
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/uiContext/snapshot.ts
-function optionToUndefined29(opt) {
+function optionToUndefined31(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile16 = text9("state-file").pipe(optional5, map34(optionToUndefined29));
-var staleMs9 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined29));
+var stateFile16 = text9("state-file").pipe(optional5, map34(optionToUndefined31));
+var staleMs9 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined31));
 var readUiContextSnapshotCommand = exports_Command.make("snapshot", { stateFile: stateFile16, staleMs: staleMs9 }, ({ stateFile: stateFile17, staleMs: staleMs10 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -98293,11 +98908,11 @@ var readUiContextCommand = exports_Command.make("ui-context", {}).pipe(exports_C
 ]));
 
 // src/commands/plugin/current.ts
-function optionToUndefined30(opt) {
+function optionToUndefined32(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var stateFile17 = text9("state-file").pipe(optional5, map34(optionToUndefined30));
-var staleMs10 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined30));
+var stateFile17 = text9("state-file").pipe(optional5, map34(optionToUndefined32));
+var staleMs10 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined32));
 var selectionLimit2 = integer7("selection-limit").pipe(withDefault5(5));
 function toCompact2(data) {
   return {
@@ -98343,70 +98958,1013 @@ var pluginCurrentCommand = exports_Command.make("current", { stateFile: stateFil
   yield* writeSuccess({ data: out, ids: ids3, md });
 }).pipe(catchAll2(writeFailure)));
 
-// src/commands/plugin/search.ts
-function optionToUndefined31(opt) {
-  return isSome2(opt) ? opt.value : undefined;
+// src/lib/pluginServerHealth.ts
+function checkPluginServerHealth(baseUrl, timeoutMs3) {
+  return tryPromise2({
+    try: async () => {
+      const controller = new AbortController;
+      const timer2 = setTimeout(() => controller.abort(), timeoutMs3);
+      try {
+        const res = await fetch(`${baseUrl}/manifest.json`, { signal: controller.signal });
+        if (!res.ok) {
+          throw new Error(`Unexpected response status: ${res.status}`);
+        }
+        return { base_url: baseUrl };
+      } finally {
+        clearTimeout(timer2);
+      }
+    },
+    catch: (error4) => new CliError({
+      code: "PLUGIN_UNAVAILABLE",
+      message: "Plugin server is unavailable",
+      exitCode: 1,
+      details: { base_url: baseUrl, error: String(error4?.message || error4) }
+    })
+  });
 }
-var searchContextRemId = text9("context-rem-id").pipe(optional5, map34(optionToUndefined31));
-var limit2 = integer7("limit").pipe(withDefault5(20));
-var timeoutMs3 = integer7("timeout-ms").pipe(withDefault5(3000));
-var ensureDaemon4 = boolean8("no-ensure-daemon").pipe(map34((v) => !v));
-function clampInt6(value8, min5, max7) {
-  if (!Number.isFinite(value8))
-    return min5;
-  return Math.max(min5, Math.min(max7, Math.floor(value8)));
+function waitForPluginServerHealth(baseUrl, waitMs, timeoutMs3) {
+  return gen2(function* () {
+    if (!Number.isFinite(waitMs) || waitMs < 0) {
+      return yield* fail8(new CliError({
+        code: "INVALID_ARGS",
+        message: "--wait must be a non-negative integer (ms)",
+        exitCode: 2,
+        details: { wait_ms: waitMs }
+      }));
+    }
+    if (waitMs === 0)
+      return;
+    const deadline = Date.now() + waitMs;
+    while (Date.now() < deadline) {
+      const remaining = Math.max(0, deadline - Date.now());
+      const res = yield* checkPluginServerHealth(baseUrl, Math.min(timeoutMs3, Math.max(1, remaining))).pipe(either3);
+      if (isRight2(res))
+        return;
+      yield* sleep4(millis(300));
+    }
+    return yield* fail8(new CliError({
+      code: "PLUGIN_UNAVAILABLE",
+      message: `Timed out waiting for plugin server to become available (${waitMs}ms)`,
+      exitCode: 1,
+      details: { base_url: baseUrl, wait_ms: waitMs },
+      hint: ["agent-remnote plugin status --json", "agent-remnote plugin logs --lines 200"]
+    }));
+  });
 }
-var pluginSearchCommand = exports_Command.make("search", { query: text9("query"), searchContextRemId, limit: limit2, timeoutMs: timeoutMs3, ensureDaemon: ensureDaemon4 }, ({ query, searchContextRemId: searchContextRemId2, limit: limit3, timeoutMs: timeoutMs4, ensureDaemon: ensureDaemon5 }) => gen2(function* () {
-  const cfg = yield* AppConfig;
-  const ws = yield* WsClient;
-  const hostApi = yield* HostApiClient;
-  const limitEffective = clampInt6(limit3, 1, 100);
-  const rpcTimeoutMs = clampInt6(timeoutMs4, 1, 5000);
-  const wsTimeoutMs = clampInt6(rpcTimeoutMs + 2000, 2000, 15000);
-  const result = cfg.apiBaseUrl ? yield* hostApi.searchPlugin({
-    baseUrl: cfg.apiBaseUrl,
-    query,
-    searchContextRemId: searchContextRemId2,
-    limit: limitEffective,
-    timeoutMs: rpcTimeoutMs,
-    ensureDaemon: ensureDaemon5
-  }) : yield* gen2(function* () {
-    if (ensureDaemon5) {
-      yield* ensureWsSupervisor({ waitMs: WS_START_WAIT_DEFAULT_MS });
+
+// src/services/PluginServerFiles.ts
+import { promises as fs20 } from "node:fs";
+import path26 from "node:path";
+class PluginServerFiles extends Tag2("PluginServerFiles")() {
+}
+function ensureDir10(p3) {
+  return fs20.mkdir(path26.dirname(p3), { recursive: true }).then(() => {
+    return;
+  });
+}
+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");
+}
+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");
+}
+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");
+}
+function parseJson3(raw4, filePath) {
+  try {
+    return JSON.parse(raw4);
+  } catch (error4) {
+    throw new CliError({
+      code: "INTERNAL",
+      message: `Failed to parse JSON file: ${filePath}`,
+      exitCode: 1,
+      details: { file_path: filePath, error: String(error4?.message || error4) }
+    });
+  }
+}
+var PluginServerFilesLive = succeed10(PluginServerFiles, {
+  defaultPidFile: defaultPidFile3,
+  defaultLogFile: defaultLogFile3,
+  defaultStateFile: defaultStateFile3,
+  readPidFile: (pidFilePath) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(pidFilePath);
+      const raw4 = await fs20.readFile(resolved, "utf8");
+      return parseJson3(raw4, resolved);
+    },
+    catch: (error4) => {
+      const code2 = error4?.code;
+      if (code2 === "ENOENT")
+        return;
+      if (isCliError(error4))
+        return error4;
+      return new CliError({
+        code: "INTERNAL",
+        message: "Failed to read plugin server pid file",
+        exitCode: 1,
+        details: { file_path: pidFilePath, error: String(error4?.message || error4) }
+      });
     }
-    return yield* ws.search({
-      url: cfg.wsUrl,
-      timeoutMs: wsTimeoutMs,
-      queryText: query,
-      searchContextRemId: searchContextRemId2,
-      limit: limitEffective,
-      rpcTimeoutMs
+  }).pipe(catchAll2((error4) => {
+    if (error4 === undefined)
+      return succeed8(undefined);
+    return fail8(error4);
+  })),
+  writePidFile: (pidFilePath, value8) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(pidFilePath);
+      await ensureDir10(resolved);
+      await fs20.writeFile(resolved, `${JSON.stringify(value8, null, 2)}
+`, "utf8");
+    },
+    catch: (error4) => new CliError({
+      code: "INTERNAL",
+      message: "Failed to write plugin server pid file",
+      exitCode: 1,
+      details: { file_path: pidFilePath, error: String(error4?.message || error4) }
+    })
+  }),
+  deletePidFile: (pidFilePath) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(pidFilePath);
+      await fs20.rm(resolved, { force: true });
+    },
+    catch: (error4) => new CliError({
+      code: "INTERNAL",
+      message: "Failed to delete plugin server pid file",
+      exitCode: 1,
+      details: { file_path: pidFilePath, error: String(error4?.message || error4) }
+    })
+  }),
+  readStateFile: (stateFilePath) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(stateFilePath);
+      const raw4 = await fs20.readFile(resolved, "utf8");
+      return parseJson3(raw4, resolved);
+    },
+    catch: (error4) => {
+      const code2 = error4?.code;
+      if (code2 === "ENOENT")
+        return;
+      if (isCliError(error4))
+        return error4;
+      return new CliError({
+        code: "INTERNAL",
+        message: "Failed to read plugin server state file",
+        exitCode: 1,
+        details: { file_path: stateFilePath, error: String(error4?.message || error4) }
+      });
+    }
+  }).pipe(catchAll2((error4) => {
+    if (error4 === undefined)
+      return succeed8(undefined);
+    return fail8(error4);
+  })),
+  writeStateFile: (stateFilePath, value8) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(stateFilePath);
+      await ensureDir10(resolved);
+      await fs20.writeFile(resolved, `${JSON.stringify(value8, null, 2)}
+`, "utf8");
+    },
+    catch: (error4) => new CliError({
+      code: "INTERNAL",
+      message: "Failed to write plugin server state file",
+      exitCode: 1,
+      details: { file_path: stateFilePath, error: String(error4?.message || error4) }
+    })
+  }),
+  deleteStateFile: (stateFilePath) => tryPromise2({
+    try: async () => {
+      const resolved = resolveUserFilePath(stateFilePath);
+      await fs20.rm(resolved, { force: true });
+    },
+    catch: (error4) => new CliError({
+      code: "INTERNAL",
+      message: "Failed to delete plugin server state file",
+      exitCode: 1,
+      details: { file_path: stateFilePath, error: String(error4?.message || error4) }
+    })
+  })
+});
+
+// src/commands/plugin/_shared.ts
+var PLUGIN_SERVER_HEALTH_TIMEOUT_MS = 2000;
+var PLUGIN_SERVER_START_WAIT_DEFAULT_MS = 15000;
+var PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS = 5000;
+var PLUGIN_SERVER_DEFAULT_HOST = "127.0.0.1";
+var PLUGIN_SERVER_DEFAULT_PORT = 8080;
+function pluginServerLocalBaseUrl(host5, port7) {
+  const normalizedHost = host5 === "0.0.0.0" || host5 === "::" ? "127.0.0.1" : host5;
+  return `http://${normalizedHost}:${port7}`;
+}
+function childCommandLine3(params3) {
+  const command = process.argv[0];
+  const script = process.argv[1];
+  if (!command || !script) {
+    throw new CliError({
+      code: "INTERNAL",
+      message: "Unable to determine the current executable entrypoint (process.argv is incomplete)",
+      exitCode: 1,
+      details: { argv: process.argv }
     });
+  }
+  const execArgv = Array.isArray(process.execArgv) ? process.execArgv : [];
+  const args2 = [...execArgv, script, "plugin", "serve", "--host", params3.host, "--port", String(params3.port), "--state-file", params3.stateFile];
+  return { command, args: args2 };
+}
+function toPidFileValue3(params3) {
+  return {
+    pid: params3.pid,
+    started_at: params3.startedAt,
+    host: params3.host,
+    port: params3.port,
+    log_file: params3.logFile,
+    state_file: params3.stateFile,
+    cmd: params3.cmd
+  };
+}
+function startPluginServer(params3) {
+  return gen2(function* () {
+    const files = yield* PluginServerFiles;
+    const proc = yield* Process;
+    const host5 = params3.host ?? PLUGIN_SERVER_DEFAULT_HOST;
+    const port7 = params3.port ?? PLUGIN_SERVER_DEFAULT_PORT;
+    const pidFilePath = resolveUserFilePath(params3.pidFile ?? files.defaultPidFile());
+    const logFilePath = resolveUserFilePath(params3.logFile ?? files.defaultLogFile());
+    const stateFilePath = resolveUserFilePath(params3.stateFile ?? files.defaultStateFile());
+    const baseUrl = pluginServerLocalBaseUrl(host5, port7);
+    const existing = yield* files.readPidFile(pidFilePath);
+    if (existing) {
+      const alive = yield* proc.isPidRunning(existing.pid);
+      if (!alive) {
+        yield* files.deletePidFile(pidFilePath);
+      } else {
+        return {
+          started: false,
+          pid: existing.pid,
+          pid_file: pidFilePath,
+          log_file: existing.log_file ?? logFilePath,
+          state_file: existing.state_file ?? stateFilePath,
+          base_url: baseUrl
+        };
+      }
+    }
+    const pre = yield* checkPluginServerHealth(baseUrl, PLUGIN_SERVER_HEALTH_TIMEOUT_MS).pipe(either3);
+    if (isRight2(pre)) {
+      return {
+        started: false,
+        pid_file: pidFilePath,
+        log_file: logFilePath,
+        state_file: stateFilePath,
+        base_url: baseUrl
+      };
+    }
+    const cmd = yield* try_3({
+      try: () => childCommandLine3({ host: host5, port: port7, stateFile: stateFilePath }),
+      catch: (error4) => isCliError(error4) ? error4 : new CliError({
+        code: "INTERNAL",
+        message: "Failed to start plugin server",
+        exitCode: 1,
+        details: { error: String(error4?.message || error4) }
+      })
+    });
+    const pid = yield* proc.spawnDetached({ command: cmd.command, args: cmd.args, logFile: logFilePath });
+    yield* files.writePidFile(pidFilePath, toPidFileValue3({
+      pid,
+      startedAt: Date.now(),
+      host: host5,
+      port: port7,
+      logFile: logFilePath,
+      stateFile: stateFilePath,
+      cmd: [cmd.command, ...cmd.args]
+    }));
+    yield* waitForPluginServerHealth(baseUrl, params3.waitMs, PLUGIN_SERVER_HEALTH_TIMEOUT_MS);
+    return {
+      started: true,
+      pid,
+      pid_file: pidFilePath,
+      log_file: logFilePath,
+      state_file: stateFilePath,
+      base_url: baseUrl
+    };
+  });
+}
+function ensurePluginServer(params3) {
+  return gen2(function* () {
+    const files = yield* PluginServerFiles;
+    const proc = yield* Process;
+    const host5 = params3.host ?? PLUGIN_SERVER_DEFAULT_HOST;
+    const port7 = params3.port ?? PLUGIN_SERVER_DEFAULT_PORT;
+    const pidFilePath = resolveUserFilePath(params3.pidFile ?? files.defaultPidFile());
+    const logFilePath = resolveUserFilePath(params3.logFile ?? files.defaultLogFile());
+    const stateFilePath = resolveUserFilePath(params3.stateFile ?? files.defaultStateFile());
+    const baseUrl = pluginServerLocalBaseUrl(host5, port7);
+    const pre = yield* checkPluginServerHealth(baseUrl, PLUGIN_SERVER_HEALTH_TIMEOUT_MS).pipe(either3);
+    if (isRight2(pre)) {
+      const existing = yield* files.readPidFile(pidFilePath);
+      if (existing) {
+        const alive = yield* proc.isPidRunning(existing.pid);
+        if (alive) {
+          return {
+            started: false,
+            pid: existing.pid,
+            pid_file: pidFilePath,
+            log_file: existing.log_file ?? logFilePath,
+            state_file: existing.state_file ?? stateFilePath,
+            base_url: baseUrl
+          };
+        }
+      }
+      return {
+        started: false,
+        pid_file: pidFilePath,
+        log_file: logFilePath,
+        state_file: stateFilePath,
+        base_url: baseUrl
+      };
+    }
+    return yield* startPluginServer(params3);
+  });
+}
+
+// src/commands/plugin/ensure.ts
+function optionToUndefined33(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var host5 = text9("host").pipe(optional5, map34(optionToUndefined33));
+var port7 = integer7("port").pipe(optional5, map34(optionToUndefined33));
+var pidFile14 = text9("pid-file").pipe(optional5, map34(optionToUndefined33));
+var logFile8 = text9("log-file").pipe(optional5, map34(optionToUndefined33));
+var stateFile18 = text9("state-file").pipe(optional5, map34(optionToUndefined33));
+var pluginEnsureCommand = exports_Command.make("ensure", {
+  host: host5,
+  port: port7,
+  wait: integer7("wait").pipe(withDefault5(PLUGIN_SERVER_START_WAIT_DEFAULT_MS)),
+  pidFile: pidFile14,
+  logFile: logFile8,
+  stateFile: stateFile18
+}, ({ host: host6, port: port8, wait: wait3, pidFile: pidFile15, logFile: logFile9, stateFile: stateFile19 }) => gen2(function* () {
+  const result = yield* ensurePluginServer({ host: host6, port: port8, waitMs: wait3, pidFile: pidFile15, logFile: logFile9, stateFile: stateFile19 });
+  yield* writeSuccess({
+    data: result,
+    md: `- started: ${result.started}
+- pid: ${result.pid ?? ""}
+- pid_file: ${result.pid_file}
+- log_file: ${result.log_file}
+- state_file: ${result.state_file}
+- base_url: ${result.base_url}
+`
+  });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/logs.ts
+function optionToUndefined34(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var pidFile15 = text9("pid-file").pipe(optional5, map34(optionToUndefined34));
+var file8 = text9("file").pipe(optional5, map34(optionToUndefined34));
+var pluginLogsCommand = exports_Command.make("logs", { pidFile: pidFile15, file: file8, lines: integer7("lines").pipe(withDefault5(200)), follow: boolean8("follow") }, ({ pidFile: pidFile16, file: file9, lines: lines3, follow }) => gen2(function* () {
+  const cfg = yield* AppConfig;
+  const files = yield* PluginServerFiles;
+  const fsAccess = yield* FsAccess;
+  const subprocess = yield* Subprocess;
+  if (!Number.isFinite(lines3) || lines3 <= 0) {
+    return yield* fail8(new CliError({ code: "INVALID_ARGS", message: "--lines must be a positive integer", exitCode: 2 }));
+  }
+  if (cfg.format === "ids") {
+    return yield* fail8(new CliError({ code: "INVALID_ARGS", message: "This command does not support --ids output", exitCode: 2 }));
+  }
+  const pidFilePath = resolveUserFilePath(pidFile16 ?? files.defaultPidFile());
+  const pidInfo = yield* files.readPidFile(pidFilePath);
+  const logFilePath = resolveUserFilePath(file9 ?? pidInfo?.log_file ?? files.defaultLogFile());
+  const exists3 = yield* fsAccess.isFile(logFilePath);
+  if (!exists3) {
+    return yield* fail8(new CliError({
+      code: "INTERNAL",
+      message: `Log file not found: ${logFilePath}`,
+      exitCode: 1,
+      hint: ["agent-remnote plugin start", "agent-remnote plugin status"]
+    }));
+  }
+  if (follow) {
+    if (cfg.format === "json") {
+      return yield* fail8(new CliError({ code: "INVALID_ARGS", message: "--follow is not compatible with --json", exitCode: 2 }));
+    }
+    yield* subprocess.runInherit({ command: "tail", args: ["-n", String(lines3), "-f", logFilePath] });
+    return;
+  }
+  const res = yield* subprocess.run({
+    command: "tail",
+    args: ["-n", String(lines3), logFilePath],
+    timeoutMs: 1e4
+  });
+  if (res.exitCode !== 0) {
+    return yield* fail8(new CliError({
+      code: "INTERNAL",
+      message: "Failed to read log file",
+      exitCode: 1,
+      details: { file: logFilePath, exitCode: res.exitCode, stderr: res.stderr.trim() }
+    }));
+  }
+  const tailLines = res.stdout.trimEnd();
+  yield* writeSuccess({
+    data: { file: logFilePath, lines: lines3, content: tailLines },
+    md: tailLines.length > 0 ? `${tailLines}
+` : ""
+  });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/restart.ts
+function optionToUndefined35(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var host6 = text9("host").pipe(optional5, map34(optionToUndefined35));
+var port8 = integer7("port").pipe(optional5, map34(optionToUndefined35));
+var pidFile16 = text9("pid-file").pipe(optional5, map34(optionToUndefined35));
+var logFile9 = text9("log-file").pipe(optional5, map34(optionToUndefined35));
+var stateFile19 = text9("state-file").pipe(optional5, map34(optionToUndefined35));
+var pluginRestartCommand = exports_Command.make("restart", {
+  force: boolean8("force"),
+  host: host6,
+  port: port8,
+  wait: integer7("wait").pipe(withDefault5(PLUGIN_SERVER_START_WAIT_DEFAULT_MS)),
+  pidFile: pidFile16,
+  logFile: logFile9,
+  stateFile: stateFile19
+}, ({ force, host: host7, port: port9, wait: wait3, pidFile: pidFile17, logFile: logFile10, stateFile: stateFile20 }) => gen2(function* () {
+  const files = yield* PluginServerFiles;
+  const proc = yield* Process;
+  const pidFilePath = resolveUserFilePath(pidFile17 ?? files.defaultPidFile());
+  const existing = yield* files.readPidFile(pidFilePath);
+  let stoppedPid;
+  if (existing) {
+    const alive = yield* proc.isPidRunning(existing.pid);
+    if (alive) {
+      yield* proc.kill(existing.pid, "SIGTERM");
+      const exited = yield* proc.waitForExit({ pid: existing.pid, timeoutMs: PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS });
+      if (!exited && force) {
+        yield* proc.kill(existing.pid, "SIGKILL");
+        yield* proc.waitForExit({ pid: existing.pid, timeoutMs: PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS });
+      }
+      stoppedPid = existing.pid;
+    }
+    yield* files.deletePidFile(pidFilePath).pipe(catchAll2(() => _void));
+    yield* files.deleteStateFile(existing.state_file ?? resolveUserFilePath(stateFile20 ?? files.defaultStateFile())).pipe(catchAll2(() => _void));
+  }
+  const started = yield* startPluginServer({ host: host7, port: port9, waitMs: wait3, pidFile: pidFile17, logFile: logFile10, stateFile: stateFile20 });
+  yield* writeSuccess({
+    data: { stopped_pid: stoppedPid, ...started },
+    md: `- stopped_pid: ${stoppedPid ?? ""}
+- started: ${started.started}
+- pid: ${started.pid ?? ""}
+- pid_file: ${started.pid_file}
+- base_url: ${started.base_url}
+`
+  });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/search.ts
+function optionToUndefined36(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var searchContextRemId = text9("context-rem-id").pipe(optional5, map34(optionToUndefined36));
+var limit2 = integer7("limit").pipe(withDefault5(20));
+var timeoutMs3 = integer7("timeout-ms").pipe(withDefault5(3000));
+var ensureDaemon4 = boolean8("no-ensure-daemon").pipe(map34((v) => !v));
+function clampInt6(value8, min5, max7) {
+  if (!Number.isFinite(value8))
+    return min5;
+  return Math.max(min5, Math.min(max7, Math.floor(value8)));
+}
+var pluginSearchCommand = exports_Command.make("search", { query: text9("query"), searchContextRemId, limit: limit2, timeoutMs: timeoutMs3, ensureDaemon: ensureDaemon4 }, ({ query, searchContextRemId: searchContextRemId2, limit: limit3, timeoutMs: timeoutMs4, ensureDaemon: ensureDaemon5 }) => gen2(function* () {
+  const cfg = yield* AppConfig;
+  const ws = yield* WsClient;
+  const hostApi = yield* HostApiClient;
+  const limitEffective = clampInt6(limit3, 1, 100);
+  const rpcTimeoutMs = clampInt6(timeoutMs4, 1, 5000);
+  const wsTimeoutMs = clampInt6(rpcTimeoutMs + 2000, 2000, 15000);
+  const result = cfg.apiBaseUrl ? yield* hostApi.searchPlugin({
+    baseUrl: cfg.apiBaseUrl,
+    query,
+    searchContextRemId: searchContextRemId2,
+    limit: limitEffective,
+    timeoutMs: rpcTimeoutMs,
+    ensureDaemon: ensureDaemon5
+  }) : yield* gen2(function* () {
+    if (ensureDaemon5) {
+      yield* ensureWsSupervisor({ waitMs: WS_START_WAIT_DEFAULT_MS });
+    }
+    return yield* ws.search({
+      url: cfg.wsUrl,
+      timeoutMs: wsTimeoutMs,
+      queryText: query,
+      searchContextRemId: searchContextRemId2,
+      limit: limitEffective,
+      rpcTimeoutMs
+    });
+  });
+  const results = Array.isArray(result.results) ? result.results : [];
+  const mdLines = [`- ok: ${result.ok === true ? "true" : "false"}`, `- results: ${results.length}`];
+  for (const r of results) {
+    const remId = typeof r?.remId === "string" ? r.remId : "";
+    const title = typeof r?.title === "string" ? r.title : "";
+    const snippet = typeof r?.snippet === "string" ? r.snippet : "";
+    mdLines.push(`- ${title || remId}`);
+    if (remId)
+      mdLines.push(`  - id: ${remId}`);
+    if (snippet)
+      mdLines.push(`  - snippet: ${snippet}`);
+  }
+  yield* writeSuccess({ data: result, md: mdLines.join(`
+`) });
+}).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";
+var CONTENT_TYPES = new Map([
+  [".css", "text/css; charset=utf-8"],
+  [".html", "text/html; charset=utf-8"],
+  [".js", "application/javascript; charset=utf-8"],
+  [".json", "application/json; charset=utf-8"],
+  [".md", "text/markdown; charset=utf-8"],
+  [".txt", "text/plain; charset=utf-8"]
+]);
+function contentTypeFor(filePath) {
+  return CONTENT_TYPES.get(path28.extname(filePath).toLowerCase()) ?? "application/octet-stream";
+}
+function normalizeAssetPath(pathname) {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(pathname);
+  } catch {
+    return null;
+  }
+  const raw4 = decoded === "/" ? "index.html" : decoded.replace(/^\/+/, "");
+  const normalized = path28.posix.normalize(raw4);
+  if (!normalized || normalized === "." || normalized.startsWith("../") || normalized === "..")
+    return null;
+  return normalized;
+}
+async function readPluginStaticAsset(params3) {
+  const method = params3.method || "GET";
+  if (method !== "GET" && method !== "HEAD") {
+    return { ok: false, statusCode: 405, message: "Method not allowed" };
+  }
+  const relativePath = normalizeAssetPath(params3.pathname);
+  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}`)) {
+    return { ok: false, statusCode: 404, message: "Not found" };
+  }
+  try {
+    const stat3 = await fs21.stat(filePath);
+    if (!stat3.isFile()) {
+      return { ok: false, statusCode: 404, message: "Not found" };
+    }
+    const body = method === "HEAD" ? undefined : await fs21.readFile(filePath);
+    return {
+      ok: true,
+      statusCode: 200,
+      contentType: contentTypeFor(filePath),
+      contentLength: stat3.size,
+      body
+    };
+  } catch {
+    return { ok: false, statusCode: 404, message: "Not found" };
+  }
+}
+
+// src/runtime/plugin-static/runPluginStaticRuntime.ts
+function sendText(res, statusCode, message2) {
+  res.statusCode = statusCode;
+  res.setHeader("content-type", "text/plain; charset=utf-8");
+  res.end(message2);
+}
+function requestPathname(req) {
+  return new URL(req.url || "/", "http://127.0.0.1").pathname;
+}
+async function handleRequest(req, res, distPath) {
+  const result = await readPluginStaticAsset({
+    distPath,
+    pathname: requestPathname(req),
+    method: req.method || "GET"
+  });
+  if (!result.ok) {
+    sendText(res, result.statusCode, result.message);
+    return;
+  }
+  res.statusCode = result.statusCode;
+  res.setHeader("content-type", result.contentType);
+  res.setHeader("content-length", String(result.contentLength));
+  if (result.body === undefined)
+    res.end();
+  else
+    res.end(result.body);
+}
+function runPluginStaticRuntime(params3) {
+  return gen2(function* () {
+    const distPath = params3?.distPath ?? (yield* try_3({
+      try: () => resolvePluginDistPath(),
+      catch: (error4) => isCliError(error4) ? error4 : new CliError({
+        code: "DEPENDENCY_MISSING",
+        message: "Plugin build artifacts are unavailable",
+        exitCode: 1,
+        details: { error: String(error4?.message || error4) }
+      })
+    }));
+    const host7 = params3?.host ?? "127.0.0.1";
+    const port9 = params3?.port ?? 8080;
+    const server = createServer2((req, res) => {
+      handleRequest(req, res, distPath).catch(() => {
+        if (!res.headersSent) {
+          sendText(res, 500, "Internal server error");
+        }
+      });
+    });
+    const listen = async((resume2) => {
+      const onError4 = (error4) => {
+        cleanup();
+        resume2(fail8(new CliError({
+          code: "PLUGIN_UNAVAILABLE",
+          message: "Failed to start plugin static server",
+          exitCode: 1,
+          details: { host: host7, port: port9, error: String(error4?.message || error4) }
+        })));
+      };
+      const onListening = () => {
+        cleanup();
+        resume2(_void);
+      };
+      const cleanup = () => {
+        server.off("error", onError4);
+        server.off("listening", onListening);
+      };
+      server.once("error", onError4);
+      server.once("listening", onListening);
+      server.listen(port9, host7);
+      return sync3(cleanup);
+    });
+    yield* listen;
+    const actualPort = (() => {
+      const addr = server.address();
+      return addr && typeof addr === "object" ? addr.port : port9;
+    })();
+    if (params3?.onStarted) {
+      yield* params3.onStarted({ host: host7, port: actualPort, distPath });
+    }
+    const waitForStop = async((resume2) => {
+      let stopping = false;
+      const stop2 = () => {
+        if (stopping)
+          return;
+        stopping = true;
+        try {
+          server.close(() => resume2(_void));
+        } catch {
+          resume2(_void);
+        }
+      };
+      const onTerm = () => stop2();
+      const onInt = () => stop2();
+      process.on("SIGTERM", onTerm);
+      process.on("SIGINT", onInt);
+      return sync3(() => {
+        process.off("SIGTERM", onTerm);
+        process.off("SIGINT", onInt);
+        stop2();
+      });
+    });
+    yield* waitForStop;
+  });
+}
+
+// src/commands/plugin/serve.ts
+function optionToUndefined37(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var host7 = text9("host").pipe(optional5, map34(optionToUndefined37));
+var port9 = integer7("port").pipe(optional5, map34(optionToUndefined37));
+var stateFile20 = text9("state-file").pipe(optional5, map34(optionToUndefined37));
+var pluginServeCommand = exports_Command.make("serve", { host: host7, port: port9, stateFile: stateFile20 }, ({ host: host8, port: port10, stateFile: stateFile21 }) => gen2(function* () {
+  const cfg = yield* AppConfig;
+  const out = yield* Output;
+  const files = yield* PluginServerFiles;
+  const distPath = yield* try_3({
+    try: () => resolvePluginDistPath(),
+    catch: (error4) => isCliError(error4) ? error4 : new CliError({
+      code: "DEPENDENCY_MISSING",
+      message: "Plugin build artifacts are unavailable",
+      exitCode: 1,
+      details: { error: String(error4?.message || error4) }
+    })
+  });
+  const bindHost = host8 ?? "127.0.0.1";
+  const bindPort = port10 ?? 8080;
+  const stateFilePath = stateFile21 ? resolveUserFilePath(stateFile21) : undefined;
+  const runtime6 = runPluginStaticRuntime({
+    host: bindHost,
+    port: bindPort,
+    distPath,
+    onStarted: ({ host: host9, port: port11, distPath: distPath2 }) => gen2(function* () {
+      const baseUrl = pluginServerLocalBaseUrl(host9, port11);
+      if (stateFilePath) {
+        yield* files.writeStateFile(stateFilePath, {
+          running: true,
+          pid: process.pid,
+          host: host9,
+          port: port11,
+          startedAt: Date.now(),
+          localBaseUrl: baseUrl,
+          distPath: distPath2
+        });
+      }
+      if (cfg.format === "json" || cfg.quiet || cfg.format === "ids")
+        return;
+      yield* out.stdout(cfg.debug ? `
+  agent-remnote plugin ready
+
+  Local:   ${baseUrl}/
+  Dist:    ${distPath2}
+` : `
+  agent-remnote plugin ready
+
+  Local:   ${baseUrl}/
+`);
+    })
+  }).pipe(ensuring2(stateFilePath ? files.deleteStateFile(stateFilePath).pipe(catchAll2(() => _void)) : _void));
+  yield* runtime6;
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/start.ts
+function optionToUndefined38(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var host8 = text9("host").pipe(optional5, map34(optionToUndefined38));
+var port10 = integer7("port").pipe(optional5, map34(optionToUndefined38));
+var pidFile17 = text9("pid-file").pipe(optional5, map34(optionToUndefined38));
+var logFile10 = text9("log-file").pipe(optional5, map34(optionToUndefined38));
+var stateFile21 = text9("state-file").pipe(optional5, map34(optionToUndefined38));
+var pluginStartCommand = exports_Command.make("start", {
+  host: host8,
+  port: port10,
+  wait: integer7("wait").pipe(withDefault5(PLUGIN_SERVER_START_WAIT_DEFAULT_MS)),
+  pidFile: pidFile17,
+  logFile: logFile10,
+  stateFile: stateFile21
+}, ({ host: host9, port: port11, wait: wait3, pidFile: pidFile18, logFile: logFile11, stateFile: stateFile22 }) => gen2(function* () {
+  const result = yield* startPluginServer({ host: host9, port: port11, waitMs: wait3, pidFile: pidFile18, logFile: logFile11, stateFile: stateFile22 });
+  yield* writeSuccess({
+    data: result,
+    md: `- started: ${result.started}
+- pid: ${result.pid ?? ""}
+- pid_file: ${result.pid_file}
+- log_file: ${result.log_file}
+- state_file: ${result.state_file}
+- base_url: ${result.base_url}
+`
+  });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/status.ts
+function optionToUndefined39(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var pidFile18 = text9("pid-file").pipe(optional5, map34(optionToUndefined39));
+var stateFile22 = text9("state-file").pipe(optional5, map34(optionToUndefined39));
+function getPluginStatus(params3) {
+  return gen2(function* () {
+    const files = yield* PluginServerFiles;
+    const proc = yield* Process;
+    const pidInfo = yield* files.readPidFile(params3.pidFilePath);
+    const effectiveStateFilePath = resolveUserFilePath(params3.explicitStateFilePath ?? pidInfo?.state_file ?? files.defaultStateFile());
+    const state = yield* files.readStateFile(effectiveStateFilePath);
+    const pid = pidInfo?.pid;
+    const running4 = typeof pid === "number" ? yield* proc.isPidRunning(pid) : false;
+    const host9 = pidInfo?.host ?? state?.host ?? PLUGIN_SERVER_DEFAULT_HOST;
+    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);
+    return {
+      service: {
+        running: running4,
+        pid: pid ?? null,
+        pid_file: params3.pidFilePath,
+        log_file: pidInfo?.log_file ?? files.defaultLogFile(),
+        state_file: effectiveStateFilePath,
+        started_at: pidInfo?.started_at ?? state?.startedAt ?? null
+      },
+      state: state ?? null,
+      plugin_server: {
+        healthy: health._tag === "Right",
+        base_url: baseUrl,
+        host: host9,
+        port: port11,
+        dist_path: state?.distPath ?? "",
+        error: health._tag === "Left" ? health.left.message : undefined
+      }
+    };
+  });
+}
+var pluginStatusCommand = exports_Command.make("status", { pidFile: pidFile18, stateFile: stateFile22 }, ({ pidFile: pidFile19, stateFile: stateFile23 }) => gen2(function* () {
+  const files = yield* PluginServerFiles;
+  const pidFilePath = resolveUserFilePath(pidFile19 ?? files.defaultPidFile());
+  const data = yield* getPluginStatus({
+    pidFilePath,
+    explicitStateFilePath: stateFile23 ? resolveUserFilePath(stateFile23) : undefined
+  });
+  const md = [
+    `- service_running: ${data.service.running}`,
+    `- pid: ${data.service.pid ?? ""}`,
+    `- pid_file: ${data.service.pid_file}`,
+    `- log_file: ${data.service.log_file}`,
+    `- state_file: ${data.service.state_file}`,
+    `- started_at: ${data.service.started_at ?? ""}`,
+    `- plugin_server_healthy: ${data.plugin_server.healthy}`,
+    `- base_url: ${data.plugin_server.base_url}`,
+    `- host: ${data.plugin_server.host}`,
+    `- port: ${data.plugin_server.port}`,
+    `- dist_path: ${data.plugin_server.dist_path}`
+  ].join(`
+`);
+  yield* writeSuccess({ data, md });
+}).pipe(catchAll2(writeFailure)));
+
+// src/commands/plugin/stop.ts
+function optionToUndefined40(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
+var pidFile19 = text9("pid-file").pipe(optional5, map34(optionToUndefined40));
+var stateFile23 = text9("state-file").pipe(optional5, map34(optionToUndefined40));
+function isEsrch(error4) {
+  if (!(error4 instanceof CliError))
+    return false;
+  const code2 = error4.details?.code;
+  const message2 = String(error4.details?.error ?? error4.message ?? "");
+  return code2 === "ESRCH" || message2.includes("ESRCH");
+}
+function stopPluginServer(params3) {
+  return gen2(function* () {
+    const files = yield* PluginServerFiles;
+    const proc = yield* Process;
+    const existing = yield* files.readPidFile(params3.pidFilePath);
+    if (!existing) {
+      yield* files.deleteStateFile(params3.stateFilePath).pipe(catchAll2(() => _void));
+      return {
+        stopped: true,
+        pid_file: params3.pidFilePath
+      };
+    }
+    const cleanupStale = () => gen2(function* () {
+      yield* files.deletePidFile(params3.pidFilePath);
+      yield* files.deleteStateFile(existing.state_file ?? params3.stateFilePath).pipe(catchAll2(() => _void));
+      return {
+        stopped: true,
+        stale: true,
+        pid: existing.pid,
+        pid_file: params3.pidFilePath
+      };
+    });
+    const alive = yield* proc.isPidRunning(existing.pid);
+    if (!alive) {
+      return yield* cleanupStale();
+    }
+    const termResult = yield* proc.kill(existing.pid, "SIGTERM").pipe(either3);
+    if (termResult._tag === "Left") {
+      if (isEsrch(termResult.left)) {
+        return yield* cleanupStale();
+      }
+      return yield* fail8(termResult.left);
+    }
+    const exited = yield* proc.waitForExit({ pid: existing.pid, timeoutMs: PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS });
+    if (!exited) {
+      if (!params3.force) {
+        return yield* fail8(new CliError({
+          code: "INTERNAL",
+          message: `Plugin server did not exit within ${PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS}ms; use --force`,
+          exitCode: 1,
+          details: { pid: existing.pid, pid_file: params3.pidFilePath }
+        }));
+      }
+      yield* proc.kill(existing.pid, "SIGKILL");
+      const killed = yield* proc.waitForExit({ pid: existing.pid, timeoutMs: PLUGIN_SERVER_STOP_WAIT_DEFAULT_MS });
+      if (!killed) {
+        return yield* fail8(new CliError({
+          code: "INTERNAL",
+          message: "Force stop failed (process is still alive)",
+          exitCode: 1,
+          details: { pid: existing.pid, pid_file: params3.pidFilePath }
+        }));
+      }
+    }
+    yield* files.deletePidFile(params3.pidFilePath);
+    yield* files.deleteStateFile(existing.state_file ?? params3.stateFilePath).pipe(catchAll2(() => _void));
+    return {
+      stopped: true,
+      pid: existing.pid,
+      pid_file: params3.pidFilePath
+    };
+  });
+}
+var pluginStopCommand = exports_Command.make("stop", { force: boolean8("force"), pidFile: pidFile19, stateFile: stateFile23 }, ({ force, pidFile: pidFile20, stateFile: stateFile24 }) => gen2(function* () {
+  const files = yield* PluginServerFiles;
+  const pidFilePath = resolveUserFilePath(pidFile20 ?? files.defaultPidFile());
+  const stateFilePath = resolveUserFilePath(stateFile24 ?? files.defaultStateFile());
+  const result = yield* stopPluginServer({ force, pidFilePath, stateFilePath });
+  yield* writeSuccess({
+    data: result,
+    md: result.stale === true ? `- stopped: true
+- stale: true
+- pid: ${result.pid ?? ""}
+- pid_file: ${pidFilePath}
+` : result.pid ? `- stopped: true
+- pid: ${result.pid}
+- pid_file: ${pidFilePath}
+` : `- stopped: true
+- pid_file: ${pidFilePath}
+`
   });
-  const results = Array.isArray(result.results) ? result.results : [];
-  const mdLines = [`- ok: ${result.ok === true ? "true" : "false"}`, `- results: ${results.length}`];
-  for (const r of results) {
-    const remId = typeof r?.remId === "string" ? r.remId : "";
-    const title = typeof r?.title === "string" ? r.title : "";
-    const snippet = typeof r?.snippet === "string" ? r.snippet : "";
-    mdLines.push(`- ${title || remId}`);
-    if (remId)
-      mdLines.push(`  - id: ${remId}`);
-    if (snippet)
-      mdLines.push(`  - snippet: ${snippet}`);
-  }
-  yield* writeSuccess({ data: result, md: mdLines.join(`
-`) });
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/plugin/index.ts
-var pluginCommand = exports_Command.make("plugin", {}).pipe(exports_Command.withSubcommands([pluginCurrentCommand, pluginSearchCommand, readUiContextCommand, readSelectionCommand]));
+var pluginCommand = exports_Command.make("plugin", {}).pipe(exports_Command.withSubcommands([
+  pluginCurrentCommand,
+  pluginSearchCommand,
+  pluginServeCommand,
+  pluginStartCommand,
+  pluginStopCommand,
+  pluginRestartCommand,
+  pluginEnsureCommand,
+  pluginStatusCommand,
+  pluginLogsCommand,
+  readUiContextCommand,
+  readSelectionCommand
+]));
 
 // src/commands/read/powerup/list.ts
-function optionToUndefined32(opt) {
+function optionToUndefined41(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var query = text9("query").pipe(optional5, map34(optionToUndefined32));
+var query = text9("query").pipe(optional5, map34(optionToUndefined41));
 var limit3 = integer7("limit").pipe(withDefault5(50));
 var offset = integer7("offset").pipe(withDefault5(0));
 function safeJsonParse3(input) {
@@ -98761,11 +100319,11 @@ var readPowerupResolveCommand = exports_Command.make("resolve", { powerup: text9
 })), catchAll2(writeFailure)));
 
 // src/commands/read/powerup/schema.ts
-function optionToUndefined33(opt) {
+function optionToUndefined42(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var powerup = text9("powerup").pipe(optional5, map34(optionToUndefined33));
-var id2 = text9("id").pipe(optional5, map34(optionToUndefined33));
+var powerup = text9("powerup").pipe(optional5, map34(optionToUndefined42));
+var id2 = text9("id").pipe(optional5, map34(optionToUndefined42));
 var limit4 = integer7("limit").pipe(withDefault5(50));
 var offset2 = integer7("offset").pipe(withDefault5(0));
 var readPowerupSchemaCommand = exports_Command.make("schema", { powerup, id: id2, includeOptions: boolean8("include-options"), limit: limit4, offset: offset2 }, ({ powerup: powerup2, id: id3, includeOptions, limit: limit5, offset: offset3 }) => gen2(function* () {
@@ -99046,33 +100604,33 @@ function compileTableValueOps(params3) {
 }
 
 // src/commands/write/_shared.ts
-function optionToUndefined34(opt) {
+function optionToUndefined43(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 function readOptionalText3(name) {
-  return text9(name).pipe(optional5, map34(optionToUndefined34));
+  return text9(name).pipe(optional5, map34(optionToUndefined43));
 }
 var writeCommonOptions = {
   notify: boolean8("no-notify").pipe(map34((v) => !v)),
   ensureDaemon: boolean8("no-ensure-daemon").pipe(map34((v) => !v)),
   wait: boolean8("wait"),
-  timeoutMs: integer7("timeout-ms").pipe(optional5, map34(optionToUndefined34)),
-  pollMs: integer7("poll-ms").pipe(optional5, map34(optionToUndefined34)),
+  timeoutMs: integer7("timeout-ms").pipe(optional5, map34(optionToUndefined43)),
+  pollMs: integer7("poll-ms").pipe(optional5, map34(optionToUndefined43)),
   dryRun: boolean8("dry-run"),
-  priority: integer7("priority").pipe(optional5, map34(optionToUndefined34)),
+  priority: integer7("priority").pipe(optional5, map34(optionToUndefined43)),
   clientId: readOptionalText3("client-id"),
   idempotencyKey: readOptionalText3("idempotency-key"),
   meta: readOptionalText3("meta")
 };
 
 // src/commands/write/powerup/apply.ts
-var dispatchMode = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var dispatchMode = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 var writePowerupApplyCommand = exports_Command.make("apply", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
+  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   ensureTag: boolean8("no-ensure-tag").pipe(map34((v) => !v)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -99535,11 +101093,11 @@ var writePowerupOptionCommand = exports_Command.make("option", {}).pipe(exports_
 
 // src/commands/write/powerup/property/add.ts
 var writePowerupPropertyAddCommand = exports_Command.make("add", {
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
   name: text9("name"),
-  type: text9("type").pipe(optional5, map34(optionToUndefined34)),
-  options: text9("options").pipe(optional5, map34(optionToUndefined34)),
+  type: text9("type").pipe(optional5, map34(optionToUndefined43)),
+  options: text9("options").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -99703,14 +101261,14 @@ var writePowerupPropertySetTypeCommand = exports_Command.make("set-type", {
 var writePowerupPropertyCommand = exports_Command.make("property", {}).pipe(exports_Command.withSubcommands([writePowerupPropertyAddCommand, writePowerupPropertySetTypeCommand]));
 
 // src/commands/write/powerup/record/add.ts
-var dispatchMode2 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var dispatchMode2 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 var writePowerupRecordAddCommand = exports_Command.make("add", {
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined34)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined34)),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
+  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
+  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
+  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   extraTag: text9("extra-tag").pipe(repeated5),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -99928,8 +101486,8 @@ function rowHasTag(doc, tagId) {
   return Object.prototype.hasOwnProperty.call(tp, tagId);
 }
 var writePowerupRecordDeleteCommand = exports_Command.make("delete", {
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
   rem: text9("rem"),
   validateMembership: boolean8("no-validate-membership").pipe(map34((v) => !v)),
   notify: writeCommonOptions.notify,
@@ -100078,7 +101636,7 @@ var writePowerupRecordDeleteCommand = exports_Command.make("delete", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/write/powerup/record/update.ts
-var dispatchMode3 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var dispatchMode3 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 function rowHasTag2(doc, tagId) {
   const tp = doc?.tp;
   if (!tp || typeof tp !== "object" || Array.isArray(tp))
@@ -100086,11 +101644,11 @@ function rowHasTag2(doc, tagId) {
   return Object.prototype.hasOwnProperty.call(tp, tagId);
 }
 var writePowerupRecordUpdateCommand = exports_Command.make("update", {
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
   rem: text9("rem"),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   validateMembership: boolean8("no-validate-membership").pipe(map34((v) => !v)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
@@ -100311,9 +101869,9 @@ var writePowerupRecordCommand = exports_Command.make("record", {}).pipe(exports_
 // src/commands/write/powerup/remove.ts
 var writePowerupRemoveCommand = exports_Command.make("remove", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined34)),
-  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  powerup: text9("powerup").pipe(optional5, map34(optionToUndefined43)),
+  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -100448,7 +102006,7 @@ var powerupCommand = exports_Command.make("powerup", {}).pipe(exports_Command.wi
 ]));
 
 // src/commands/read/query.ts
-function optionToUndefined35(opt) {
+function optionToUndefined44(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 function buildMarkdown3(items, total) {
@@ -100463,14 +102021,14 @@ function buildMarkdown3(items, total) {
   return lines3.join(`
 `);
 }
-var payload = text9("payload").pipe(optional5, map34(optionToUndefined35));
-var text15 = text9("text").pipe(optional5, map34(optionToUndefined35));
+var payload = text9("payload").pipe(optional5, map34(optionToUndefined44));
+var text15 = text9("text").pipe(optional5, map34(optionToUndefined44));
 var tag7 = text9("tag").pipe(repeated5);
 var limit5 = integer7("limit").pipe(withDefault5(20));
 var offset3 = integer7("offset").pipe(withDefault5(0));
 var snippetLength = integer7("snippet-length").pipe(withDefault5(200));
-var sort2 = choice5("sort", ["rank", "updatedAt", "createdAt"]).pipe(optional5, map34(optionToUndefined35));
-var sortDirection = choice5("sort-direction", ["asc", "desc"]).pipe(optional5, map34(optionToUndefined35));
+var sort2 = choice5("sort", ["rank", "updatedAt", "createdAt"]).pipe(optional5, map34(optionToUndefined44));
+var sortDirection = choice5("sort-direction", ["asc", "desc"]).pipe(optional5, map34(optionToUndefined44));
 var readQueryCommand = exports_Command.make("query", { payload, text: text15, tag: tag7, limit: limit5, offset: offset3, snippetLength, sort: sort2, sortDirection }, ({ payload: payload2, text: text16, tag: tag8, limit: limit6, offset: offset4, snippetLength: snippetLength2, sort: sort3, sortDirection: sortDirection2 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   yield* failInRemoteMode({
@@ -100593,11 +102151,11 @@ var queueConflictsCommand = exports_Command.make("conflicts", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/queue/inspect.ts
-function optionToUndefined36(opt) {
+function optionToUndefined45(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var txn = text9("txn").pipe(optional5, map34(optionToUndefined36));
-var op = text9("op").pipe(optional5, map34(optionToUndefined36));
+var txn = text9("txn").pipe(optional5, map34(optionToUndefined45));
+var op = text9("op").pipe(optional5, map34(optionToUndefined45));
 var queueInspectCommand = exports_Command.make("inspect", { txn, op }, ({ txn: txn2, op: op2 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const queue = yield* Queue;
@@ -100723,13 +102281,13 @@ var queueStatsCommand = exports_Command.make("stats", { includeConflicts: boolea
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/queue/wait.ts
-function optionToUndefined37(opt) {
+function optionToUndefined46(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 var queueWaitCommand = exports_Command.make("wait", {
   txn: text9("txn"),
-  timeoutMs: integer7("timeout-ms").pipe(optional5, map34(optionToUndefined37)),
-  pollMs: integer7("poll-ms").pipe(optional5, map34(optionToUndefined37))
+  timeoutMs: integer7("timeout-ms").pipe(optional5, map34(optionToUndefined46)),
+  pollMs: integer7("poll-ms").pipe(optional5, map34(optionToUndefined46))
 }, ({ txn: txn2, timeoutMs: timeoutMs4, pollMs: pollMs3 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const hostApi = yield* HostApiClient;
@@ -100762,12 +102320,12 @@ var queueCommand = exports_Command.make("queue", {}).pipe(exports_Command.withSu
 ]));
 
 // src/commands/read/by-reference.ts
-function optionToUndefined38(opt) {
+function optionToUndefined47(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 var reference = text9("reference").pipe(repeated5);
-var timeRange = text9("time").pipe(optional5, map34(optionToUndefined38));
-var maxDepth2 = integer7("max-depth").pipe(optional5, map34(optionToUndefined38));
+var timeRange = text9("time").pipe(optional5, map34(optionToUndefined47));
+var maxDepth2 = integer7("max-depth").pipe(optional5, map34(optionToUndefined47));
 var limit6 = integer7("limit").pipe(withDefault5(40));
 var offset4 = integer7("offset").pipe(withDefault5(0));
 var readByReferenceCommand = exports_Command.make("by-reference", { reference, timeRange, maxDepth: maxDepth2, limit: limit6, offset: offset4 }, ({ reference: reference2, timeRange: timeRange2, maxDepth: maxDepth3, limit: limit7, offset: offset5 }) => gen2(function* () {
@@ -100808,10 +102366,10 @@ var readConnectionsCommand = exports_Command.make("connections", { id: text9("id
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/inspect.ts
-function optionToUndefined39(opt) {
+function optionToUndefined48(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var maxReferenceDepth = integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined39));
+var maxReferenceDepth = integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined48));
 var readInspectCommand = exports_Command.make("inspect", {
   id: text9("id"),
   expandReferences: boolean8("expand-references"),
@@ -100843,15 +102401,15 @@ var readInspectCommand = exports_Command.make("inspect", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/outline.ts
-function optionToUndefined40(opt) {
+function optionToUndefined49(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var depth = integer7("depth").pipe(optional5, map34(optionToUndefined40));
-var offset5 = integer7("offset").pipe(optional5, map34(optionToUndefined40));
-var nodes = integer7("nodes").pipe(optional5, map34(optionToUndefined40));
-var format9 = choice5("format", ["md", "json"]).pipe(optional5, map34(optionToUndefined40));
-var id3 = text9("id").pipe(optional5, map34(optionToUndefined40));
-var ref = text9("ref").pipe(optional5, map34(optionToUndefined40));
+var depth = integer7("depth").pipe(optional5, map34(optionToUndefined49));
+var offset5 = integer7("offset").pipe(optional5, map34(optionToUndefined49));
+var nodes = integer7("nodes").pipe(optional5, map34(optionToUndefined49));
+var format9 = choice5("format", ["md", "json"]).pipe(optional5, map34(optionToUndefined49));
+var id3 = text9("id").pipe(optional5, map34(optionToUndefined49));
+var ref = text9("ref").pipe(optional5, map34(optionToUndefined49));
 var readOutlineCommand = exports_Command.make("outline", {
   id: id3,
   ref,
@@ -100862,7 +102420,7 @@ var readOutlineCommand = exports_Command.make("outline", {
   excludeProperties: boolean8("exclude-properties"),
   includeEmpty: boolean8("include-empty"),
   expandReferences: boolean8("expand-references"),
-  maxReferenceDepth: integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined40)),
+  maxReferenceDepth: integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined49)),
   detail: boolean8("detail")
 }, ({
   id: id4,
@@ -100922,12 +102480,12 @@ var readOutlineCommand = exports_Command.make("outline", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/page-id.ts
-function optionToUndefined41(opt) {
+function optionToUndefined50(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var ref2 = text9("ref").pipe(optional5, map34(optionToUndefined41));
+var ref2 = text9("ref").pipe(optional5, map34(optionToUndefined50));
 var id4 = text9("id").pipe(repeated5);
-var maxHops = integer7("max-hops").pipe(optional5, map34(optionToUndefined41));
+var maxHops = integer7("max-hops").pipe(optional5, map34(optionToUndefined50));
 var readPageIdCommand = exports_Command.make("page-id", { ref: ref2, id: id4, maxHops, detail: boolean8("detail") }, ({ ref: ref3, id: id5, maxHops: maxHops2, detail }) => gen2(function* () {
   const cfg = yield* AppConfig;
   yield* failInRemoteMode({
@@ -100980,11 +102538,11 @@ var readPageIdCommand = exports_Command.make("page-id", { ref: ref2, id: id4, ma
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/references.ts
-function optionToUndefined42(opt) {
+function optionToUndefined51(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var maxDepth3 = integer7("max-depth").pipe(optional5, map34(optionToUndefined42));
-var inboundMaxDepth = integer7("inbound-max-depth").pipe(optional5, map34(optionToUndefined42));
+var maxDepth3 = integer7("max-depth").pipe(optional5, map34(optionToUndefined51));
+var inboundMaxDepth = integer7("inbound-max-depth").pipe(optional5, map34(optionToUndefined51));
 var readReferencesCommand = exports_Command.make("references", {
   id: text9("id"),
   includeDescendants: boolean8("include-descendants"),
@@ -101020,10 +102578,10 @@ var readReferencesCommand = exports_Command.make("references", {
 
 // src/commands/read/resolve-ref.ts
 var ids3 = text9("ids").pipe(repeated5);
-function optionToUndefined43(opt) {
+function optionToUndefined52(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var maxReferenceDepth2 = integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined43));
+var maxReferenceDepth2 = integer7("max-reference-depth").pipe(optional5, map34(optionToUndefined52));
 var readResolveRefCommand = exports_Command.make("resolve-ref", {
   ids: ids3,
   expandReferences: boolean8("expand-references"),
@@ -101058,13 +102616,13 @@ function normalizeRemIdInput2(raw4) {
 }
 var tag8 = text9("tag").pipe(repeated5);
 var writeRemCreateCommand = exports_Command.make("create", {
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined34)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined34)),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
+  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(optionToUndefined34)),
-  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined34)),
+  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,
@@ -101140,7 +102698,7 @@ var writeRemCreateCommand = exports_Command.make("create", {
   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 && looksLikeStructuredMarkdown(textValue)) {
+  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.",
@@ -101247,16 +102805,17 @@ function buildActionEnvelope(params3) {
   return gen2(function* () {
     const payloadSvc = yield* Payload;
     const metaValue = params3.metaSpec ? yield* payloadSvc.readJson(params3.metaSpec) : undefined;
+    const input = params3.input ?? {
+      rem_id: params3.remId,
+      ...params3.markdown !== undefined ? { markdown: params3.markdown } : {}
+    };
     return {
       version: 1,
       kind: "actions",
       actions: [
         {
           action: params3.action,
-          input: {
-            rem_id: params3.remId,
-            ...params3.markdown !== undefined ? { markdown: params3.markdown } : {}
-          }
+          input
         }
       ],
       ...params3.priority !== undefined ? { priority: params3.priority } : {},
@@ -101268,6 +102827,30 @@ function buildActionEnvelope(params3) {
     };
   });
 }
+function resolveCurrentSelectionRemId(params3) {
+  return gen2(function* () {
+    const cfg = yield* AppConfig;
+    const hostApi = yield* HostApiClient;
+    const data = cfg.apiBaseUrl ? yield* hostApi.selectionCurrent({ baseUrl: cfg.apiBaseUrl, stateFile: params3.stateFile, staleMs: params3.staleMs }) : yield* collectSelectionCurrentUseCase({ stateFile: params3.stateFile, staleMs: params3.staleMs });
+    const totalCountRaw = Number(data?.total_count ?? 0);
+    const totalCount = Number.isFinite(totalCountRaw) && totalCountRaw >= 0 ? Math.floor(totalCountRaw) : 0;
+    const truncated = data?.truncated === true;
+    const currentId = typeof data?.current?.id === "string" ? data.current.id.trim() : Array.isArray(data?.ids) ? String(data.ids[0] ?? "").trim() : "";
+    if (truncated || totalCount !== 1 || !currentId) {
+      return yield* fail8(new CliError({
+        code: "INVALID_ARGS",
+        message: "Current selection must resolve to exactly one selected Rem",
+        exitCode: 2,
+        details: { total_count: totalCount, truncated, current_id: currentId || null, selection: data }
+      }));
+    }
+    return {
+      source: "selection",
+      rem_id: currentId,
+      selection: data
+    };
+  });
+}
 function readMarkdownArg(inputSpec) {
   return gen2(function* () {
     const raw4 = yield* readMarkdownTextFromInputSpec(inputSpec);
@@ -101320,6 +102903,39 @@ function submitActionEnvelope(params3) {
     });
   });
 }
+function loadTxnDetail(params3) {
+  return gen2(function* () {
+    const cfg = yield* AppConfig;
+    const hostApi = yield* HostApiClient;
+    const queue = yield* Queue;
+    return cfg.apiBaseUrl ? yield* hostApi.queueTxn({ baseUrl: cfg.apiBaseUrl, txnId: params3.txnId }) : yield* queue.inspect({ dbPath: cfg.storeDb, txnId: params3.txnId });
+  });
+}
+function parseResultJson(raw4) {
+  const resultJson = raw4?.result_json;
+  if (typeof resultJson === "string" && resultJson.trim()) {
+    try {
+      return JSON.parse(resultJson);
+    } catch {}
+  }
+  return null;
+}
+function extractReplaceBackupSummary(txnDetail) {
+  const ops = Array.isArray(txnDetail?.ops) ? txnDetail.ops : [];
+  const replaceOp = ops.find((op2) => ["replace_children_with_markdown", "replace_selection_with_markdown"].includes(String(op2?.type ?? "").trim()));
+  if (!replaceOp)
+    return;
+  const result = parseResultJson(replaceOp.result);
+  if (!result || typeof result !== "object")
+    return;
+  return {
+    policy: typeof result.backup_policy === "string" && result.backup_policy.trim() ? result.backup_policy.trim() : "none",
+    deleted: result.backup_deleted !== false,
+    rem_id: typeof result.backup_rem_id === "string" && result.backup_rem_id.trim() ? result.backup_rem_id.trim() : null,
+    ...result.backup_hidden === true ? { hidden: true } : {},
+    ...typeof result.backup_cleanup_state === "string" && result.backup_cleanup_state.trim() ? { cleanup_state: result.backup_cleanup_state.trim() } : {}
+  };
+}
 
 // src/commands/write/rem/children/append.ts
 var writeRemChildrenAppendCommand = exports_Command.make("append", {
@@ -101484,9 +103100,17 @@ var writeRemChildrenPrependCommand = exports_Command.make("prepend", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/write/rem/children/replace.ts
+function optionToUndefined53(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
 var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
-  rem: text9("rem"),
+  rem: text9("rem").pipe(optional5, map34(optionToUndefined53)),
+  selection: boolean8("selection"),
+  stateFile: text9("state-file").pipe(optional5, map34(optionToUndefined53)),
+  staleMs: integer7("stale-ms").pipe(optional5, map34(optionToUndefined53)),
   markdown: text9("markdown"),
+  backup: choice5("backup", ["none", "visible"]).pipe(withDefault5("none")),
+  assert: choice5("assert", ["single-root", "preserve-anchor", "no-literal-bullet"]).pipe(repeated5),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -101497,14 +103121,50 @@ var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
   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* () {
+}, ({
+  rem,
+  selection,
+  stateFile: stateFile24,
+  staleMs: staleMs11,
+  markdown: markdown2,
+  backup,
+  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 remId = normalizeRemIdInput3(rem);
+  const hasRem = typeof rem === "string" && rem.trim().length > 0;
+  const targetCount = Number(hasRem) + Number(selection === true);
+  if (targetCount !== 1) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "Provide exactly one target via --rem or --selection",
+      exitCode: 2
+    }));
+  }
+  const target2 = selection ? yield* resolveCurrentSelectionRemId({ stateFile: stateFile24, staleMs: staleMs11 }) : {
+    source: "rem",
+    rem_id: normalizeRemIdInput3(String(rem))
+  };
+  const remId = target2.rem_id;
   const markdownValue = yield* readMarkdownArg(markdown2);
   const body = yield* buildActionEnvelope({
     action: "rem.children.replace",
     remId,
-    markdown: markdownValue,
+    input: {
+      rem_id: remId,
+      markdown: markdownValue,
+      backup,
+      ...assert2.length > 0 ? { assertions: assert2 } : {}
+    },
     priority: priority3,
     clientId: clientId3,
     idempotencyKey: idempotencyKey3,
@@ -101515,24 +103175,32 @@ var writeRemChildrenReplaceCommand = exports_Command.make("replace", {
   if (dryRun) {
     const compiled = yield* dryRunEnvelope(body);
     yield* writeSuccess({
-      data: { dry_run: true, ...compiled },
+      data: { dry_run: true, target: { source: target2.source, rem_id: remId }, ...compiled },
       md: `- dry_run: true
 - action: rem.children.replace
 - rem_id: ${remId}
+- target: ${target2.source}
 `
     });
     return;
   }
   const data = yield* submitActionEnvelope({ body, wait: wait3, timeoutMs: timeoutMs4, pollMs: pollMs3 });
+  const backupSummary = wait3 && data.status === "succeeded" && typeof data.txn_id === "string" ? extractReplaceBackupSummary(yield* loadTxnDetail({ txnId: data.txn_id })) : undefined;
   yield* writeSuccess({
-    data,
+    data: backupSummary ? { ...data, backup: backupSummary } : 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 ?? ""}`] : []
+      ...data.status ? [`- status: ${data.status}`, `- elapsed_ms: ${data.elapsed_ms ?? ""}`] : [],
+      ...backupSummary ? [
+        `- backup_policy: ${backupSummary.policy}`,
+        `- backup_deleted: ${backupSummary.deleted ? "true" : "false"}`,
+        ...backupSummary.hidden ? ["- backup_hidden: true"] : [],
+        ...backupSummary.cleanup_state ? [`- backup_cleanup_state: ${backupSummary.cleanup_state}`] : []
+      ] : []
     ].join(`
 `)
   });
@@ -101547,8 +103215,12 @@ var writeRemChildrenCommand = exports_Command.make("children", {}).pipe(exports_
 ]));
 
 // src/commands/write/rem/delete.ts
+function optionToUndefined54(opt) {
+  return isSome2(opt) ? opt.value : undefined;
+}
 var writeRemDeleteCommand = exports_Command.make("delete", {
   rem: text9("rem"),
+  maxDeleteSubtreeNodes: integer7("max-delete-subtree-nodes").pipe(optional5, map34(optionToUndefined54)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -101559,7 +103231,27 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
   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* () {
+}, ({
+  rem,
+  maxDeleteSubtreeNodes,
+  notify: notify3,
+  ensureDaemon: ensureDaemon5,
+  wait: wait3,
+  timeoutMs: timeoutMs4,
+  pollMs: pollMs3,
+  dryRun,
+  priority: priority3,
+  clientId: clientId3,
+  idempotencyKey: idempotencyKey3,
+  meta
+}) => gen2(function* () {
+  if (maxDeleteSubtreeNodes !== undefined && maxDeleteSubtreeNodes <= 0) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "--max-delete-subtree-nodes must be a positive integer",
+      exitCode: 2
+    }));
+  }
   if (!wait3 && (timeoutMs4 !== undefined || pollMs3 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -101576,7 +103268,13 @@ var writeRemDeleteCommand = exports_Command.make("delete", {
   }
   const payloadSvc = yield* Payload;
   const op2 = yield* try_3({
-    try: () => normalizeOp({ type: "delete_rem", payload: { remId: rem } }, payloadSvc.normalizeKeys),
+    try: () => normalizeOp({
+      type: "delete_rem",
+      payload: {
+        remId: rem,
+        ...maxDeleteSubtreeNodes !== undefined ? { maxDeleteSubtreeNodes } : {}
+      }
+    }, payloadSvc.normalizeKeys),
     catch: (e) => isCliError(e) ? e : new CliError({
       code: "INVALID_PAYLOAD",
       message: "Failed to generate op",
@@ -101630,9 +103328,9 @@ function normalizeRemIdInput4(raw4) {
 }
 var writeRemMoveCommand = exports_Command.make("move", {
   rem: text9("rem"),
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined34)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined34)),
-  position: integer7("position").pipe(optional5, map34(optionToUndefined34)),
+  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
+  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
+  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -101835,7 +103533,7 @@ var writeTagAddCommand = exports_Command.make("add", {
 var writeTagRemoveCommand = exports_Command.make("remove", {
   rem: text9("rem"),
   tag: text9("tag"),
-  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined34)),
+  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -101939,85 +103637,85 @@ function normalizeRemIdInput6(raw4) {
     return link3.remId;
   return trimmed2;
 }
-function makeWriteRemTextCommand(name) {
-  return exports_Command.make(name, {
-    rem: text9("rem"),
-    text: text9("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
-  }, ({ rem, 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",
-        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
-      }));
-    }
-    const payloadSvc = yield* Payload;
-    const remId = normalizeRemIdInput6(rem);
-    const textValue = trimBoundaryBlankLines(text16);
-    const op2 = yield* try_3({
-      try: () => normalizeOp({ type: "update_text", payload: { remId, text: textValue } }, 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
+var writeRemSetTextCommand = exports_Command.make("set-text", {
+  rem: text9("rem"),
+  text: text9("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
+}, ({ rem, 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",
+      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
+    }));
+  }
+  yield* failInRemoteMode({
+    command: "rem 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 textValue = trimBoundaryBlankLines(text16);
+  const op2 = yield* try_3({
+    try: () => normalizeOp({ type: "update_text", payload: { remId, text: textValue } }, 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: update_text
 - rem_id: ${remId}
 `
-      });
-      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(`
+    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 writeRemSetTextCommand = makeWriteRemTextCommand("set-text");
-var writeRemTextCommand = makeWriteRemTextCommand("text");
+  });
+}).pipe(catchAll2(writeFailure)));
 
 // src/commands/rem/index.ts
 var remCommand = exports_Command.make("rem", {}).pipe(exports_Command.withSubcommands([
@@ -102025,7 +103723,6 @@ var remCommand = exports_Command.make("rem", {}).pipe(exports_Command.withSubcom
   writeRemCreateCommand,
   writeRemMoveCommand,
   writeRemSetTextCommand,
-  writeRemTextCommand,
   writeRemTagCommand,
   writeRemDeleteCommand,
   readInspectCommand,
@@ -102043,7 +103740,7 @@ function resolveReplaceTarget(params3) {
     const _cfg = yield* AppConfig;
     yield* failInRemoteMode({
       command: "replace target resolution",
-      reason: "replace commands still depend on local selection/ref resolution semantics"
+      reason: "replace markdown is an advanced/local-only block replace path that still depends on local selection/ref resolution semantics"
     });
     const refs = yield* RefResolver;
     const hasSelection = params3.selection === true;
@@ -102155,18 +103852,18 @@ function expandTargetIds(params3) {
 }
 
 // src/commands/write/replace/block.ts
-function optionToUndefined44(opt) {
+function optionToUndefined55(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 function readOptionalText4(name) {
-  return text9(name).pipe(optional5, map34(optionToUndefined44));
+  return text9(name).pipe(optional5, map34(optionToUndefined55));
 }
 var selection = boolean8("selection");
-var stateFile18 = readOptionalText4("state-file");
-var staleMs11 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined44));
+var stateFile24 = readOptionalText4("state-file");
+var staleMs11 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined55));
 var ref3 = readOptionalText4("ref");
 var ids4 = text9("id").pipe(repeated5);
-var scope5 = choice5("scope", ["roots", "subtree"]).pipe(optional5, map34(optionToUndefined44));
+var scope5 = choice5("scope", ["roots", "subtree"]).pipe(optional5, map34(optionToUndefined55));
 var requireComplete = boolean8("require-complete");
 var maxDepth4 = integer7("max-depth").pipe(withDefault5(10));
 var maxNodes2 = integer7("max-nodes").pipe(withDefault5(1000));
@@ -102174,19 +103871,19 @@ var allowDiscontiguous = boolean8("allow-discontiguous");
 var useCurrentSelection = boolean8("use-current-selection");
 var portalId = readOptionalText4("portal-id");
 var markdownInline = readOptionalText4("markdown");
-var file8 = readOptionalText4("file");
+var file9 = readOptionalText4("file");
 var clientId3 = readOptionalText4("client-id");
 var idempotencyKey3 = readOptionalText4("idempotency-key");
 var metaSpec3 = readOptionalText4("meta");
-var priority3 = integer7("priority").pipe(optional5, map34(optionToUndefined44));
+var priority3 = integer7("priority").pipe(optional5, map34(optionToUndefined55));
 var notify3 = boolean8("no-notify").pipe(map34((v) => !v));
 var ensureDaemon5 = boolean8("no-ensure-daemon").pipe(map34((v) => !v));
 var wait3 = boolean8("wait");
-var timeoutMs4 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined44));
-var pollMs3 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined44));
+var timeoutMs4 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined55));
+var pollMs3 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined55));
 var replaceMarkdownCommand = exports_Command.make("markdown", {
   selection,
-  stateFile: stateFile18,
+  stateFile: stateFile24,
   staleMs: staleMs11,
   ref: ref3,
   id: ids4,
@@ -102197,7 +103894,7 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   allowDiscontiguous,
   useCurrentSelection,
   portalId,
-  file: file8,
+  file: file9,
   markdown: markdownInline,
   notify: notify3,
   ensureDaemon: ensureDaemon5,
@@ -102211,7 +103908,7 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   meta: metaSpec3
 }, ({
   selection: selection2,
-  stateFile: stateFile19,
+  stateFile: stateFile25,
   staleMs: staleMs12,
   ref: ref4,
   id: id5,
@@ -102222,7 +103919,7 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   allowDiscontiguous: allowDiscontiguous2,
   useCurrentSelection: useCurrentSelection2,
   portalId: portalId2,
-  file: file9,
+  file: file10,
   markdown: markdown2,
   notify: notify4,
   ensureDaemon: ensureDaemon6,
@@ -102235,6 +103932,10 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   idempotencyKey: idempotencyKey4,
   meta
 }) => gen2(function* () {
+  yield* failInRemoteMode({
+    command: "replace markdown",
+    reason: "replace markdown is an advanced/local-only block replace command that still depends on local selection/ref resolution semantics"
+  });
   if (!wait4 && (timeoutMs5 !== undefined || pollMs4 !== undefined)) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -102251,18 +103952,18 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   }
   const fileInput = yield* FileInput;
   const payloadSvc = yield* Payload;
-  const resolvedTarget = yield* resolveReplaceTarget({ selection: selection2, stateFile: stateFile19, staleMs: staleMs12, ref: ref4, ids: id5 });
-  if (file9 && markdown2) {
+  const resolvedTarget = yield* resolveReplaceTarget({ selection: selection2, stateFile: stateFile25, staleMs: staleMs12, ref: ref4, ids: id5 });
+  if (file10 && markdown2) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
       message: "Choose only one of --file or --markdown",
       exitCode: 2
     }));
   }
-  if (!file9 && !markdown2) {
+  if (!file10 && !markdown2) {
     return yield* fail8(new CliError({ code: "INVALID_ARGS", message: "You must provide --file or --markdown", exitCode: 2 }));
   }
-  const mdRaw = typeof markdown2 === "string" ? markdown2 : yield* fileInput.readTextFromFileSpec({ spec: String(file9) });
+  const mdRaw = typeof markdown2 === "string" ? markdown2 : yield* fileInput.readTextFromFileSpec({ spec: String(file10) });
   const md = trimBoundaryBlankLines(mdRaw);
   const scopeValue = scope6 ?? "roots";
   if (scopeValue !== "roots") {
@@ -102338,33 +104039,40 @@ var replaceMarkdownCommand = exports_Command.make("markdown", {
   });
   const waited = wait4 ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs5, pollMs: pollMs4 }) : null;
   const out = waited ? { ...data, ...waited } : data;
+  const backup = waited?.status === "succeeded" ? yield* loadTxnDetail({ txnId: data.txn_id }).pipe(map17((detail) => extractReplaceBackupSummary(detail)), catchAll2(() => succeed8(undefined))) : undefined;
   yield* writeSuccess({
-    data: { ...out, target: resolvedTarget },
+    data: backup ? { ...out, target: resolvedTarget, backup } : { ...out, target: resolvedTarget },
     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}`] : []
+      ...waited ? [`- status: ${waited.status}`, `- elapsed_ms: ${waited.elapsed_ms}`] : [],
+      ...backup ? [
+        `- backup_policy: ${backup.policy}`,
+        `- backup_deleted: ${backup.deleted ? "true" : "false"}`,
+        ...backup.hidden ? ["- backup_hidden: true"] : [],
+        ...backup.cleanup_state ? [`- backup_cleanup_state: ${backup.cleanup_state}`] : []
+      ] : []
     ].join(`
 `)
   });
-}).pipe(catchAll2(writeFailure)));
+}).pipe(catchAll2(writeFailure))).pipe(exports_Command.withDescription("advanced/local-only block replace command; canonical anchor-preserving rewrites should prefer rem children replace"));
 
 // src/commands/write/replace/text.ts
-function optionToUndefined45(opt) {
+function optionToUndefined56(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
 function readOptionalText5(name) {
-  return text9(name).pipe(optional5, map34(optionToUndefined45));
+  return text9(name).pipe(optional5, map34(optionToUndefined56));
 }
 var selection2 = boolean8("selection");
-var stateFile19 = readOptionalText5("state-file");
-var staleMs12 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined45));
+var stateFile25 = readOptionalText5("state-file");
+var staleMs12 = integer7("stale-ms").pipe(optional5, map34(optionToUndefined56));
 var ref4 = readOptionalText5("ref");
 var ids5 = text9("id").pipe(repeated5);
-var scope6 = choice5("scope", ["roots", "subtree"]).pipe(optional5, map34(optionToUndefined45));
+var scope6 = choice5("scope", ["roots", "subtree"]).pipe(optional5, map34(optionToUndefined56));
 var maxDepth5 = integer7("max-depth").pipe(withDefault5(10));
 var maxNodes3 = integer7("max-nodes").pipe(withDefault5(1000));
 var requireComplete2 = boolean8("require-complete");
@@ -102376,12 +104084,12 @@ var flags = readOptionalText5("flags");
 var clientId4 = readOptionalText5("client-id");
 var idempotencyKey4 = readOptionalText5("idempotency-key");
 var metaSpec4 = readOptionalText5("meta");
-var priority4 = integer7("priority").pipe(optional5, map34(optionToUndefined45));
+var priority4 = integer7("priority").pipe(optional5, map34(optionToUndefined56));
 var notify4 = boolean8("no-notify").pipe(map34((v) => !v));
 var ensureDaemon6 = boolean8("no-ensure-daemon").pipe(map34((v) => !v));
 var wait4 = boolean8("wait");
-var timeoutMs5 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined45));
-var pollMs4 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined45));
+var timeoutMs5 = integer7("timeout-ms").pipe(optional5, map34(optionToUndefined56));
+var pollMs4 = integer7("poll-ms").pipe(optional5, map34(optionToUndefined56));
 function tryMakeRegExp(pattern2, rawFlags) {
   const f = typeof rawFlags === "string" && rawFlags.trim() ? rawFlags.trim() : "g";
   const withGlobal = f.includes("g") ? f : `g${f}`;
@@ -102427,7 +104135,7 @@ function replaceRichText(value8, replacer) {
 }
 var replaceLiteralCommand = exports_Command.make("literal", {
   selection: selection2,
-  stateFile: stateFile19,
+  stateFile: stateFile25,
   staleMs: staleMs12,
   ref: ref4,
   id: ids5,
@@ -102452,7 +104160,7 @@ var replaceLiteralCommand = exports_Command.make("literal", {
   meta: metaSpec4
 }, ({
   selection: selection3,
-  stateFile: stateFile20,
+  stateFile: stateFile26,
   staleMs: staleMs13,
   ref: ref5,
   id: id5,
@@ -102493,7 +104201,7 @@ var replaceLiteralCommand = exports_Command.make("literal", {
   const cfg = yield* AppConfig;
   const payloadSvc = yield* Payload;
   const remdb = yield* RemDb;
-  const target2 = yield* resolveReplaceTarget({ selection: selection3, stateFile: stateFile20, staleMs: staleMs13, ref: ref5, ids: id5 });
+  const target2 = yield* resolveReplaceTarget({ selection: selection3, stateFile: stateFile26, staleMs: staleMs13, ref: ref5, ids: id5 });
   const scopeValue = scope7 ?? "roots";
   if (target2.kind === "selection" && requireComplete3) {
     const sel = target2.snapshot.selection;
@@ -102629,11 +104337,11 @@ var writeReplaceCommand = exports_Command.make("replace", {}).pipe(exports_Comma
 var replaceCommand = writeReplaceCommand;
 
 // src/commands/read/search.ts
-function optionToUndefined46(opt) {
+function optionToUndefined57(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var timeRange2 = text9("time").pipe(optional5, map34(optionToUndefined46));
-var parentId = text9("parent").pipe(optional5, map34(optionToUndefined46));
+var timeRange2 = text9("time").pipe(optional5, map34(optionToUndefined57));
+var parentId = text9("parent").pipe(optional5, map34(optionToUndefined57));
 var limit7 = integer7("limit").pipe(withDefault5(10));
 var offset6 = integer7("offset").pipe(withDefault5(0));
 var timeoutMs6 = integer7("timeout-ms").pipe(withDefault5(30000));
@@ -102691,10 +104399,10 @@ function normalizeRemIdInput7(raw4) {
 }
 var writeTableCreateCommand = exports_Command.make("create", {
   tableTag: text9("table-tag"),
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined34)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined34)),
-  position: integer7("position").pipe(optional5, map34(optionToUndefined34)),
-  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined34)),
+  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
+  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
+  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
+  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103105,8 +104813,8 @@ var writeTableOptionCommand = exports_Command.make("option", {}).pipe(exports_Co
 var writeTablePropertyAddCommand = exports_Command.make("add", {
   tableTag: text9("table-tag"),
   name: text9("name"),
-  type: text9("type").pipe(optional5, map34(optionToUndefined34)),
-  options: text9("options").pipe(optional5, map34(optionToUndefined34)),
+  type: text9("type").pipe(optional5, map34(optionToUndefined43)),
+  options: text9("options").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103242,10 +104950,10 @@ var writeTablePropertyCommand = exports_Command.make("property", {}).pipe(export
 // src/commands/write/table/record/add.ts
 var writeTableRecordAddCommand = exports_Command.make("add", {
   tableTag: text9("table-tag"),
-  parent: text9("parent").pipe(optional5, map34(optionToUndefined34)),
-  ref: text9("ref").pipe(optional5, map34(optionToUndefined34)),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  parent: text9("parent").pipe(optional5, map34(optionToUndefined43)),
+  ref: text9("ref").pipe(optional5, map34(optionToUndefined43)),
+  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103560,8 +105268,8 @@ function rowHasTag4(doc, tagId) {
 var writeTableRecordUpdateCommand = exports_Command.make("update", {
   tableTag: text9("table-tag"),
   row: text9("row"),
-  text: text9("text").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  text: text9("text").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -103782,10 +105490,10 @@ var tableCommand = exports_Command.make("table", {}).pipe(exports_Command.withSu
 var tagCommand = writeTagCommand;
 
 // src/commands/read/todos/list.ts
-function optionToUndefined47(opt) {
+function optionToUndefined58(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var status2 = choice5("status", ["unfinished", "finished", "all"]).pipe(optional5, map34(optionToUndefined47));
+var status2 = choice5("status", ["unfinished", "finished", "all"]).pipe(optional5, map34(optionToUndefined58));
 var sort3 = choice5("sort", [
   "dueAsc",
   "dueDesc",
@@ -103793,22 +105501,22 @@ var sort3 = choice5("sort", [
   "updatedAtDesc",
   "createdAtAsc",
   "createdAtDesc"
-]).pipe(optional5, map34(optionToUndefined47));
+]).pipe(optional5, map34(optionToUndefined58));
 var tagId = text9("tag-id").pipe(repeated5);
 var tagTitle = text9("tag-title").pipe(repeated5);
 var preferTodoOnly = boolean8("prefer-todo-only");
 var preferTodoFirst = boolean8("prefer-todo-first");
 var includeDescendants = boolean8("no-descendants").pipe(map34((v) => !v));
-var ancestor = text9("ancestor").pipe(optional5, map34(optionToUndefined47));
-var dueBefore = text9("due-before").pipe(optional5, map34(optionToUndefined47));
-var dueAfter = text9("due-after").pipe(optional5, map34(optionToUndefined47));
+var ancestor = text9("ancestor").pipe(optional5, map34(optionToUndefined58));
+var dueBefore = text9("due-before").pipe(optional5, map34(optionToUndefined58));
+var dueAfter = text9("due-after").pipe(optional5, map34(optionToUndefined58));
 var includeTagOnlyWhenNoStatus = boolean8("no-tag-only-when-no-status").pipe(map34((v) => !v));
 var statusAttrTitle = text9("status-attr-title").pipe(repeated5);
 var unfinishedOptionTitle = text9("unfinished-option-title").pipe(repeated5);
 var finishedOptionTitle = text9("finished-option-title").pipe(repeated5);
 var dueDateAttrTitle = text9("due-date-attr-title").pipe(repeated5);
 var alwaysIncludeTagOnlyTitle = text9("always-include-tag-only-title").pipe(repeated5);
-var snippetLength2 = integer7("snippet-length").pipe(optional5, map34(optionToUndefined47));
+var snippetLength2 = integer7("snippet-length").pipe(optional5, map34(optionToUndefined58));
 var limit9 = integer7("limit").pipe(withDefault5(20));
 var offset8 = integer7("offset").pipe(withDefault5(0));
 function makeTodosListCommand() {
@@ -103889,8 +105597,8 @@ function makeTodosListCommand() {
 var todosListCommand = makeTodosListCommand();
 
 // src/commands/write/powerup/todo/todoAdd.ts
-var status3 = choice5("status", ["unfinished", "finished", "clear"]).pipe(optional5, map34(optionToUndefined34));
-var dispatchMode4 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var status3 = choice5("status", ["unfinished", "finished", "clear"]).pipe(optional5, map34(optionToUndefined43));
+var dispatchMode4 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 function pickTodoSchema(schemas, tagId2) {
   const mapped = schemas.map((s) => ({
     tagId: String(s?.tagId ?? ""),
@@ -103909,10 +105617,10 @@ function pickTodoSchema(schemas, tagId2) {
 }
 var writePowerupTodoAddCommand = exports_Command.make("add", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
   status: status3,
-  due: text9("due").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  due: text9("due").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -104170,12 +105878,12 @@ function todoWriteEffect(params3) {
 }
 
 // src/commands/write/powerup/todo/todoDone.ts
-var dispatchMode5 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var dispatchMode5 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 var writePowerupTodoDoneCommand = exports_Command.make("done", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  due: text9("due").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  due: text9("due").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -104232,8 +105940,8 @@ function pickTodoTagId(schemas, tagId2) {
 }
 var writePowerupTodoRemoveCommand = exports_Command.make("remove", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  removeProperties: boolean8("remove-properties").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -104360,12 +106068,12 @@ var writePowerupTodoRemoveCommand = exports_Command.make("remove", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/write/powerup/todo/todoUndone.ts
-var dispatchMode6 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined34));
+var dispatchMode6 = choice5("dispatch-mode", ["serial", "conflict_parallel"]).pipe(optional5, map34(optionToUndefined43));
 var writePowerupTodoUndoneCommand = exports_Command.make("undone", {
   rem: text9("rem"),
-  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined34)),
-  due: text9("due").pipe(optional5, map34(optionToUndefined34)),
-  values: text9("values").pipe(optional5, map34(optionToUndefined34)),
+  tagId: text9("tag-id").pipe(optional5, map34(optionToUndefined43)),
+  due: text9("due").pipe(optional5, map34(optionToUndefined43)),
+  values: text9("values").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -104422,15 +106130,15 @@ var todoCommand = exports_Command.make("todo", {}).pipe(exports_Command.withSubc
 ]));
 
 // src/commands/read/topic/summary.ts
-function optionToUndefined48(opt) {
+function optionToUndefined59(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var keywords = text9("keywords").pipe(optional5, map34(optionToUndefined48));
-var query2 = text9("query").pipe(optional5, map34(optionToUndefined48));
-var timeRange3 = text9("time").pipe(optional5, map34(optionToUndefined48));
-var maxResults = integer7("max-results").pipe(optional5, map34(optionToUndefined48));
-var maxNodesPerResult = integer7("max-nodes").pipe(optional5, map34(optionToUndefined48));
-var groupBy2 = choice5("group-by", ["none", "parent", "date"]).pipe(optional5, map34(optionToUndefined48));
+var keywords = text9("keywords").pipe(optional5, map34(optionToUndefined59));
+var query2 = text9("query").pipe(optional5, map34(optionToUndefined59));
+var timeRange3 = text9("time").pipe(optional5, map34(optionToUndefined59));
+var maxResults = integer7("max-results").pipe(optional5, map34(optionToUndefined59));
+var maxNodesPerResult = integer7("max-nodes").pipe(optional5, map34(optionToUndefined59));
+var groupBy2 = choice5("group-by", ["none", "parent", "date"]).pipe(optional5, map34(optionToUndefined59));
 var topicSummaryCommand = exports_Command.make("summary", { keywords, query: query2, timeRange: timeRange3, maxResults, maxNodesPerResult, groupBy: groupBy2 }, ({ keywords: keywords2, query: query3, timeRange: timeRange4, maxResults: maxResults2, maxNodesPerResult: maxNodesPerResult2, groupBy: groupBy3 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   yield* failInRemoteMode({
@@ -104486,8 +106194,8 @@ function looksLikeRef(raw4) {
 var writePortalCreateCommand = exports_Command.make("create", {
   parent: text9("parent"),
   target: text9("target"),
-  position: integer7("position").pipe(optional5, map34(optionToUndefined34)),
-  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined34)),
+  position: integer7("position").pipe(optional5, map34(optionToUndefined43)),
+  clientTempId: text9("client-temp-id").pipe(optional5, map34(optionToUndefined43)),
   notify: writeCommonOptions.notify,
   ensureDaemon: writeCommonOptions.ensureDaemon,
   wait: writeCommonOptions.wait,
@@ -104688,7 +106396,7 @@ var stackEnsureCommand = exports_Command.make("ensure", {
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/stack/status.ts
-import path26 from "node:path";
+import path29 from "node:path";
 var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function* () {
   const cfg = yield* AppConfig;
   const daemonFiles = yield* DaemonFiles;
@@ -104709,7 +106417,7 @@ 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 ?? path26.join(path26.dirname(daemonPidFile), "ws.state.json"));
+  const stateFilePath = resolveUserFilePath(daemonPidInfo?.state_file ?? path29.join(path29.dirname(daemonPidFile), "ws.state.json"));
   const data = {
     daemon: {
       running: daemonRunning,
@@ -104755,7 +106463,7 @@ var stackStatusCommand = exports_Command.make("status", {}, () => gen2(function*
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/stack/stop.ts
-import path27 from "node:path";
+import path30 from "node:path";
 var stackStopCommand = exports_Command.make("stop", {}, () => gen2(function* () {
   const apiFiles = yield* ApiDaemonFiles;
   const daemonFiles = yield* DaemonFiles;
@@ -104792,7 +106500,7 @@ var stackStopCommand = exports_Command.make("stop", {}, () => gen2(function* ()
     }
   }
   yield* daemonFiles.deletePidFile(daemonPidFile).pipe(catchAll2(() => _void));
-  yield* supervisorState.deleteStateFile(resolveUserFilePath(daemonPidInfo?.state_file ?? path27.join(path27.dirname(daemonPidFile), "ws.state.json"))).pipe(catchAll2(() => _void));
+  yield* supervisorState.deleteStateFile(resolveUserFilePath(daemonPidInfo?.state_file ?? path30.join(path30.dirname(daemonPidFile), "ws.state.json"))).pipe(catchAll2(() => _void));
   yield* writeSuccess({
     data: { stopped: true, api_stopped: apiStopped, daemon_stopped: daemonStopped },
     md: `- stopped: true
@@ -104806,23 +106514,23 @@ var stackStopCommand = exports_Command.make("stop", {}, () => gen2(function* ()
 var stackCommand = exports_Command.make("stack", {}).pipe(exports_Command.withSubcommands([stackEnsureCommand, stackStopCommand, stackStatusCommand]));
 
 // src/commands/index.ts
-function optionToUndefined49(opt) {
+function optionToUndefined60(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-var remnoteDb = text9("remnote-db").pipe(optional5, map34(optionToUndefined49));
-var storeDb = text9("store-db").pipe(optional5, map34(optionToUndefined49));
-var daemonUrl = text9("daemon-url").pipe(optional5, map34(optionToUndefined49));
-var wsPort = integer7("ws-port").pipe(optional5, map34(optionToUndefined49));
-var repo = text9("repo").pipe(optional5, map34(optionToUndefined49));
-var apiBaseUrl = text9("api-base-url").pipe(optional5, map34(optionToUndefined49));
-var apiHost = text9("api-host").pipe(optional5, map34(optionToUndefined49));
-var apiPort = integer7("api-port").pipe(optional5, map34(optionToUndefined49));
-var apiBasePath = text9("api-base-path").pipe(optional5, map34(optionToUndefined49));
-var configFile = text9("config-file").pipe(optional5, map34(optionToUndefined49));
+var remnoteDb = text9("remnote-db").pipe(optional5, map34(optionToUndefined60));
+var storeDb = text9("store-db").pipe(optional5, map34(optionToUndefined60));
+var daemonUrl = text9("daemon-url").pipe(optional5, map34(optionToUndefined60));
+var wsPort = integer7("ws-port").pipe(optional5, map34(optionToUndefined60));
+var repo = text9("repo").pipe(optional5, map34(optionToUndefined60));
+var apiBaseUrl = text9("api-base-url").pipe(optional5, map34(optionToUndefined60));
+var apiHost = text9("api-host").pipe(optional5, map34(optionToUndefined60));
+var apiPort = integer7("api-port").pipe(optional5, map34(optionToUndefined60));
+var apiBasePath = text9("api-base-path").pipe(optional5, map34(optionToUndefined60));
+var configFile = text9("config-file").pipe(optional5, map34(optionToUndefined60));
 var appConfigLive = effect(AppConfig, resolveConfig());
 var statusLineUpdaterLive = StatusLineUpdaterLive.pipe(provide3([appConfigLive, QueueLive, StatusLineFileLive, TmuxLive, WsBridgeStateLive]));
 var statusLineLive = StatusLineControllerLive.pipe(provide3(statusLineUpdaterLive), provide3(appConfigLive));
-var servicesLive = mergeAll5(appConfigLive, OutputLive, FileInputLive, FsAccessLive, LogWriterFactoryLive, PayloadLive, DaemonFilesLive, ApiDaemonFilesLive, ProcessLive, ChildProcessLive, WsClientLive, HostApiClientLive.pipe(provide3(appConfigLive)), UserConfigFileLive, WorkspaceBindingsLive, QueueLive, RefResolverLive, RemDbLive, StatusLineFileLive, SubprocessLive, SupervisorStateLive, WsBridgeServerLive, WsBridgeStateFileLive, statusLineLive);
+var servicesLive = mergeAll5(appConfigLive, OutputLive, FileInputLive, FsAccessLive, LogWriterFactoryLive, PayloadLive, DaemonFilesLive, ApiDaemonFilesLive, ProcessLive, ChildProcessLive, WsClientLive, HostApiClientLive.pipe(provide3(appConfigLive)), PluginServerFilesLive, UserConfigFileLive, WorkspaceBindingsLive, QueueLive, RefResolverLive, RemDbLive, StatusLineFileLive, SubprocessLive, SupervisorStateLive, WsBridgeServerLive, WsBridgeStateFileLive, statusLineLive);
 var rootCommand = exports_Command.make("agent-remnote", {
   json: boolean8("json"),
   md: boolean8("md"),
@@ -104850,6 +106558,7 @@ var rootCommand = exports_Command.make("agent-remnote", {
   queryCommand,
   remCommand,
   dailyCommand,
+  backupCommand,
   todoCommand,
   topicCommand,
   powerupCommand,