@withandeo/cli 0.19.20 → 0.19.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withandeo/cli",
-  "version": "0.19.20",
+  "version": "0.19.21",
   "description": "Developer CLI for Andeo applications",
   "type": "module",
   "license": "UNLICENSED",

package/skill/{tender-accounts → andeo}/references/managed-source.md

@@ -87,6 +87,16 @@ scr_... --idempotency-key KEY`, then `resume`, for the same retained inputs.
 `source change cancel` withdraws new work; issued effects require readback and
 may remain `cancellation_pending`. It cannot undo a merge or deployment.
 
+For persistent agents, completed preview evidence and permission to execute a
+preview build have separate lifetimes. The hosted merge preflight can consume
+the same run's ready, unchanged preview after its build lease expires; current
+merge authority, exact source and preview policy must still pass. This never
+renews build authority. Dry-run checks the same preview evidence. Inspect the
+returned reason and next action for `source_merge_preview_required` or
+`agent_effect_authority_changed`; changing idempotency keys cannot repair lost
+authority or invalid validation evidence. Lease duration is a server policy,
+not a per-preview CLI option.
+
 ## Administrator-authorized source-only merges
 
 Use this mode only when a current administrator has explicitly selected
@@ -305,6 +315,22 @@ Source landing never calls the production publisher directly;
 after landing, the repository's already configured default-branch policy may
 publish the same artifact after its exact preview and production validation succeed.
 
+To correct review metadata, read `snapshotVersion` from `source change show`
+and edit the existing open change.
+
+```sh
+andeo source change edit --change scr_... --expected-snapshot 3 \
+  --title "Clarify the account copy update" --description "Includes the empty state." --json
+```
+
+Supply either field or both. Omitted fields keep their current values, and
+`--description ''` clears the description. An actual edit creates a new
+snapshot and preserves the change ID, number, and exact preview. A prior
+approval must be renewed. An identical edit with the current snapshot leaves
+the review unchanged. If the snapshot is stale, read it again and verify the
+current review before retrying. Persistent agents need `review.prepare` for
+their assigned feature branch.
+
 Treat source administration and production publication as different acts. A
 source operation may create a new immutable preview lineage, but only the
 merchant's saved policy or explicit publication approval can authorize production. Portal and gateway remain independent apps: configure variables, policy and delivery for each. Do not imply that two repository refs or apps publish atomically.

package/skill/publication.json

@@ -1,3 +1,3 @@
 {
-  "minimumCliVersion": "0.19.20"
+  "minimumCliVersion": "0.19.21"
 }