agent-remnote 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -1,10 +1,46 @@
 # agent-remnote
 
-## 1.3.1
+## 1.4.0
+
+### Minor Changes
+
+- d5e52bc: Deliver Wave 1 command-mode parity for RemNote business commands.
+
+  This release introduces a shared `ModeParityRuntime` and executable command
+  contract registry so Wave 1 business commands keep the same business semantics
+  in local mode and remote mode when `apiBaseUrl` is configured.
+
+  Wave 1 parity now covers the current business command set, including:
+
+  - search and analytical read commands such as `search`, `rem outline`,
+    `daily rem-id`, `page-id`, `by-reference`, `references`, `resolve-ref`,
+    and `query`
+  - plugin/UI-context/selection commands such as `plugin current`,
+    `plugin search`, `plugin ui-context *`, and `plugin selection *`
+  - write commands such as `daily write`, `apply`, `queue wait`, `rem create`,
+    `rem move`, `portal create`, `rem replace`, `rem children *`,
+    `rem set-text`, `rem delete`, and tag operations
+
+  This release also:
+
+  - moves host-dependent business semantics such as ref resolution, placement,
+    selection interpretation, contiguous sibling range resolution, title
+    inference, and receipt normalization behind shared parity runtime layers
+  - adds host-backed routing for deferred write commands that compile `ops`,
+    preventing remote mode from silently enqueueing to the caller-side local
+    store
+  - defines `powerup todo *` as the canonical Todo command family while keeping
+    top-level `todo *` as a supported alias
+  - aligns the authoritative parity inventory, CLI/HTTP/SSoT docs, and spec
+    ledgers for the Wave 1 boundary
+  - expands command-level contract coverage and remote-first integration coverage,
+    including `/v1` and `/remnote/v1` base-path verification
+
+## 1.3.3
 
 ### Patch Changes
 
-- b3498cf: Fix `apply --payload` so nested `markdown` fields expand input-spec values like `@file`, `-`, and `@@literal`, and harden queue enqueue/wait behavior by making enqueue atomic to reduce CI and `--wait` flakiness.
+- ca915b7: Fix `apply --payload` so nested `markdown` fields expand input-spec values like `@file`, `-`, and `@@literal`, and harden queue enqueue/wait behavior by making enqueue atomic to reduce CI and `--wait` flakiness.
 
 ## 1.3.0
 

package/README.md

@@ -17,6 +17,24 @@ agent-remnote --json plugin current --compact
 agent-remnote plugin serve
 ```
 
+## Write surface
+
+Core write commands use the reset axes `subject / from / to / at / portal`.
+
+```bash
+agent-remnote --json rem create --at standalone --markdown @./note.md --title "Doc"
+agent-remnote --json rem move --subject "id:<remId>" --at "parent[0]:id:<parentId>" --portal in-place
+agent-remnote --json portal create --to "id:<targetRemId>" --at "after:id:<anchorRemId>"
+agent-remnote --json rem children append --subject "id:<parentRemId>" --markdown @./children.md
+agent-remnote --json tag add --tag "id:<tagRemId>" --to "id:<remId1>" --to "id:<remId2>"
+```
+
+Notes:
+
+- `rem create --from-selection --portal in-place` is the preferred original-slot backfill path.
+- repeated `--from ... --portal in-place` is an advanced path that requires one contiguous sibling range under one parent.
+- `tag add/remove` are relation writes. Repeated `--tag` and repeated `--to` expand as a cross-product, not pairwise.
+
 ## Remote mode
 
 Configure once in `~/.agent-remnote/config.json`:
@@ -44,6 +62,9 @@ agent-remnote search --query "keyword"
 agent-remnote plugin current --compact
 ```
 
+The authoritative inventory for parity-mandatory business commands lives in
+`docs/ssot/agent-remnote/runtime-mode-and-command-parity.md`.
+
 For local RemNote plugin loading, serve the embedded plugin artifacts at the default URL:
 
 ```bash

package/builtin-scenarios/catalog.json

@@ -0,0 +1,62 @@
+[
+  {
+    "id": "dn_recent_todos_to_today_move",
+    "kind": "scenario_package",
+    "title": "Recent DN todos to today (move)",
+    "summary": "Collect recent daily note todos and move them under the target daily note.",
+    "source": "builtin",
+    "owner": "agent-remnote",
+    "version": 1,
+    "package_path": "packages/agent-remnote/builtin-scenarios/packages/dn_recent_todos_to_today_move.json",
+    "package_id": "dn_recent_todos_to_today_move",
+    "package_version": 1,
+    "tags": ["daily-note", "todo", "move"],
+    "vars": [
+      {
+        "name": "source_scope",
+        "type": "scope",
+        "required": false,
+        "default": "daily:past-7d"
+      },
+      {
+        "name": "target_ref",
+        "type": "ref",
+        "required": false,
+        "default": "daily:today"
+      }
+    ],
+    "action_capabilities": ["rem.move"],
+    "remote_parity_required": true,
+    "review_status": "planned_namespace_pending_promotion"
+  },
+  {
+    "id": "dn_recent_todos_to_today_portal",
+    "kind": "scenario_package",
+    "title": "Recent DN todos to today (portal)",
+    "summary": "Collect recent daily note todos and portal them into the target daily note.",
+    "source": "builtin",
+    "owner": "agent-remnote",
+    "version": 1,
+    "package_path": "packages/agent-remnote/builtin-scenarios/packages/dn_recent_todos_to_today_portal.json",
+    "package_id": "dn_recent_todos_to_today_portal",
+    "package_version": 1,
+    "tags": ["daily-note", "todo", "portal"],
+    "vars": [
+      {
+        "name": "source_scope",
+        "type": "scope",
+        "required": false,
+        "default": "daily:past-7d"
+      },
+      {
+        "name": "target_ref",
+        "type": "ref",
+        "required": false,
+        "default": "daily:today"
+      }
+    ],
+    "action_capabilities": ["portal.create"],
+    "remote_parity_required": true,
+    "review_status": "planned_namespace_pending_promotion"
+  }
+]

package/builtin-scenarios/packages/dn_recent_todos_to_today_move.json

@@ -0,0 +1,85 @@
+{
+  "id": "dn_recent_todos_to_today_move",
+  "version": 1,
+  "meta": {
+    "title": "Recent DN todos to today (move)",
+    "owner": "agent-remnote",
+    "description": "Collect recent daily note todos and move them under the target daily note."
+  },
+  "vars": [
+    {
+      "name": "source_scope",
+      "type": "scope",
+      "required": false,
+      "default": "daily:past-7d",
+      "description": "Recent daily-note scope used to select Todo entries."
+    },
+    {
+      "name": "target_ref",
+      "type": "ref",
+      "required": false,
+      "default": "daily:today",
+      "description": "Target daily note that receives the selected Todo entries."
+    }
+  ],
+  "nodes": [
+    {
+      "id": "recent_todos",
+      "kind": "selector",
+      "selector_kind": "query",
+      "output_slots": ["selection"],
+      "input": {
+        "query": {
+          "version": 2,
+          "root": {
+            "type": "powerup",
+            "powerup": {
+              "by": "rcrt",
+              "value": "t"
+            }
+          },
+          "scope": {
+            "kind": "var",
+            "name": "source_scope"
+          },
+          "shape": {
+            "roots_only": true
+          }
+        }
+      }
+    },
+    {
+      "id": "move_to_today",
+      "kind": "action",
+      "depends_on": ["recent_todos"],
+      "output_slots": ["receipt", "durable_target"],
+      "command_id": "rem.move",
+      "input": {
+        "selection": {
+          "kind": "node_output",
+          "node": "recent_todos",
+          "output": "selection"
+        },
+        "target_ref": {
+          "kind": "var",
+          "name": "target_ref"
+        }
+      }
+    }
+  ],
+  "entry": ["recent_todos"],
+  "outputs": ["move_to_today"],
+  "policy": {
+    "wait": false,
+    "remote_parity_required": true,
+    "max_items": 200,
+    "idempotency": "selection_rem_ids",
+    "fallback_strategy": "allow_empty_selection"
+  },
+  "capabilities": {
+    "requires": {
+      "powerup_metadata": true,
+      "write_runtime": true
+    }
+  }
+}

package/builtin-scenarios/packages/dn_recent_todos_to_today_portal.json

@@ -0,0 +1,85 @@
+{
+  "id": "dn_recent_todos_to_today_portal",
+  "version": 1,
+  "meta": {
+    "title": "Recent DN todos to today (portal)",
+    "owner": "agent-remnote",
+    "description": "Collect recent daily note todos and portal them into the target daily note."
+  },
+  "vars": [
+    {
+      "name": "source_scope",
+      "type": "scope",
+      "required": false,
+      "default": "daily:past-7d",
+      "description": "Recent daily-note scope used to select Todo entries."
+    },
+    {
+      "name": "target_ref",
+      "type": "ref",
+      "required": false,
+      "default": "daily:today",
+      "description": "Target daily note that receives the selected Todo portals."
+    }
+  ],
+  "nodes": [
+    {
+      "id": "recent_todos",
+      "kind": "selector",
+      "selector_kind": "query",
+      "output_slots": ["selection"],
+      "input": {
+        "query": {
+          "version": 2,
+          "root": {
+            "type": "powerup",
+            "powerup": {
+              "by": "rcrt",
+              "value": "t"
+            }
+          },
+          "scope": {
+            "kind": "var",
+            "name": "source_scope"
+          },
+          "shape": {
+            "roots_only": true
+          }
+        }
+      }
+    },
+    {
+      "id": "portal_to_today",
+      "kind": "action",
+      "depends_on": ["recent_todos"],
+      "output_slots": ["receipt", "durable_target"],
+      "command_id": "portal.create",
+      "input": {
+        "selection": {
+          "kind": "node_output",
+          "node": "recent_todos",
+          "output": "selection"
+        },
+        "target_ref": {
+          "kind": "var",
+          "name": "target_ref"
+        }
+      }
+    }
+  ],
+  "entry": ["recent_todos"],
+  "outputs": ["portal_to_today"],
+  "policy": {
+    "wait": false,
+    "remote_parity_required": true,
+    "max_items": 200,
+    "idempotency": "selection_rem_ids",
+    "fallback_strategy": "allow_empty_selection"
+  },
+  "capabilities": {
+    "requires": {
+      "powerup_metadata": true,
+      "write_runtime": true
+    }
+  }
+}