agent-remnote 1.3.0 → 1.3.1

package/dist/main.js

@@ -75207,16 +75207,16 @@ function writeSuccess(params3) {
     if (config3.quiet)
       return;
     if (config3.format === "ids") {
-      if (!params3.ids || params3.ids.length === 0) {
+      if (!params3.ids) {
         return yield* fail8(new CliError({
           code: "INVALID_ARGS",
           message: "This command does not support --ids output",
           exitCode: 2
         }));
       }
-      yield* out.stdout(`${params3.ids.join(`
+      yield* out.stdout(params3.ids.length > 0 ? `${params3.ids.join(`
 `)}
-`);
+` : "");
       return;
     }
     if (params3.data && typeof params3.data === "object") {
@@ -75987,6 +75987,90 @@ var migration6 = {
   }
 };
 
+// src/internal/store/migrations/0008-add-automation-skeleton.ts
+var TASK_DEFS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS task_defs (
+  task_id      TEXT PRIMARY KEY,
+  task_kind    TEXT NOT NULL,
+  config_json  TEXT NOT NULL DEFAULT '{}',
+  created_at   INTEGER NOT NULL,
+  updated_at   INTEGER NOT NULL
+);`;
+var TRIGGER_RULES_TABLE_SQL = `CREATE TABLE IF NOT EXISTS trigger_rules (
+  trigger_id    TEXT PRIMARY KEY,
+  trigger_kind  TEXT NOT NULL,
+  task_id       TEXT NOT NULL,
+  enabled       INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+  match_json    TEXT NOT NULL DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL,
+  FOREIGN KEY (task_id) REFERENCES task_defs(task_id) ON DELETE RESTRICT
+);`;
+var EVENT_EVENTS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS event_events (
+  event_id        TEXT PRIMARY KEY,
+  event_kind      TEXT NOT NULL,
+  source_rem_id   TEXT,
+  source_tag_id   TEXT,
+  dedupe_key      TEXT NOT NULL UNIQUE,
+  payload_json    TEXT NOT NULL DEFAULT '{}',
+  created_at      INTEGER NOT NULL
+);`;
+var TASK_RUNS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS task_runs (
+  run_id          TEXT PRIMARY KEY,
+  task_id         TEXT NOT NULL,
+  trigger_id      TEXT,
+  event_id        TEXT,
+  target_rem_id   TEXT NOT NULL,
+  result_rem_id   TEXT,
+  queue_txn_id    TEXT,
+  status          TEXT NOT NULL CHECK (status IN ('pending','running','succeeded','failed','aborted')),
+  detail_json     TEXT NOT NULL DEFAULT '{}',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  finished_at     INTEGER,
+  FOREIGN KEY (task_id) REFERENCES task_defs(task_id) ON DELETE RESTRICT,
+  FOREIGN KEY (trigger_id) REFERENCES trigger_rules(trigger_id) ON DELETE SET NULL,
+  FOREIGN KEY (event_id) REFERENCES event_events(event_id) ON DELETE SET NULL,
+  FOREIGN KEY (queue_txn_id) REFERENCES queue_txns(txn_id) ON DELETE SET NULL
+);`;
+var IDX_TRIGGER_RULES_TASK_ID_SQL = `CREATE INDEX IF NOT EXISTS idx_trigger_rules_task_id ON trigger_rules(task_id);`;
+var IDX_TASK_RUNS_TASK_ID_SQL = `CREATE INDEX IF NOT EXISTS idx_task_runs_task_id ON task_runs(task_id, updated_at DESC);`;
+var IDX_TASK_RUNS_QUEUE_TXN_ID_SQL = `CREATE INDEX IF NOT EXISTS idx_task_runs_queue_txn_id ON task_runs(queue_txn_id);`;
+var IDX_EVENT_EVENTS_SOURCE_REM_SQL = `CREATE INDEX IF NOT EXISTS idx_event_events_source_rem_id ON event_events(source_rem_id, created_at DESC);`;
+var AUTOMATION_SKELETON_SQL = [
+  TASK_DEFS_TABLE_SQL,
+  TRIGGER_RULES_TABLE_SQL,
+  EVENT_EVENTS_TABLE_SQL,
+  TASK_RUNS_TABLE_SQL,
+  IDX_TRIGGER_RULES_TASK_ID_SQL,
+  IDX_TASK_RUNS_TASK_ID_SQL,
+  IDX_TASK_RUNS_QUEUE_TXN_ID_SQL,
+  IDX_EVENT_EVENTS_SOURCE_REM_SQL
+];
+var migration7 = {
+  version: 8,
+  name: "add_automation_skeleton",
+  checksumInput: AUTOMATION_SKELETON_SQL.join(`
+`),
+  apply: (db) => {
+    db.exec(AUTOMATION_SKELETON_SQL.join(`
+`));
+  }
+};
+
+// src/internal/store/migrations/0009-add-task-run-fk-indexes.ts
+var IDX_TASK_RUNS_TRIGGER_ID_SQL = `CREATE INDEX IF NOT EXISTS idx_task_runs_trigger_id ON task_runs(trigger_id);`;
+var IDX_TASK_RUNS_EVENT_ID_SQL = `CREATE INDEX IF NOT EXISTS idx_task_runs_event_id ON task_runs(event_id);`;
+var migration8 = {
+  version: 9,
+  name: "add_task_run_fk_indexes",
+  checksumInput: [IDX_TASK_RUNS_TRIGGER_ID_SQL, IDX_TASK_RUNS_EVENT_ID_SQL].join(`
+`),
+  apply: (db) => {
+    db.exec(IDX_TASK_RUNS_TRIGGER_ID_SQL);
+    db.exec(IDX_TASK_RUNS_EVENT_ID_SQL);
+  }
+};
+
 // src/internal/store/migrations/index.ts
 var BACKUP_ARTIFACTS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS backup_artifacts (
   source_op_id      TEXT PRIMARY KEY,
@@ -76018,7 +76102,7 @@ var m0007 = {
     db.exec(UQ_BACKUP_ARTIFACTS_REM_SQL);
   }
 };
-var migrationSpecs = [migration, migration2, migration3, migration4, migration5, migration6, m0007];
+var migrationSpecs = [migration, migration2, migration3, migration4, migration5, migration6, m0007, migration7, migration8];
 
 // src/internal/store/db.ts
 class StoreSchemaError extends Error {
@@ -76184,6 +76268,72 @@ CREATE INDEX IF NOT EXISTS idx_backup_artifacts_kind
 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;
+
+CREATE TABLE IF NOT EXISTS task_defs (
+  task_id      TEXT PRIMARY KEY,
+  task_kind    TEXT NOT NULL,
+  config_json  TEXT NOT NULL DEFAULT '{}',
+  created_at   INTEGER NOT NULL,
+  updated_at   INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS trigger_rules (
+  trigger_id    TEXT PRIMARY KEY,
+  trigger_kind  TEXT NOT NULL,
+  task_id       TEXT NOT NULL,
+  enabled       INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+  match_json    TEXT NOT NULL DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL,
+  FOREIGN KEY (task_id) REFERENCES task_defs(task_id) ON DELETE RESTRICT
+);
+
+CREATE INDEX IF NOT EXISTS idx_trigger_rules_task_id
+  ON trigger_rules(task_id);
+
+CREATE TABLE IF NOT EXISTS event_events (
+  event_id        TEXT PRIMARY KEY,
+  event_kind      TEXT NOT NULL,
+  source_rem_id   TEXT,
+  source_tag_id   TEXT,
+  dedupe_key      TEXT NOT NULL UNIQUE,
+  payload_json    TEXT NOT NULL DEFAULT '{}',
+  created_at      INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_event_events_source_rem_id
+  ON event_events(source_rem_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS task_runs (
+  run_id          TEXT PRIMARY KEY,
+  task_id         TEXT NOT NULL,
+  trigger_id      TEXT,
+  event_id        TEXT,
+  target_rem_id   TEXT NOT NULL,
+  result_rem_id   TEXT,
+  queue_txn_id    TEXT,
+  status          TEXT NOT NULL CHECK (status IN ('pending','running','succeeded','failed','aborted')),
+  detail_json     TEXT NOT NULL DEFAULT '{}',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  finished_at     INTEGER,
+  FOREIGN KEY (task_id) REFERENCES task_defs(task_id) ON DELETE RESTRICT,
+  FOREIGN KEY (trigger_id) REFERENCES trigger_rules(trigger_id) ON DELETE SET NULL,
+  FOREIGN KEY (event_id) REFERENCES event_events(event_id) ON DELETE SET NULL,
+  FOREIGN KEY (queue_txn_id) REFERENCES queue_txns(txn_id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_task_id
+  ON task_runs(task_id, updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_trigger_id
+  ON task_runs(trigger_id);
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_event_id
+  ON task_runs(event_id);
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_queue_txn_id
+  ON task_runs(queue_txn_id);
 `;
 function absoluteDefaultStorePath() {
   return path12.join(homeDir(), ".agent-remnote", "store.sqlite");
@@ -76380,17 +76530,17 @@ function readAppliedMigrations(db) {
     return new Map;
   }
 }
-function ensureMigrationRecorded(db, migration7, appliedAt, appVersion) {
-  const existing = db.prepare(`SELECT name, checksum FROM store_migrations WHERE version=?`).get(migration7.version);
+function ensureMigrationRecorded(db, migration9, appliedAt, appVersion) {
+  const existing = db.prepare(`SELECT name, checksum FROM store_migrations WHERE version=?`).get(migration9.version);
   if (existing) {
     const actualChecksum = typeof existing?.checksum === "string" ? existing.checksum : String(existing?.checksum ?? "");
-    if (actualChecksum !== migration7.checksum) {
+    if (actualChecksum !== migration9.checksum) {
       throw new StoreSchemaError({
         code: "STORE_SCHEMA_INVALID",
         message: "Store database migration drift detected",
         details: {
-          version: migration7.version,
-          expected: { name: migration7.name, checksum: migration7.checksum },
+          version: migration9.version,
+          expected: { name: migration9.name, checksum: migration9.checksum },
           actual: { name: String(existing?.name ?? ""), checksum: actualChecksum }
         },
         nextActions: ["Upgrade `agent-remnote` to a newer version", "agent-remnote doctor"]
@@ -76401,9 +76551,9 @@ function ensureMigrationRecorded(db, migration7, appliedAt, appVersion) {
   try {
     db.prepare(`INSERT INTO store_migrations(version, name, checksum, applied_at, app_version)
        VALUES(@version, @name, @checksum, @applied_at, @app_version)`).run({
-      version: migration7.version,
-      name: migration7.name,
-      checksum: migration7.checksum,
+      version: migration9.version,
+      name: migration9.name,
+      checksum: migration9.checksum,
       applied_at: appliedAt,
       app_version: appVersion
     });
@@ -76411,15 +76561,15 @@ function ensureMigrationRecorded(db, migration7, appliedAt, appVersion) {
     const code2 = String(e?.code || "");
     if (code2 !== "SQLITE_CONSTRAINT" && code2 !== "SQLITE_CONSTRAINT_PRIMARYKEY" && code2 !== "SQLITE_CONSTRAINT_UNIQUE")
       throw e;
-    const again = db.prepare(`SELECT name, checksum FROM store_migrations WHERE version=?`).get(migration7.version);
+    const again = db.prepare(`SELECT name, checksum FROM store_migrations WHERE version=?`).get(migration9.version);
     const actualChecksum = typeof again?.checksum === "string" ? again.checksum : String(again?.checksum ?? "");
-    if (actualChecksum !== migration7.checksum) {
+    if (actualChecksum !== migration9.checksum) {
       throw new StoreSchemaError({
         code: "STORE_SCHEMA_INVALID",
         message: "Store database migration drift detected",
         details: {
-          version: migration7.version,
-          expected: { name: migration7.name, checksum: migration7.checksum },
+          version: migration9.version,
+          expected: { name: migration9.name, checksum: migration9.checksum },
           actual: { name: String(again?.name ?? ""), checksum: actualChecksum }
         },
         nextActions: ["Upgrade `agent-remnote` to a newer version", "agent-remnote doctor"]
@@ -76454,8 +76604,8 @@ function ensureAuditUpTo(db, version) {
   }
 }
 function applyMigration(db, targetVersion) {
-  const migration7 = MIGRATION_PLAN.migrations[targetVersion - 1];
-  if (!migration7 || migration7.version !== targetVersion) {
+  const migration9 = MIGRATION_PLAN.migrations[targetVersion - 1];
+  if (!migration9 || migration9.version !== targetVersion) {
     throw new StoreSchemaError({
       code: "STORE_SCHEMA_UNKNOWN",
       message: `Unknown store migration target: ${targetVersion}`,
@@ -76463,8 +76613,8 @@ function applyMigration(db, targetVersion) {
       nextActions: ["Report this as a bug"]
     });
   }
-  migration7.apply(db);
-  ensureMigrationRecorded(db, migration7, Date.now(), appVersionForAudit());
+  migration9.apply(db);
+  ensureMigrationRecorded(db, migration9, Date.now(), appVersionForAudit());
 }
 function migrate(db, resolvedPath) {
   const initial = readUserVersion(db);
@@ -77183,10 +77333,13 @@ function commitTxn(db, txn_id) {
   upd.run({ t, txn_id });
 }
 function enqueueTxn(db, ops, options6) {
-  const txn_id = createTxn(db, options6);
-  addOps(db, txn_id, ops);
-  commitTxn(db, txn_id);
-  return txn_id;
+  const trx = db.transaction(() => {
+    const txn_id = createTxn(db, options6);
+    addOps(db, txn_id, ops);
+    commitTxn(db, txn_id);
+    return txn_id;
+  });
+  return trx();
 }
 
 class IdMapConflictError extends Error {
@@ -85895,14 +86048,24 @@ function fetchOutlineNodes(db, options6) {
   })();
   const rows = stmt.all({ rootId: options6.rootId, maxDepth: options6.maxDepth });
   const nodes = [];
+  const targetStmt = db.prepare("SELECT doc FROM quanta WHERE _id = ?");
+  const targetCache = new Map;
   for (const row of rows) {
     const doc = safeJsonParse(row.doc);
     const rawKey = doc?.key;
+    const targetDescriptor = findOutlineTargetDescriptor(doc, rawKey);
+    const target2 = targetDescriptor ? targetCache.get(targetDescriptor.id) ?? (() => {
+      const resolved = resolveOutlineTarget(targetStmt, db, targetDescriptor.id);
+      targetCache.set(targetDescriptor.id, resolved);
+      return resolved;
+    })() : null;
+    const kind = targetDescriptor?.kind === "portal" ? "portal" : "rem";
     const keySummary = summarizeKey(rawKey, db, {
       expand: options6.expandReferences,
       maxDepth: options6.maxReferenceDepth
     });
-    if (!options6.includeEmpty && !keySummary.text && row.depth !== 0) {
+    const text14 = renderOutlineNodeText(kind, keySummary.text, target2);
+    if (!options6.includeEmpty && !text14 && row.depth !== 0) {
       continue;
     }
     const isSystemRem = SYSTEM_REM_IDS.has(row.id) || SYSTEM_REM_KEYS.has(keySummary.text);
@@ -85919,9 +86082,11 @@ function fetchOutlineNodes(db, options6) {
     nodes.push({
       id: row.id,
       depth: row.depth,
+      kind,
       sortKey: typeof doc?.f === "string" ? doc.f : null,
       parentId: typeof doc?.parent === "string" ? doc.parent : null,
-      text: keySummary.text,
+      text: text14,
+      target: target2,
       references: keySummary.references,
       rawKey
     });
@@ -85932,7 +86097,9 @@ function simplifyOutlineNodes(nodes) {
   return nodes.map((node) => ({
     id: node.id,
     depth: node.depth,
+    kind: node.kind,
     text: node.text,
+    target: node.target,
     references: node.references
   }));
 }
@@ -85944,6 +86111,72 @@ function toMarkdown(nodes) {
   }).join(`
 `);
 }
+function findOutlineTargetDescriptor(doc, value8) {
+  const docType = typeof doc?.type === "number" ? doc.type : typeof doc?.type === "string" ? Number(doc.type) : NaN;
+  const pdRaw = doc?.pd;
+  if (docType === 6 && pdRaw && typeof pdRaw === "object" && !Array.isArray(pdRaw)) {
+    const pdKeys = Object.keys(pdRaw).map((key) => key.trim()).filter(Boolean);
+    if (pdKeys.length > 0) {
+      return { kind: "portal", id: pdKeys[0] };
+    }
+  }
+  const referenceFallback = (() => {
+    if (!Array.isArray(value8) || value8.length !== 1)
+      return null;
+    const only = value8[0];
+    if (!only || typeof only !== "object")
+      return null;
+    const obj = only;
+    const tokenType = typeof obj.i === "string" ? obj.i : "";
+    const targetId = typeof obj._id === "string" ? obj._id.trim() : "";
+    return tokenType === "q" && targetId ? { kind: "reference", id: targetId } : null;
+  })();
+  const visit2 = (input) => {
+    if (Array.isArray(input)) {
+      for (const item of input) {
+        const found = visit2(item);
+        if (found?.kind === "portal")
+          return found;
+      }
+      return null;
+    }
+    if (input && typeof input === "object") {
+      const obj = input;
+      const tokenType = typeof obj.i === "string" ? obj.i : "";
+      const targetId = typeof obj._id === "string" ? obj._id.trim() : "";
+      if (tokenType === "p" && targetId) {
+        return { kind: "portal", id: targetId };
+      }
+      for (const child of Object.values(obj)) {
+        const found = visit2(child);
+        if (found?.kind === "portal")
+          return found;
+      }
+    }
+    return null;
+  };
+  const portal = visit2(value8);
+  return portal ?? referenceFallback;
+}
+function resolveOutlineTarget(stmt, db, targetId) {
+  const row = stmt.get(targetId);
+  if (!row?.doc) {
+    return { id: targetId, text: null, resolved: false };
+  }
+  const parsed = safeJsonParse(row.doc);
+  const summary6 = summarizeKey(parsed?.key, db, { expand: false, maxDepth: 0 });
+  const text14 = typeof summary6.text === "string" ? summary6.text : null;
+  return { id: targetId, text: text14, resolved: true };
+}
+function renderOutlineNodeText(kind, fallbackText, target2) {
+  if (kind === "portal" && target2) {
+    if (!target2.resolved) {
+      return `Portal -> {ref:${target2.id}}`;
+    }
+    return `Portal -> ${target2.text && target2.text.length > 0 ? target2.text : "(empty)"}`;
+  }
+  return fallbackText;
+}
 
 // src/internal/remdb-tools/findRemsByReference.ts
 var inputShape4 = {
@@ -90168,6 +90401,174 @@ async function executeResolveRemPage(params3) {
     markdown
   };
 }
+// src/internal/remdb-tools/summarizeRecentActivity.ts
+function asInt(value8) {
+  if (typeof value8 === "number" && Number.isFinite(value8))
+    return Math.trunc(value8);
+  if (typeof value8 === "string") {
+    const n = Number(value8);
+    if (Number.isFinite(n))
+      return Math.trunc(n);
+  }
+  return null;
+}
+function cleanTitle(input) {
+  if (typeof input !== "string")
+    return "";
+  return input.split(/\s+/).join(" ").trim();
+}
+function assertTimezone(timezone) {
+  const effective = timezone.trim() || Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+  new Intl.DateTimeFormat("en-CA", { timeZone: effective, year: "numeric", month: "2-digit", day: "2-digit" });
+  return effective;
+}
+function dayKeyFromMs(ms, timezone) {
+  const parts2 = new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).formatToParts(new Date(ms));
+  const year = parts2.find((part) => part.type === "year")?.value ?? "0000";
+  const month = parts2.find((part) => part.type === "month")?.value ?? "00";
+  const day = parts2.find((part) => part.type === "day")?.value ?? "00";
+  return `${year}-${month}-${day}`;
+}
+function buildCounts(items) {
+  const created = items.filter((item) => item.activity_kind === "created").length;
+  const modifiedExisting = items.filter((item) => item.activity_kind === "modified_existing").length;
+  return {
+    total: items.length,
+    created,
+    modified_existing: modifiedExisting
+  };
+}
+function toAggregateItems(items) {
+  return items.map(({ activity_at: _activityAt, ...item }) => item);
+}
+function summarizeByDay(items, timezone, limit) {
+  const groups = new Map;
+  for (const item of items) {
+    const key = dayKeyFromMs(item.activity_at, timezone);
+    const existing = groups.get(key);
+    if (existing)
+      existing.push(item);
+    else
+      groups.set(key, [item]);
+  }
+  return Array.from(groups.entries()).sort((a, b) => b[0].localeCompare(a[0])).slice(0, limit).map(([key, group4]) => ({
+    dimension: "day",
+    key,
+    counts: buildCounts(group4),
+    samples: toAggregateItems(group4.slice(0, 3)),
+    timezone
+  }));
+}
+function summarizeByParent(items, limit) {
+  const groups = new Map;
+  for (const item of items) {
+    const key = item.parent_id ?? "(root)";
+    const existing = groups.get(key);
+    if (existing)
+      existing.push(item);
+    else
+      groups.set(key, [item]);
+  }
+  return Array.from(groups.entries()).sort((a, b) => b[1].length - a[1].length || a[0].localeCompare(b[0])).slice(0, limit).map(([key, group4]) => ({
+    dimension: "parent",
+    key,
+    counts: buildCounts(group4),
+    samples: toAggregateItems(group4.slice(0, 3)),
+    parent_id: group4[0]?.parent_id ?? null,
+    parent_preview: group4[0]?.parent_preview ?? null
+  }));
+}
+function executeSummarizeRecentActivity(db, params3) {
+  if (!Number.isInteger(params3.days) || params3.days < 1) {
+    throw new RangeError("days must be an integer >= 1");
+  }
+  if (!Number.isInteger(params3.itemLimit) || params3.itemLimit < 1) {
+    throw new RangeError("itemLimit must be an integer >= 1");
+  }
+  if (!Number.isInteger(params3.aggregateLimit) || params3.aggregateLimit < 1) {
+    throw new RangeError("aggregateLimit must be an integer >= 1");
+  }
+  if (params3.kind !== "all" && params3.kind !== "created" && params3.kind !== "modified_existing") {
+    throw new RangeError("kind must be 'all', 'created', or 'modified_existing'");
+  }
+  const aggregateDimensions = Array.from(new Set(params3.aggregates));
+  if (aggregateDimensions.some((dimension) => dimension !== "day" && dimension !== "parent")) {
+    throw new RangeError("aggregates must contain only 'day' or 'parent'");
+  }
+  const now2 = params3.now ?? Date.now();
+  const cutoffMs = now2 - params3.days * 24 * 60 * 60 * 1000;
+  const timezone = assertTimezone(params3.timezone);
+  const rows = db.prepare(`
+        select
+          q._id as id,
+          cast(json_extract(q.doc, '$.createdAt') as integer) as createdAt,
+          cast(coalesce(json_extract(q.doc, '$.m'), json_extract(q.doc, '$.createdAt')) as integer) as updatedAt,
+          json_extract(r.doc, '$.r') as preview,
+          json_extract(q.doc, '$.parent') as parentId,
+          json_extract(pr.doc, '$.r') as parentPreview
+        from quanta q
+        join remsSearchInfos r on r.id = q._id
+        left join remsSearchInfos pr on pr.id = json_extract(q.doc, '$.parent')
+        where
+          cast(json_extract(q.doc, '$.createdAt') as integer) >= @cutoffMs
+          or cast(coalesce(json_extract(q.doc, '$.m'), json_extract(q.doc, '$.createdAt')) as integer) >= @cutoffMs
+      `).all({ cutoffMs });
+  const candidates = rows.map((row) => {
+    const createdAt = asInt(row.createdAt);
+    const updatedAt = asInt(row.updatedAt);
+    if (createdAt === null || updatedAt === null) {
+      return null;
+    }
+    const base = {
+      id: String(row.id),
+      created_at: createdAt,
+      updated_at: updatedAt,
+      preview: cleanTitle(row.preview) || "<no preview>",
+      parent_id: typeof row.parentId === "string" && row.parentId.trim() ? row.parentId.trim() : null,
+      parent_preview: cleanTitle(row.parentPreview) || null
+    };
+    if (base.created_at >= cutoffMs) {
+      return {
+        ...base,
+        activity_kind: "created",
+        activity_at: base.created_at
+      };
+    }
+    if (base.updated_at >= cutoffMs && base.created_at < cutoffMs) {
+      return {
+        ...base,
+        activity_kind: "modified_existing",
+        activity_at: base.updated_at
+      };
+    }
+    return null;
+  }).filter((value8) => value8 !== null).filter((item) => params3.kind === "all" || item.activity_kind === params3.kind).sort((a, b) => b.activity_at - a.activity_at || a.id.localeCompare(b.id));
+  const counts = buildCounts(candidates);
+  const items = toAggregateItems(candidates.slice(0, params3.itemLimit));
+  const aggregates = [];
+  for (const dimension of aggregateDimensions) {
+    if (dimension === "day") {
+      aggregates.push(...summarizeByDay(candidates, timezone, params3.aggregateLimit));
+      continue;
+    }
+    if (dimension === "parent") {
+      aggregates.push(...summarizeByParent(candidates, params3.aggregateLimit));
+    }
+  }
+  return {
+    days: params3.days,
+    timezone,
+    cutoff_ms: cutoffMs,
+    counts,
+    items,
+    aggregates
+  };
+}
 // src/services/Queue.ts
 class Queue extends Tag2("Queue")() {
 }
@@ -93919,6 +94320,25 @@ var ACTIONS = {
       return { ops: [{ type: "replace_children_with_markdown", payload: { parent_id: rem_id, markdown: "" } }] };
     }
   },
+  "portal.create": {
+    opType: "create_portal",
+    supportsAs: false,
+    aliasRefAllowlist: ["parent_id", "target_rem_id"],
+    compile: ({ input }) => {
+      const parent_id = input.parent_id;
+      const target_rem_id = input.target_rem_id;
+      if (typeof parent_id !== "string" || !parent_id.trim()) {
+        throw new Error("portal.create requires input.parent_id");
+      }
+      if (typeof target_rem_id !== "string" || !target_rem_id.trim()) {
+        throw new Error("portal.create requires input.target_rem_id");
+      }
+      const payload = { parent_id, target_rem_id };
+      if (typeof input.position === "number")
+        payload.position = input.position;
+      return { ops: [{ type: "create_portal", payload }] };
+    }
+  },
   "rem.replace": {
     opType: "replace_children_with_markdown",
     supportsAs: false,
@@ -94178,6 +94598,81 @@ function decideOutlineWriteShape(params3) {
     top_level_roots: topLevelRoots
   };
 }
+// src/lib/text.ts
+function trimBoundaryBlankLines(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(`
+`);
+}
+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_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/services/Payload.ts
 import { promises as fs17 } from "node:fs";
 class Payload extends Tag2("Payload")() {
@@ -95136,6 +95631,33 @@ function readOptionalBoolean(obj, key) {
     throw invalidFieldType(key, "a boolean");
   return value8;
 }
+function expandMarkdownInputSpecs(value8) {
+  return gen2(function* () {
+    if (Array.isArray(value8)) {
+      return yield* forEach9(value8, (item) => expandMarkdownInputSpecs(item), { concurrency: 1 });
+    }
+    if (!value8 || typeof value8 !== "object")
+      return value8;
+    const obj = value8;
+    const out = {};
+    for (const [key, entry] of Object.entries(obj)) {
+      if (key === "markdown" && typeof entry === "string") {
+        const raw4 = yield* readMarkdownTextFromInputSpec(entry);
+        out[key] = trimBoundaryBlankLines(raw4);
+        continue;
+      }
+      out[key] = yield* expandMarkdownInputSpecs(entry);
+    }
+    return out;
+  });
+}
+function normalizeAndExpandApplyEnvelope(raw4) {
+  return gen2(function* () {
+    const payloadSvc = yield* Payload;
+    const normalized = payloadSvc.normalizeKeys(raw4);
+    return yield* expandMarkdownInputSpecs(normalized);
+  });
+}
 function parseApplyEnvelope(raw4) {
   const obj = asObject(raw4);
   if (!obj) {
@@ -95427,6 +95949,15 @@ function normalizeTxnStatus(raw4) {
 function countByStatus(ops, status2) {
   return ops.filter((o) => String(o?.status || "") === status2).length;
 }
+function expectedIdMapCount(ops) {
+  const seen = new Set;
+  for (const op of ops) {
+    const clientTempId = typeof op?.payload?.client_temp_id === "string" ? op.payload.client_temp_id.trim() : "";
+    if (clientTempId)
+      seen.add(clientTempId);
+  }
+  return seen.size;
+}
 function waitForTxn(params3) {
   return gen2(function* () {
     const cfg = yield* AppConfig;
@@ -95454,6 +95985,7 @@ function waitForTxn(params3) {
     while (true) {
       const inspected = yield* queue.inspect({ dbPath: cfg.storeDb, txnId: params3.txnId });
       const ops = Array.isArray(inspected.ops) ? inspected.ops : [];
+      const idMap = Array.isArray(inspected.id_map) ? inspected.id_map : [];
       const txnRow = inspected.txn ?? {};
       const opsTotal = ops.length;
       const opsSucceeded = countByStatus(ops, "succeeded");
@@ -95461,6 +95993,7 @@ function waitForTxn(params3) {
       const opsInFlight = countByStatus(ops, "in_flight");
       const opsPending = countByStatus(ops, "pending");
       const opsFailed = ops.filter((o) => String(o?.status || "") === "pending" && Number(o?.attempts ?? 0) > 0).length;
+      const expectedMappings = expectedIdMapCount(ops);
       const score = opsTotal > 0 ? Math.max(0, Math.min(100, Math.floor(100 * (opsSucceeded + opsDead) / opsTotal))) : 0;
       const status2 = normalizeTxnStatus(txnRow.status);
       const isDone7 = status2 === "succeeded" || status2 === "failed" || status2 === "aborted";
@@ -95469,6 +96002,34 @@ function waitForTxn(params3) {
       const lastUpdateAt = Number.isFinite(lastUpdateAtRaw) && lastUpdateAtRaw > 0 ? Math.floor(lastUpdateAtRaw) : 0;
       if (isDone7) {
         if (isSuccess5) {
+          const mappingIncomplete = expectedMappings > 0 && idMap.length < expectedMappings;
+          if (mappingIncomplete) {
+            if (Date.now() < deadline) {
+              yield* sleep4(millis(resolvedPollMs));
+              continue;
+            }
+            return yield* fail8(new CliError({
+              code: "TXN_TIMEOUT",
+              message: `Timed out waiting for id_map to reach ${expectedMappings} entries`,
+              exitCode: 1,
+              details: {
+                txn_id: String(txnRow.txn_id ?? params3.txnId),
+                status: status2,
+                expected_id_map_count: expectedMappings,
+                ops_total: opsTotal,
+                ops_succeeded: opsSucceeded,
+                ops_dead: opsDead,
+                score,
+                elapsed_ms: Date.now() - startedAt,
+                last_update_at: lastUpdateAt || undefined,
+                id_map: idMap
+              },
+              hint: [
+                `agent-remnote queue inspect --txn ${String(txnRow.txn_id ?? params3.txnId)}`,
+                `agent-remnote queue wait --txn ${String(txnRow.txn_id ?? params3.txnId)} --timeout-ms ${resolvedTimeoutMs + resolvedPollMs}`
+              ]
+            }));
+          }
           const data = {
             txn_id: String(txnRow.txn_id ?? params3.txnId),
             status: status2,
@@ -95479,9 +96040,10 @@ function waitForTxn(params3) {
             ops_in_flight: opsInFlight,
             score,
             is_done: true,
-            is_success: true,
+            is_success: !mappingIncomplete,
             elapsed_ms: Date.now() - startedAt,
-            last_update_at: lastUpdateAt || undefined
+            last_update_at: lastUpdateAt || undefined,
+            id_map: idMap
           };
           return data;
         }
@@ -95500,7 +96062,8 @@ function waitForTxn(params3) {
             ops_pending: opsPending,
             score,
             elapsed_ms: Date.now() - startedAt,
-            last_update_at: lastUpdateAt || undefined
+            last_update_at: lastUpdateAt || undefined,
+            id_map: idMap
           },
           hint: [
             `agent-remnote queue inspect --txn ${String(txnRow.txn_id ?? params3.txnId)}`,
@@ -95525,7 +96088,8 @@ function waitForTxn(params3) {
             ops_pending: opsPending,
             score,
             elapsed_ms: Date.now() - startedAt,
-            last_update_at: lastUpdateAt || undefined
+            last_update_at: lastUpdateAt || undefined,
+            id_map: idMap
           },
           hint: [
             `agent-remnote queue progress --txn ${String(txnRow.txn_id ?? params3.txnId)}`,
@@ -95541,81 +96105,6 @@ function waitForTxn(params3) {
   });
 }
 
-// src/lib/text.ts
-function trimBoundaryBlankLines(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(`
-`);
-}
-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_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
 function clampInt3(value8, min5, max7) {
   if (!Number.isFinite(value8))
@@ -95787,7 +96276,9 @@ function simplifyOutlineTree(nodes) {
   return nodes.map((node) => ({
     id: node.id,
     depth: node.depth,
+    kind: node.kind,
     text: node.text,
+    target: node.target ?? null,
     references: Array.isArray(node.references) ? node.references : []
   }));
 }
@@ -96624,168 +97115,112 @@ var dbBackupsCommand = exports_Command.make("backups", { basePath, limit }, ({ b
 function optionToUndefined13(opt) {
   return isSome2(opt) ? opt.value : undefined;
 }
-function pad2(n) {
-  return String(n).padStart(2, "0");
-}
-function msToLocalStr(ms) {
-  const d = new Date(ms);
-  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())} ${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}`;
-}
-function cleanTitle(input) {
-  if (typeof input !== "string")
-    return "";
-  return input.split(/\s+/).join(" ").trim();
-}
-function asInt(value8) {
-  const n = typeof value8 === "number" ? value8 : typeof value8 === "string" ? Number(value8) : 0;
-  return Number.isFinite(n) ? n : 0;
-}
 function clampInt4(value8, min5, max7) {
   if (!Number.isFinite(value8))
     return min5;
-  return Math.max(min5, Math.min(max7, value8));
+  return Math.max(min5, Math.min(max7, Math.floor(value8)));
 }
-function scalar(db, sql, params3) {
-  const row = db.prepare(sql).get(...params3);
-  return asInt(row?.c ?? row?.count ?? row?.["count(*)"]);
+function formatCounts(counts) {
+  return `total=${counts.total}, created=${counts.created}, modified_existing=${counts.modified_existing}`;
+}
+function assertTimezoneInput(timezone) {
+  const effective = timezone.trim();
+  new Intl.DateTimeFormat("en-CA", { timeZone: effective, year: "numeric", month: "2-digit", day: "2-digit" });
 }
 var days3 = integer7("days").pipe(optional5, map34(optionToUndefined13));
-var maxParents = integer7("max-parents").pipe(optional5, map34(optionToUndefined13));
-var perParent = integer7("per-parent").pipe(optional5, map34(optionToUndefined13));
+var kind = choice5("kind", ["all", "created", "modified_existing"]).pipe(optional5, map34(optionToUndefined13));
+var aggregate2 = choice5("aggregate", ["day", "parent"]).pipe(repeated5);
+var timezone = text9("timezone").pipe(optional5, map34(optionToUndefined13));
+var itemLimit = integer7("item-limit").pipe(optional5, map34(optionToUndefined13));
+var aggregateLimit = integer7("aggregate-limit").pipe(optional5, map34(optionToUndefined13));
 var dbRecentCommand = exports_Command.make("recent", {
   days: days3,
-  maxParents,
-  perParent,
-  noParentGroup: boolean8("no-parent-group")
-}, ({ days: days4, maxParents: maxParents2, perParent: perParent2, noParentGroup }) => gen2(function* () {
-  const d = clampInt4(days4 ?? 15, 1, 3650);
-  const maxP = clampInt4(maxParents2 ?? 20, 1, 500);
-  const perP = clampInt4(perParent2 ?? 10, 1, 500);
-  const cutoffMs = Date.now() - d * 86400 * 1000;
+  kind,
+  aggregate: aggregate2,
+  timezone,
+  itemLimit,
+  aggregateLimit
+}, ({ days: days4, kind: kind2, aggregate: aggregate3, timezone: timezone2, itemLimit: itemLimit2, aggregateLimit: aggregateLimit2 }) => gen2(function* () {
   const cfg = yield* AppConfig;
   const remDb = yield* RemDb;
-  const result = yield* remDb.withDb(cfg.remnoteDb, (db) => {
-    const counts = {
-      quanta_created: scalar(db, "select count(*) as c from quanta where json_extract(doc,'$.createdAt') >= ?", [
-        cutoffMs
-      ]),
-      quanta_touched: scalar(db, "select count(*) as c from quanta where json_extract(doc,'$.m') >= ?", [cutoffMs]),
-      rem_created: scalar(db, `
-              select count(*) as c
-              from quanta q
-              join remsSearchInfos r on r.id=q._id
-              where json_extract(q.doc,'$.createdAt') >= ?
-            `, [cutoffMs]),
-      rem_created_and_edited: scalar(db, `
-              select count(*) as c
-              from quanta q
-              join remsSearchInfos r on r.id=q._id
-              where json_extract(q.doc,'$.createdAt') >= ?
-                and json_extract(q.doc,'$.m') > json_extract(q.doc,'$.createdAt')
-            `, [cutoffMs]),
-      rem_modified_old: scalar(db, `
-              select count(*) as c
-              from quanta q
-              join remsSearchInfos r on r.id=q._id
-              where json_extract(q.doc,'$.m') >= ?
-                and json_extract(q.doc,'$.createdAt') < ?
-            `, [cutoffMs, cutoffMs])
-    };
-    const rows = db.prepare(`
-              select
-                q._id as id,
-                cast(json_extract(q.doc,'$.createdAt') as integer) as createdAt,
-                cast(json_extract(q.doc,'$.m') as integer) as updatedAt,
-                json_extract(r.doc,'$.r') as preview,
-                json_extract(q.doc,'$.parent') as parentId,
-                json_extract(pr.doc,'$.r') as parentPreview
-              from quanta q
-              join remsSearchInfos r on r.id=q._id
-              left join remsSearchInfos pr on pr.id = json_extract(q.doc,'$.parent')
-              where cast(json_extract(q.doc,'$.createdAt') as integer) >= ?
-              order by createdAt desc
-            `).all(cutoffMs);
-    const items = rows.map((row) => {
-      const createdAt = asInt(row.createdAt);
-      const updatedAt = asInt(row.updatedAt);
-      const preview = cleanTitle(row.preview) || "<no preview>";
-      const parentId = typeof row.parentId === "string" ? row.parentId : row.parentId ? String(row.parentId) : "";
-      const parentPreview = cleanTitle(row.parentPreview) || "<unknown parent>";
-      return {
-        id: String(row.id),
-        created_at: createdAt,
-        updated_at: updatedAt,
-        preview,
-        parent_id: parentId,
-        parent_preview: parentPreview,
-        edited_after_create: createdAt > 0 && updatedAt > createdAt
-      };
+  if (cfg.apiBaseUrl) {
+    return yield* fail8(new CliError({
+      code: "INVALID_ARGS",
+      message: "db recent is local-only when apiBaseUrl is configured",
+      exitCode: 2,
+      details: { apiBaseUrl: cfg.apiBaseUrl }
+    }));
+  }
+  const effectiveDays = clampInt4(days4 ?? 15, 1, 3650);
+  const effectiveKind = kind2 ?? "all";
+  const normalizedTimezone = timezone2?.trim();
+  const effectiveItemLimit = clampInt4(itemLimit2 ?? 50, 1, 500);
+  const effectiveAggregateLimit = clampInt4(aggregateLimit2 ?? 20, 1, 200);
+  const aggregateDimensions = Array.from(new Set(aggregate3));
+  if (timezone2 !== undefined) {
+    const timezoneCheck = try_3({
+      try: () => assertTimezoneInput(normalizedTimezone ?? ""),
+      catch: () => new CliError({
+        code: "INVALID_ARGS",
+        message: `Invalid timezone: ${timezone2}`,
+        exitCode: 2,
+        details: { timezone: timezone2 }
+      })
     });
-    return { counts, items };
-  });
-  const dbPath = result.info.dbPath;
-  const cutoffText = msToLocalStr(cutoffMs);
-  const header = [
-    `# RemNote Overview (last ${d} days)`,
-    ``,
-    `- db: \`${dbPath}\``,
-    `- cutoff: \`${cutoffText}\``,
-    `- rem (index): created \`${result.result.counts.rem_created}\`; created+edited \`${result.result.counts.rem_created_and_edited}\`; edited existing \`${result.result.counts.rem_modified_old}\``,
-    `- quanta (raw): createdAt>=cutoff \`${result.result.counts.quanta_created}\`; m>=cutoff \`${result.result.counts.quanta_touched}\``,
-    ``
-  ].join(`
-`);
-  const ids3 = [];
-  const mdLines = [header.trimEnd()];
-  if (result.result.items.length > 0) {
-    if (noParentGroup) {
-      mdLines.push("## New Rems (newest first)", "");
-      const take10 = Math.min(result.result.items.length, maxP * perP);
-      for (const row of result.result.items.slice(0, take10)) {
-        ids3.push(row.id);
-        const marker = row.edited_after_create ? " (edited after creation)" : "";
-        mdLines.push(`- \`${msToLocalStr(row.created_at)}\` ${row.preview} \`${row.id}\`${marker}`);
-      }
-    } else {
-      const groups = new Map;
-      for (const row of result.result.items) {
-        const key = row.parent_id;
-        const existing = groups.get(key);
-        if (existing) {
-          existing.items.push(row);
-        } else {
-          groups.set(key, { parent_id: key, parent_title: row.parent_preview, items: [row] });
-        }
-      }
-      const ordered = Array.from(groups.values()).sort((a, b) => {
-        const aMax = Math.max(...a.items.map((r) => r.created_at));
-        const bMax = Math.max(...b.items.map((r) => r.created_at));
-        return bMax - aMax;
-      }).slice(0, maxP);
-      mdLines.push(`## New Rems (grouped by parent, up to ${maxP} groups × ${perP} each)`, "");
-      for (const group4 of ordered) {
-        const items = [...group4.items].sort((a, b) => b.created_at - a.created_at);
-        mdLines.push(`### ${group4.parent_title} (${group4.items.length})`, "");
-        for (const row of items.slice(0, perP)) {
-          ids3.push(row.id);
-          const marker = row.edited_after_create ? " (edited after creation)" : "";
-          mdLines.push(`- \`${msToLocalStr(row.created_at)}\` ${row.preview} \`${row.id}\`${marker}`);
-        }
-        mdLines.push("");
-      }
-    }
+    yield* timezoneCheck;
   }
+  const effectiveTimezone = normalizedTimezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
+  const result = yield* remDb.withDb(cfg.remnoteDb, (db) => executeSummarizeRecentActivity(db, {
+    days: effectiveDays,
+    kind: effectiveKind,
+    aggregates: aggregateDimensions,
+    timezone: effectiveTimezone,
+    itemLimit: effectiveItemLimit,
+    aggregateLimit: effectiveAggregateLimit
+  }));
   const data = {
-    db_path: dbPath,
+    db_path: result.info.dbPath,
     resolution: result.info.source,
-    days: d,
-    cutoff_ms: cutoffMs,
+    days: result.result.days,
+    timezone: result.result.timezone,
+    kind: effectiveKind,
+    aggregate_dimensions: aggregateDimensions,
+    item_limit: effectiveItemLimit,
+    aggregate_limit: effectiveAggregateLimit,
+    cutoff_ms: result.result.cutoff_ms,
     counts: result.result.counts,
-    items: result.result.items
+    items: result.result.items,
+    aggregates: result.result.aggregates
   };
-  yield* writeSuccess({ data, ids: ids3, md: mdLines.join(`
+  const mdLines = [
+    `# Recent Activity (${effectiveDays}d)`,
+    "",
+    `- db: \`${result.info.dbPath}\``,
+    `- timezone: \`${result.result.timezone}\``,
+    `- kind: \`${effectiveKind}\``,
+    `- counts: ${formatCounts(result.result.counts)}`,
+    ""
+  ];
+  if (result.result.items.length > 0) {
+    mdLines.push("## Items", "");
+    for (const item of result.result.items) {
+      mdLines.push(`- [${item.activity_kind}] ${item.preview} \`${item.id}\``);
+    }
+    mdLines.push("");
+  }
+  if (result.result.aggregates.length > 0) {
+    mdLines.push("## Aggregates", "");
+    for (const entry of result.result.aggregates) {
+      mdLines.push(`- ${entry.dimension}:${entry.key} (${formatCounts(entry.counts)})`);
+    }
+  }
+  yield* writeSuccess({
+    data,
+    ids: result.result.items.map((item) => item.id),
+    md: mdLines.join(`
 `).trimEnd() + `
-` });
+`
+  });
 }).pipe(catchAll2(writeFailure)));
 
 // src/commands/read/db/index.ts
@@ -96816,7 +97251,7 @@ var backupCleanupCommand = exports_Command.make("cleanup", {
   backupRemId,
   maxDeleteSubtreeNodes,
   state,
-  kind,
+  kind: kind2,
   olderThanHours,
   limit: limit2,
   wait: wait2,
@@ -96871,7 +97306,7 @@ var backupCleanupCommand = exports_Command.make("cleanup", {
     const states = state.length > 0 ? state : backupRemId ? [] : ["orphan"];
     const items = listBackupArtifacts(db, {
       states,
-      kinds: kind,
+      kinds: kind2,
       backupRemId,
       olderThanHours,
       limit: limit2
@@ -96946,7 +97381,7 @@ var backupListCommand = exports_Command.make("list", {
   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* () {
+}, ({ state, kind: kind2, olderThanHours, limit: limit2 }) => gen2(function* () {
   if (olderThanHours !== undefined && olderThanHours < 0) {
     return yield* fail8(new CliError({
       code: "INVALID_ARGS",
@@ -96970,7 +97405,7 @@ var backupListCommand = exports_Command.make("list", {
   try {
     const items = listBackupArtifacts(db, {
       states: state,
-      kinds: kind,
+      kinds: kind2,
       olderThanHours,
       limit: limit2
     });
@@ -97125,8 +97560,9 @@ var applyCommand = exports_Command.make("apply", {
   const hostApi = yield* HostApiClient;
   const payloadSvc = yield* Payload;
   const raw4 = yield* payloadSvc.readJson(payload);
+  const expanded = yield* normalizeAndExpandApplyEnvelope(raw4);
   const parsed = yield* try_3({
-    try: () => parseApplyEnvelope(payloadSvc.normalizeKeys(raw4)),
+    try: () => parseApplyEnvelope(expanded),
     catch: (error4) => isCliError(error4) ? error4 : new CliError({
       code: "INVALID_PAYLOAD",
       message: String(error4?.message || "Invalid apply envelope"),
@@ -97158,7 +97594,7 @@ var applyCommand = exports_Command.make("apply", {
   const data = cfg.apiBaseUrl ? yield* hostApi.writeApply({
     baseUrl: cfg.apiBaseUrl,
     body: {
-      ...raw4,
+      ...expanded,
       priority: resolvedPriority,
       clientId: resolvedClientId,
       idempotencyKey: resolvedIdempotencyKey,
@@ -97173,7 +97609,7 @@ var applyCommand = exports_Command.make("apply", {
     yield* validateOptionMutationOps({ scopeLabel: "generic", ops: compiled.ops });
     return yield* executeWriteApplyUseCase({
       raw: {
-        ...raw4,
+        ...expanded,
         priority: resolvedPriority,
         clientId: resolvedClientId,
         idempotencyKey: resolvedIdempotencyKey,
@@ -97186,7 +97622,7 @@ var applyCommand = exports_Command.make("apply", {
       pollMs: pollMs3
     });
   });
-  const out = compiled.kind === "actions" ? { ...data, alias_map: compiled.aliasMap } : data;
+  const out = compiled.kind === "actions" ? { ...data, alias_map: data?.alias_map ?? compiled.aliasMap } : data;
   yield* writeSuccess({
     data: out,
     ids: [data.txn_id, ...data.op_ids],
@@ -98554,7 +98990,7 @@ var readSelectionSnapshotCommand = exports_Command.make("snapshot", { stateFile:
   const hostApi = yield* HostApiClient;
   const snapshot2 = cfg.apiBaseUrl ? yield* hostApi.selectionSnapshot({ baseUrl: cfg.apiBaseUrl, stateFile: stateFile13, staleMs: staleMs6 }) : loadBridgeSelectionSnapshot({ stateFile: stateFile13, staleMs: staleMs6 });
   const selection = snapshot2.selection;
-  const kind = selection?.kind ?? "none";
+  const kind2 = selection?.kind ?? "none";
   const selectionType = selection && "selectionType" in selection ? selection.selectionType ?? "" : "";
   let selected = 0;
   let roots2 = 0;
@@ -98574,14 +99010,14 @@ var readSelectionSnapshotCommand = exports_Command.make("snapshot", { stateFile:
   }
   const md = [
     `- status: ${snapshot2.status}`,
-    `- kind: ${kind}`,
+    `- kind: ${kind2}`,
     `- selected: ${selected}`,
     `- roots: ${roots2}`,
     selectionType ? `- selection_type: ${selectionType}` : "",
-    kind === "rem" ? `- truncated: ${truncated ? "true" : "false"}` : "",
-    kind === "text" ? `- rem_id: ${textRemId}` : "",
-    kind === "text" ? `- range: ${textRange}` : "",
-    kind === "text" ? `- is_reverse: ${textIsReverse ? "true" : "false"}` : "",
+    kind2 === "rem" ? `- truncated: ${truncated ? "true" : "false"}` : "",
+    kind2 === "text" ? `- rem_id: ${textRemId}` : "",
+    kind2 === "text" ? `- range: ${textRange}` : "",
+    kind2 === "text" ? `- is_reverse: ${textIsReverse ? "true" : "false"}` : "",
     `- clients: ${snapshot2.clients}`,
     `- state_file: ${snapshot2.state_file}`,
     `- updated_at: ${snapshot2.updatedAt || ""}`,
@@ -98706,7 +99142,7 @@ var readUiContextDescribeCommand = exports_Command.make("describe", { stateFile:
   const pageRemId = normalizeText4(ui?.pageRemId);
   const focusedPortalId = normalizeText4(ui?.focusedPortalId);
   const focusedRemId = normalizeText4(ui?.focusedRemId);
-  const kind = computePortalKind2(pageRemId, focusedPortalId);
+  const kind2 = computePortalKind2(pageRemId, focusedPortalId);
   const selectionKind = selection?.kind ?? "none";
   const selectionIds = uniqueNonEmpty2(selection?.kind === "rem" ? selection.remIds.map(String) : []);
   const selectionTotalCountRaw = selection?.kind === "rem" ? Number(selection.totalCount ?? 0) : selection?.kind === "text" ? 1 : 0;
@@ -98742,12 +99178,12 @@ var readUiContextDescribeCommand = exports_Command.make("describe", { stateFile:
     return mapOrError;
   });
   const pageTitle = pageRemId ? titles.get(pageRemId) || "" : "";
-  const portalEffectiveId = kind === "page" ? pageRemId || focusedPortalId : focusedPortalId;
-  const portalTitle = kind === "page" ? pageRemId ? titles.get(pageRemId) || "" : "" : focusedPortalId ? titles.get(focusedPortalId) || "" : "";
+  const portalEffectiveId = kind2 === "page" ? pageRemId || focusedPortalId : focusedPortalId;
+  const portalTitle = kind2 === "page" ? pageRemId ? titles.get(pageRemId) || "" : "" : focusedPortalId ? titles.get(focusedPortalId) || "" : "";
   const portalContent = (() => {
     const parts2 = [];
-    if (kind !== "unknown")
-      parts2.push(`(${kind})`);
+    if (kind2 !== "unknown")
+      parts2.push(`(${kind2})`);
     if (portalTitle)
       parts2.push(portalTitle);
     const idToken = formatIdToken(portalEffectiveId);
@@ -98831,7 +99267,7 @@ var readUiContextDescribeCommand = exports_Command.make("describe", { stateFile:
       title: anchorTitle || undefined
     },
     portal: {
-      kind,
+      kind: kind2,
       id: portalEffectiveId,
       title: portalTitle || undefined
     },
@@ -100585,8 +101021,8 @@ function compileTableValueOps(params3) {
     const item = params3.values[i];
     const propertyId = resolvePropertyId(item, params3.properties);
     const prop = resolvePropertyDef(propertyId, params3.properties);
-    const kind = prop?.kind ?? "unknown";
-    switch (kind) {
+    const kind2 = prop?.kind ?? "unknown";
+    switch (kind2) {
       case "select": {
         const ids3 = resolveOptionIds(coerceSelectInput(item.value), prop);
         const payload = {
@@ -102805,12 +103241,16 @@ var writeRemCreateCommand = exports_Command.make("create", {
   });
   const waited = wait3 ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs4, pollMs: pollMs3 }) : null;
   const queue = yield* Queue;
-  const created = waited && waited.is_success === true ? yield* queue.inspect({ dbPath: cfg.storeDb, txnId: data.txn_id }).pipe(map17((inspected) => {
-    const idMap = Array.isArray(inspected?.id_map) ? inspected.id_map : [];
+  const created = waited && waited.is_success === true ? yield* gen2(function* () {
+    let idMap = Array.isArray(waited?.id_map) ? waited.id_map : [];
+    if (idMap.length === 0) {
+      const inspected = yield* queue.inspect({ dbPath: cfg.storeDb, txnId: data.txn_id }).pipe(catchAll2(() => succeed8({ id_map: [] })));
+      idMap = Array.isArray(inspected?.id_map) ? inspected.id_map : [];
+    }
     const match24 = idMap.find((r) => String(r?.client_temp_id ?? "") === remClientTempId);
     const remoteId = match24?.remote_id ? String(match24.remote_id) : "";
-    return remoteId ? { rem_id: remoteId } : {};
-  }), catchAll2(() => succeed8({}))) : {};
+    return remoteId ? { rem_id: remoteId, id_map: idMap } : { id_map: idMap };
+  }) : {};
   const out = waited ? { ...data, ...waited, rem_client_temp_id: remClientTempId, ...created } : { ...data, rem_client_temp_id: remClientTempId };
   yield* writeSuccess({
     data: out,
@@ -106494,12 +106934,16 @@ var writePortalCreateCommand = exports_Command.make("create", {
   });
   const waited = wait5 ? yield* waitForTxn({ txnId: data.txn_id, timeoutMs: timeoutMs7, pollMs: pollMs5 }) : null;
   const queue = yield* Queue;
-  const created = waited && waited.is_success === true ? yield* queue.inspect({ dbPath: cfg.storeDb, txnId: data.txn_id }).pipe(map17((inspected) => {
-    const idMap = Array.isArray(inspected?.id_map) ? inspected.id_map : [];
+  const created = waited && waited.is_success === true ? yield* gen2(function* () {
+    let idMap = Array.isArray(waited?.id_map) ? waited.id_map : [];
+    if (idMap.length === 0) {
+      const inspected = yield* queue.inspect({ dbPath: cfg.storeDb, txnId: data.txn_id }).pipe(catchAll2(() => succeed8({ id_map: [] })));
+      idMap = Array.isArray(inspected?.id_map) ? inspected.id_map : [];
+    }
     const match24 = idMap.find((r) => String(r?.client_temp_id ?? "") === portalClientTempId);
     const remoteId = match24?.remote_id ? String(match24.remote_id) : "";
-    return remoteId ? { portal_rem_id: remoteId } : {};
-  }), catchAll2(() => succeed8({}))) : {};
+    return remoteId ? { portal_rem_id: remoteId, id_map: idMap } : { id_map: idMap };
+  }) : {};
   const out = waited ? { ...data, ...waited, portal_client_temp_id: portalClientTempId, ...created } : { ...data, portal_client_temp_id: portalClientTempId };
   yield* writeSuccess({
     data: out,