mureo_state_action_log_append

Added value: +{
+  "description": "The evaluation table — pass the ``evaluation`` object ``mureo_outcome_evaluate`` returned, unchanged. Required with ``evaluation_of`` (evaluation_required) and refused without it (evaluation_without_target). Its shape is checked; it is stored where the automatic closure stores its table, so ops history shows the verdict, and the record's ``summary`` is built from it (a passed one is replaced).",
+  "type": "object"
+}

Previous value: -"Positional index (into the full action_log) of the action whose ``observation_due`` this entry evaluates and CLOSES. Append this after running ``mureo_outcome_evaluate`` on a past-due observation so the source entry leaves the pending set (``mureo_outcome_evaluate`` is pure and records nothing itself). Must point at an existing entry — the daily-check's pending scope reads the returned ``index`` field to fill it."New value: +"Positional index (into the full action_log) of the action whose ``observation_due`` this entry evaluates and CLOSES. Append this after running ``mureo_outcome_evaluate`` with the same ``evaluation_of`` on a past-due observation so the source entry leaves the pending set (``mureo_outcome_evaluate`` is pure and records nothing itself). Must point at an existing entry — the daily-check's pending scope reads the returned ``index`` field to fill it. Requires ``evaluation``. The record's ``decision_id`` is the evaluated entry's, whatever is passed."

Previous value: -"What the recorded change should move (e.g. [{\"metric\": \"cpa\", \"direction\": \"down\"}]). With reason, mureo writes the decision record for this change and links the entry to it. Required with reason when ops history is enabled and the entry opens a new decision."New value: +"What the recorded change should move (e.g. [{\"metric\": \"cpa\", \"direction\": \"down\"}]). With several effects, mark exactly one \"primary\": true — the verdict is read off it. With reason, mureo writes the decision record for this change and links the entry to it. Required with reason when ops history is enabled and the entry opens a new decision."

Added value: +{
+  "description": "The effect the verdict is read off. One effect is primary by itself; with several, mark exactly one.",
+  "type": "boolean"
+}

Added value: +"Baseline metrics. Omit on a campaign change to fill it from that campaign's STATE.json snapshot."

Added value: +{
+  "additionalProperties": false,
+  "description": "Optional. An external approval this change carried out (recorded and shown, never verified).",
+  "properties": {
+    "approved_at": {
+      "maxLength": 64,
+      "type": "string"
+    },
+    "approved_by": {
+      "maxLength": 80,
+      "type": "string"
+    },
+    "reference": {
+      "maxLength": 128,
+      "type": "string"
+    }
+  },
+  "required": [
+    "reference",
+    "approved_by",
+    "approved_at"
+  ],
+  "type": "object"
+}

Previous value: -"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields), display_title / display_summary — the one line the dashboard shows for this entry — and reason — WHY the change was made, which only this call can supply (see the field)."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields), display_title / display_summary — the one line the dashboard shows for this entry — and reason — WHY the change was made, which only this call can supply (see the field). Ops history: expected (what the change should move) and decision_id (an earlier proposal it carried out)."

Added value: +{
+  "description": "Optional. The decision_id of an earlier proposed or adopted decision this change carried out; a proposal becomes adopted. Omit it otherwise — mureo creates the decision itself.",
+  "maxLength": 128,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "What the recorded change should move (e.g. [{\"metric\": \"cpa\", \"direction\": \"down\"}]). With reason, mureo writes the decision record for this change and links the entry to it. Required with reason when ops history is enabled and the entry opens a new decision.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "direction": {
+        "enum": [
+          "up",
+          "down",
+          "hold"
+        ],
+        "type": "string"
+      },
+      "horizon_days": {
+        "maximum": 365,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "metric": {
+        "enum": [
+          "cpa",
+          "cpc",
+          "cpl",
+          "cpm",
+          "conversions",
+          "cvr",
+          "ctr",
+          "roas",
+          "cost",
+          "spend",
+          "clicks",
+          "impressions"
+        ],
+        "type": "string"
+      },
+      "target": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "metric",
+      "direction"
+    ],
+    "type": "object"
+  },
+  "maxItems": 12,
+  "type": "array"
+}

Previous value: -"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields), and display_title / display_summary — the one line the dashboard shows for this entry."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields), display_title / display_summary — the one line the dashboard shows for this entry — and reason — WHY the change was made, which only this call can supply (see the field)."

Added value: +{
+  "description": "WHY this change was made — one or two sentences naming the evidence and the expected effect. SET IT whenever the change you are recording had a reason: unlike every other mutating tool, this one takes no call-level ``reason``, because it RECORDS a change rather than making one, so this field is the only place the rationale can go. Leave it out only for an entry that genuinely had none. Refused rather than truncated when over the bound.",
+  "maxLength": 500,
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), and the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields)."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields), and display_title / display_summary — the one line the dashboard shows for this entry."

Added value: +{
+  "description": "One sentence under the title, still for the operator. Plain text — no markdown: ``**bold**`` is shown to a person as asterisks. Keep the full reasoning in ``summary``, which nothing here shortens. ``display_title`` and ``display_summary`` are the ONE LINE the dashboard shows for this entry: title at most 40 characters, summary at most 120. Over either bound the append is refused, never truncated. They do not replace ``summary`` — write that as fully as the next agent needs; these two are what an operator reads at a glance.",
+  "maxLength": 120,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "What this action WAS, in a few words an operator reads on a dashboard row — 'Paused two losing ad groups'. ``display_title`` and ``display_summary`` are the ONE LINE the dashboard shows for this entry: title at most 40 characters, summary at most 120. Over either bound the append is refused, never truncated. They do not replace ``summary`` — write that as fully as the next agent needs; these two are what an operator reads at a glance.",
+  "maxLength": 40,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +[
+  "origin"
+]

Previous value: -"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of, batch_id (normally stamped by the server — see the field), and the provenance trio origin / external_id / occurred_at for a change mureo did NOT make (see those fields)."

Added value: +{
+  "description": "Normally OMIT this. While a batch is open (mureo_batch_begin) the server stamps the entry with it automatically, so a bulk pass groups itself. Supplying it is an explicit ASSERTION that this entry belongs to that batch, and it is validated: the id must name a declared batch that is still open. An unknown id, or one whose batch has been closed, is REFUSED — membership cannot be invented, and a closed batch's reported member count cannot be made false after the fact. To group imported or backfilled history, open a batch for the import rather than reattaching to an old one.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "The change feed's own identifier for an external change, so recording it twice is a no-op. Requires origin='external'. Namespace it with the platform key (e.g. 'tiktok_ads|<change id>'). Omit only when the feed exposes no id — the entry is then recorded, but a later pass cannot recognise it and will record it again.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "ISO 8601 time the PLATFORM says the change happened — history, never 'now'. Unlike ``timestamp`` (which the server always stamps) this is accepted, because the change's own date is not something the server can know. The observation window anchors on it, so a change made two weeks ago is already due for review rather than due in a fortnight.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "OMIT for anything mureo did — that is what an absent origin means. Set 'external' ONLY for a change mureo did not make, which you read out of a platform's own change history (typically a hosted connector mureo cannot poll itself; native and plugin platforms are covered by mureo_external_changes_import). An external entry is permanently marked as observed rather than performed: mureo will refuse to plan a rollback for it, because it never saw the prior value. Never use it to record a change you made through mureo.",
+  "enum": [
+    "external"
+  ],
+  "type": "string"
+}

Added value: +{
+  "entity_id": [
+    "entity_type"
+  ],
+  "entity_type": [
+    "entity_id"
+  ]
+}

Previous value: -"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, entity_type, entity_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of."

Added value: +{
+  "description": "Platform id of the entity_type target. Record the pair so a later run can avoid repeating a change to that same entity.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Generic target kind for a sub-campaign action, such as ad_group, ad_set, or placement. Use together with entity_id.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +false

Previous value: -"An action_log entry. Required: timestamp (ISO 8601), action (short description), platform (google_ads / meta_ads / etc.). Optional: campaign_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of."New value: +"An action_log entry. Required: action (short description), platform (google_ads / meta_ads / etc.). The ``timestamp`` is stamped by the server — do not compute it. Optional: campaign_id, ad_id, summary, command, metrics_at_action, observation_due, reversible_params, rollback_of, evaluation_of."

Added value: +{
+  "description": "The ad this action targeted, for ad-level actions (pause / enable / creative swap). Record it so a later run can tell an ad mureo stopped from one an operator stopped by hand.",
+  "type": "string"
+}

Added value: +{
+  "description": "Positional index (into the full action_log) of the action whose ``observation_due`` this entry evaluates and CLOSES. Append this after running ``mureo_outcome_evaluate`` on a past-due observation so the source entry leaves the pending set (``mureo_outcome_evaluate`` is pure and records nothing itself). Must point at an existing entry — the daily-check's pending scope reads the returned ``index`` field to fill it.",
+  "type": "integer"
+}

Added value: +"Positional index (into the full action_log) of the action this entry reverses. Normally written by the rollback surface (``rollback_apply``), not by hand. Must point at an existing entry."

Added value: +"IGNORED — the server stamps the entry with its own clock (ISO 8601 with UTC offset). Accepted only for backward compatibility with existing callers; any value supplied here is discarded, so a drifted client date can never be persisted and later read back as evidence of 'today'."

Previous value: -[
-  "timestamp",
-  "action",
-  "platform"
-]New value: +[
+  "action",
+  "platform"
+]