npm - @audiofool/moondog - Versions diffs - 0.1.0 - Mend

@audiofool/moondog 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (109) hide show

package/README.md +125 -0
package/assets/brand/moondog-lunar-record/moondog-logo-1x1.png +0 -0
package/contracts/v1/capability-policy.schema.json +572 -0
package/contracts/v1/definitions.schema.json +365 -0
package/contracts/v1/library-track-observation.schema.json +138 -0
package/contracts/v1/listening-event.schema.json +111 -0
package/contracts/v1/profile-evidence.schema.json +237 -0
package/contracts/v1/taste-event.schema.json +258 -0
package/contracts/v1/tool-invocation.schema.json +318 -0
package/contracts/v1/tool-receipt.schema.json +1066 -0
package/contracts/v1/track-ref.schema.json +275 -0
package/contracts/v2/profile-evidence.schema.json +284 -0
package/package.json +105 -0
package/scripts/contract-lib.mjs +361 -0
package/scripts/contract-semantics.mjs +2630 -0
package/scripts/demo-studio.mjs +58 -0
package/scripts/moondog +52 -0
package/scripts/moondog.mjs +954 -0
package/src/core/apple-data-migration.mjs +50 -0
package/src/core/apple-library-source-status.mjs +220 -0
package/src/core/apple-projection-domain-services.mjs +2356 -0
package/src/core/capability-catalog.mjs +577 -0
package/src/core/listening-profile-domain-services.mjs +1010 -0
package/src/core/lyric-library.mjs +121 -0
package/src/core/lyric-profile.mjs +50 -0
package/src/core/lyric-service.mjs +41 -0
package/src/core/moondog-application.mjs +1827 -0
package/src/core/state-directory.mjs +19 -0
package/src/core/synthetic-domain-services.mjs +1485 -0
package/src/core/uuid-v5.mjs +42 -0
package/src/demo/fictional-spotify-history.mjs +400 -0
package/src/demo/moondog-demo.mjs +355 -0
package/src/demo/moondog-interactive-tasteprint-demo.mjs +293 -0
package/src/demo/moondog-tasteprint-demo.mjs +631 -0
package/src/importers/apple-music-library/import-batch.mjs +290 -0
package/src/importers/apple-music-library/index.mjs +76 -0
package/src/importers/apple-music-library/normalize.mjs +1126 -0
package/src/importers/apple-music-library/parse-plist.mjs +357 -0
package/src/importers/apple-music-library/projection-records.mjs +557 -0
package/src/importers/apple-music-library/read-batch.mjs +276 -0
package/src/importers/apple-music-library/sqlite-projection.mjs +1307 -0
package/src/importers/apple-music-library/stable-ids.mjs +19 -0
package/src/importers/apple-music-library/track-snapshot.schema.json +136 -0
package/src/integrations/apple-music/catalog.mjs +770 -0
package/src/integrations/cross-catalog-artist-identity.mjs +222 -0
package/src/integrations/listenbrainz/history-file.mjs +560 -0
package/src/integrations/lyrics/lrclib.mjs +55 -0
package/src/integrations/open-music-similarity/artist-radio.mjs +806 -0
package/src/integrations/public-playlists.mjs +104 -0
package/src/integrations/spotify/account-data-history.mjs +545 -0
package/src/integrations/spotify/account-data-profile.mjs +918 -0
package/src/integrations/spotify/authentication.mjs +791 -0
package/src/integrations/spotify/catalog-resolver.mjs +657 -0
package/src/integrations/spotify/connection.mjs +125 -0
package/src/integrations/spotify/credential-store.mjs +26 -0
package/src/integrations/spotify/extended-streaming-history.mjs +525 -0
package/src/integrations/spotify/history-archive.mjs +59 -0
package/src/integrations/spotify/index.mjs +80 -0
package/src/integrations/spotify/recent-activity.mjs +198 -0
package/src/integrations/spotify/resolution-cache.mjs +260 -0
package/src/integrations/spotify/service.mjs +713 -0
package/src/integrations/spotify/settings.mjs +89 -0
package/src/integrations/spotify/web-api-client.mjs +761 -0
package/src/integrations/web/codex-web.mjs +263 -0
package/src/integrations/youtube-music/takeout.mjs +143 -0
package/src/memory/local-memory-store.mjs +1705 -0
package/src/memory/reflection-worker.mjs +87 -0
package/src/profile/apple-library-import.mjs +28 -0
package/src/profile/history-import.mjs +163 -0
package/src/profile/listener-corrections.mjs +217 -0
package/src/profile/listening-history-store.mjs +2055 -0
package/src/profile/listening-profile-projection.mjs +2520 -0
package/src/profile/local-music-data.mjs +812 -0
package/src/profile/music-import-bundle.mjs +91 -0
package/src/profile/music-providers.mjs +25 -0
package/src/profile/spotify-archive-catalog-hints.mjs +210 -0
package/src/profile/spotify-archive-taste.mjs +482 -0
package/src/runtime/pi/agent-runtime.mjs +6444 -0
package/src/runtime/pi/authentication.mjs +104 -0
package/src/runtime/pi/configured-runtime.mjs +98 -0
package/src/runtime/pi/memory-agent-runtime.mjs +337 -0
package/src/runtime/pi/model-catalog.mjs +62 -0
package/src/runtime/pi/model-transport.mjs +117 -0
package/src/runtime/pi/persistent-credential-store.mjs +670 -0
package/src/runtime/pi/provider-registry.mjs +74 -0
package/src/runtime/pi/runtime-settings.mjs +81 -0
package/src/surfaces/cli/auth-command.mjs +355 -0
package/src/surfaces/cli/brand-components.mjs +390 -0
package/src/surfaces/cli/brand-theme.mjs +231 -0
package/src/surfaces/cli/catalog-command.mjs +509 -0
package/src/surfaces/cli/command-completions.mjs +113 -0
package/src/surfaces/cli/data-command.mjs +214 -0
package/src/surfaces/cli/format-output.mjs +750 -0
package/src/surfaces/cli/history-import-view.mjs +445 -0
package/src/surfaces/cli/import-guides.mjs +9 -0
package/src/surfaces/cli/listenbrainz-command.mjs +129 -0
package/src/surfaces/cli/listening-menu.mjs +171 -0
package/src/surfaces/cli/profile-command.mjs +290 -0
package/src/surfaces/cli/spotify-command.mjs +849 -0
package/src/surfaces/cli/taste-profile-model.mjs +306 -0
package/src/surfaces/cli/taste-profile-view.mjs +272 -0
package/src/surfaces/cli/terminal-art.mjs +295 -0
package/src/surfaces/cli/tui.mjs +1714 -0
package/src/surfaces/cli/web-command.mjs +52 -0
package/src/surfaces/html/tasteprint-artifact.mjs +96 -0
package/src/surfaces/html/tasteprint.mjs +3575 -0
package/src/surfaces/web/showcase.mjs +272 -0
package/src/surfaces/web/studio-page.mjs +4148 -0
package/src/surfaces/web/studio.mjs +2288 -0

package/contracts/v1/tool-receipt.schema.json ADDED Viewed

@@ -0,0 +1,1066 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:moondog:contract:tool-receipt:1",
+  "title": "Moondog ToolReceipt v1",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/schema_version"
+    },
+    "receipt_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "invocation_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "subject_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "capability_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/namespaced_key"
+    },
+    "capability_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "invocation_semantic_digest": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+    },
+    "attempt": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "status": {
+      "enum": [
+        "simulated",
+        "denied",
+        "awaiting_confirmation",
+        "accepted",
+        "succeeded",
+        "failed",
+        "timed_out",
+        "partial",
+        "unknown",
+        "cancelled",
+        "requires_human"
+      ]
+    },
+    "recorded_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "started_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "finished_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "policy_decision": {
+      "type": "object",
+      "properties": {
+        "decision": {
+          "enum": [
+            "allow",
+            "deny",
+            "require_confirmation",
+            "escalate"
+          ]
+        },
+        "policy_ref": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/policy_ref"
+        },
+        "capability_registry_version": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "reason_codes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/namespaced_key"
+          },
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "decision",
+        "policy_ref",
+        "capability_registry_version",
+        "reason_codes"
+      ],
+      "additionalProperties": false
+    },
+    "confirmation": {
+      "type": "object",
+      "properties": {
+        "grant_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+        },
+        "verified_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        },
+        "consumed_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        },
+        "scope_digest": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+        }
+      },
+      "required": [
+        "grant_id",
+        "verified_at",
+        "scope_digest"
+      ],
+      "additionalProperties": false
+    },
+    "idempotency": {
+      "type": "object",
+      "properties": {
+        "key_digest": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+        },
+        "semantic_digest": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+        },
+        "disposition": {
+          "enum": [
+            "new",
+            "replayed",
+            "conflict"
+          ]
+        }
+      },
+      "required": [
+        "key_digest",
+        "semantic_digest",
+        "disposition"
+      ],
+      "additionalProperties": false
+    },
+    "executor_ref": {
+      "type": "object",
+      "properties": {
+        "executor_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/namespaced_key"
+        },
+        "version": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "external_refs": {
+          "type": "array",
+          "items": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/external_ref"
+          },
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "executor_id",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "effects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "effect_type": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/effect_kind"
+          },
+          "resource_ref": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/entity_ref"
+          },
+          "status": {
+            "enum": [
+              "planned",
+              "applied",
+              "rolled_back",
+              "unknown"
+            ]
+          },
+          "reversible": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "effect_type",
+          "status",
+          "reversible"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "usage": {
+      "type": "array",
+      "items": {
+        "$ref": "urn:moondog:contract:definitions:1#/$defs/budget_amount"
+      },
+      "uniqueItems": true
+    },
+    "budget_reservation": {
+      "type": "object",
+      "properties": {
+        "reservation_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+        },
+        "state": {
+          "enum": [
+            "none",
+            "reserved",
+            "held",
+            "reconciled",
+            "released"
+          ]
+        },
+        "reserved": {
+          "type": "array",
+          "items": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/budget_amount"
+          },
+          "uniqueItems": true
+        },
+        "actual": {
+          "type": "array",
+          "items": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/budget_amount"
+          },
+          "uniqueItems": true
+        },
+        "recorded_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        },
+        "reconciled_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        }
+      },
+      "required": [
+        "state",
+        "reserved",
+        "actual",
+        "recorded_at"
+      ],
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "state": {
+                "const": "none"
+              }
+            },
+            "required": [
+              "state"
+            ]
+          },
+          "then": {
+            "properties": {
+              "reserved": {
+                "type": "array",
+                "maxItems": 0
+              },
+              "actual": {
+                "type": "array",
+                "maxItems": 0
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "reservation_id"
+                  ]
+                },
+                {
+                  "required": [
+                    "reconciled_at"
+                  ]
+                }
+              ]
+            }
+          },
+          "else": {
+            "required": [
+              "reservation_id"
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "state": {
+                "enum": [
+                  "reconciled",
+                  "released"
+                ]
+              }
+            },
+            "required": [
+              "state"
+            ]
+          },
+          "then": {
+            "required": [
+              "reconciled_at"
+            ]
+          }
+        }
+      ],
+      "additionalProperties": false
+    },
+    "privacy_egress": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "data_class": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/data_class"
+          },
+          "destination": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/external_destination"
+          },
+          "retained_until": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+          }
+        },
+        "required": [
+          "data_class",
+          "destination"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "$ref": "urn:moondog:contract:definitions:1#/$defs/artifact_ref"
+      },
+      "uniqueItems": true
+    },
+    "result_summary": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000,
+      "pattern": "\\S"
+    },
+    "error": {
+      "type": "object",
+      "properties": {
+        "category": {
+          "enum": [
+            "validation",
+            "authorization",
+            "policy",
+            "timeout",
+            "rate_limit",
+            "external_service",
+            "internal",
+            "unknown"
+          ]
+        },
+        "code": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/namespaced_key"
+        },
+        "safe_message": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "category",
+        "code",
+        "safe_message",
+        "retryable"
+      ],
+      "additionalProperties": false
+    },
+    "recovery": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "enum": [
+            "none",
+            "retry",
+            "reconcile",
+            "rollback",
+            "request_confirmation",
+            "human_handoff"
+          ]
+        },
+        "safe_summary": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        }
+      },
+      "required": [
+        "action",
+        "safe_summary"
+      ],
+      "additionalProperties": false
+    },
+    "deduplicated_from_receipt_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "extensions": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/extensions"
+    }
+  },
+  "required": [
+    "schema_version",
+    "receipt_id",
+    "invocation_id",
+    "subject_id",
+    "capability_id",
+    "capability_version",
+    "invocation_semantic_digest",
+    "attempt",
+    "status",
+    "recorded_at",
+    "policy_decision",
+    "effects",
+    "usage",
+    "budget_reservation",
+    "privacy_egress",
+    "artifacts"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "failed",
+              "timed_out",
+              "partial",
+              "unknown"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "error"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "denied"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "policy_decision": {
+            "type": "object",
+            "properties": {
+              "decision": {
+                "const": "deny"
+              }
+            }
+          },
+          "effects": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "usage": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "privacy_egress": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "artifacts": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "budget_reservation": {
+            "type": "object",
+            "properties": {
+              "state": {
+                "const": "none"
+              }
+            }
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "started_at"
+              ]
+            },
+            {
+              "required": [
+                "executor_ref"
+              ]
+            },
+            {
+              "properties": {
+                "confirmation": {
+                  "type": "object",
+                  "properties": {
+                    "consumed_at": {
+                      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+                    }
+                  },
+                  "required": [
+                    "consumed_at"
+                  ]
+                }
+              },
+              "required": [
+                "confirmation"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "awaiting_confirmation",
+              "requires_human"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "effects": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "usage": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "privacy_egress": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "budget_reservation": {
+            "type": "object",
+            "properties": {
+              "state": {
+                "const": "none"
+              }
+            }
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "started_at"
+              ]
+            },
+            {
+              "required": [
+                "executor_ref"
+              ]
+            },
+            {
+              "required": [
+                "idempotency"
+              ]
+            },
+            {
+              "properties": {
+                "confirmation": {
+                  "type": "object",
+                  "properties": {
+                    "consumed_at": {
+                      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+                    }
+                  },
+                  "required": [
+                    "consumed_at"
+                  ]
+                }
+              },
+              "required": [
+                "confirmation"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "denied"
+          },
+          "idempotency": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "status",
+          "idempotency"
+        ]
+      },
+      "then": {
+        "properties": {
+          "idempotency": {
+            "type": "object",
+            "properties": {
+              "disposition": {
+                "const": "conflict"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "awaiting_confirmation"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "recovery"
+        ],
+        "properties": {
+          "policy_decision": {
+            "type": "object",
+            "properties": {
+              "decision": {
+                "const": "require_confirmation"
+              }
+            }
+          },
+          "recovery": {
+            "type": "object",
+            "properties": {
+              "action": {
+                "const": "request_confirmation"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "requires_human"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "recovery"
+        ],
+        "properties": {
+          "policy_decision": {
+            "type": "object",
+            "properties": {
+              "decision": {
+                "const": "escalate"
+              }
+            }
+          },
+          "recovery": {
+            "type": "object",
+            "properties": {
+              "action": {
+                "const": "human_handoff"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "accepted",
+              "succeeded",
+              "failed",
+              "timed_out",
+              "partial",
+              "unknown"
+            ]
+          },
+          "confirmation": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "status",
+          "confirmation"
+        ]
+      },
+      "then": {
+        "properties": {
+          "confirmation": {
+            "type": "object",
+            "properties": {
+              "consumed_at": {
+                "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+              }
+            },
+            "required": [
+              "consumed_at"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "idempotency": {
+            "type": "object",
+            "properties": {
+              "disposition": {
+                "const": "conflict"
+              }
+            },
+            "required": [
+              "disposition"
+            ]
+          }
+        },
+        "required": [
+          "idempotency"
+        ]
+      },
+      "then": {
+        "properties": {
+          "status": {
+            "const": "denied"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "simulated"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "effects": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "const": "planned"
+                }
+              }
+            }
+          },
+          "usage": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "privacy_egress": {
+            "type": "array",
+            "maxItems": 0
+          },
+          "budget_reservation": {
+            "type": "object",
+            "properties": {
+              "state": {
+                "const": "none"
+              }
+            }
+          }
+        },
+        "not": {
+          "required": [
+            "executor_ref"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "accepted"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "effects": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "const": "planned"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "succeeded"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "effects": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "status": {
+                  "enum": [
+                    "applied",
+                    "rolled_back"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "error"
+              ]
+            },
+            {
+              "properties": {
+                "effects": {
+                  "type": "array",
+                  "contains": {
+                    "type": "object",
+                    "properties": {
+                      "status": {
+                        "const": "unknown"
+                      }
+                    },
+                    "required": [
+                      "status"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "effects"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "simulated",
+              "accepted",
+              "succeeded",
+              "failed",
+              "timed_out",
+              "partial",
+              "unknown",
+              "cancelled"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "properties": {
+          "policy_decision": {
+            "type": "object",
+            "properties": {
+              "decision": {
+                "const": "allow"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "effects": {
+            "type": "array",
+            "contains": {
+              "type": "object",
+              "properties": {
+                "effect_type": {
+                  "enum": [
+                    "write_local",
+                    "write_external",
+                    "send_message",
+                    "spend",
+                    "publish",
+                    "delete"
+                  ]
+                },
+                "status": {
+                  "const": "applied"
+                }
+              },
+              "required": [
+                "effect_type",
+                "status"
+              ]
+            }
+          }
+        },
+        "required": [
+          "effects"
+        ]
+      },
+      "then": {
+        "required": [
+          "executor_ref",
+          "idempotency"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "idempotency": {
+            "type": "object",
+            "properties": {
+              "disposition": {
+                "const": "replayed"
+              }
+            },
+            "required": [
+              "disposition"
+            ]
+          }
+        },
+        "required": [
+          "idempotency"
+        ]
+      },
+      "then": {
+        "required": [
+          "deduplicated_from_receipt_id"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "unknown"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "recovery"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "properties": {
+              "retryable": {
+                "const": false
+              }
+            }
+          },
+          "recovery": {
+            "type": "object",
+            "properties": {
+              "action": {
+                "enum": [
+                  "reconcile",
+                  "human_handoff"
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "simulated",
+              "denied",
+              "succeeded",
+              "failed",
+              "timed_out",
+              "partial",
+              "unknown",
+              "cancelled",
+              "requires_human"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "finished_at"
+        ]
+      }
+    }
+  ],
+  "additionalProperties": false
+}