@topy-ai/maggie 0.7.47 → 0.7.49

package/bundled-contracts/maggie-ops/notification-catalogue-v1.schema.json

@@ -0,0 +1,273 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggie.noblox.app/contracts/maggie-ops/notification-catalogue-v1.schema.json",
+  "title": "Maggie website notification catalogue v1",
+  "description": "Provider-neutral catalogue of every website email, in-app and SMS notification. Validated by `maggie ops notifications catalogue validate`, which also enforces cross-field rules (marketing consent/unsubscribe/queue, operations alerts on the operations queue, durable outbox for external lead email).",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "retention",
+    "entries"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "maggie-notification-catalogue.v1"
+    },
+    "project": {
+      "type": "string"
+    },
+    "retention": {
+      "type": "object",
+      "required": [
+        "webhook-payload",
+        "delivery-record",
+        "rendered-snapshot",
+        "template-variables"
+      ],
+      "properties": {
+        "webhook-payload": {
+          "type": "object",
+          "required": [
+            "days"
+          ],
+          "properties": {
+            "days": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "storeRawPayload": {
+              "type": "boolean"
+            },
+            "minimizedFields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "delivery-record": {
+          "type": "object",
+          "required": [
+            "days"
+          ],
+          "properties": {
+            "days": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "storeRawPayload": {
+              "type": "boolean"
+            },
+            "minimizedFields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "rendered-snapshot": {
+          "type": "object",
+          "required": [
+            "days"
+          ],
+          "properties": {
+            "days": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "storeRawPayload": {
+              "type": "boolean"
+            },
+            "minimizedFields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "template-variables": {
+          "type": "object",
+          "required": [
+            "days"
+          ],
+          "properties": {
+            "days": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "storeRawPayload": {
+              "type": "boolean"
+            },
+            "minimizedFields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "entries": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "alias",
+          "section",
+          "trigger",
+          "audience",
+          "category",
+          "consent",
+          "locales",
+          "variables",
+          "idempotencyKey",
+          "retentionDays",
+          "provider",
+          "channels",
+          "status",
+          "delivery",
+          "queue"
+        ],
+        "properties": {
+          "alias": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,99}$"
+          },
+          "section": {
+            "enum": [
+              "identity-security",
+              "account",
+              "business",
+              "billing",
+              "support",
+              "marketing",
+              "deliverability-ops"
+            ]
+          },
+          "trigger": {
+            "type": "string",
+            "minLength": 1
+          },
+          "audience": {
+            "enum": [
+              "visitor",
+              "user",
+              "merchant",
+              "team",
+              "operator"
+            ]
+          },
+          "category": {
+            "enum": [
+              "transactional",
+              "support",
+              "marketing"
+            ]
+          },
+          "consent": {
+            "enum": [
+              "not-required",
+              "opt-in-required",
+              "operator-only"
+            ]
+          },
+          "locales": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            }
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "variables": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$"
+            }
+          },
+          "cta": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "route": {
+                "type": "string"
+              }
+            }
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "pattern": "\\{"
+          },
+          "retentionDays": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "provider": {
+            "type": "string"
+          },
+          "channels": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "enum": [
+                "email",
+                "in-app",
+                "sms"
+              ]
+            }
+          },
+          "status": {
+            "enum": [
+              "implemented",
+              "provider-owned",
+              "reserved",
+              "missing"
+            ]
+          },
+          "delivery": {
+            "enum": [
+              "outbox",
+              "direct",
+              "provider"
+            ]
+          },
+          "queue": {
+            "enum": [
+              "user",
+              "operations",
+              "marketing"
+            ]
+          },
+          "lead": {
+            "type": "boolean"
+          },
+          "unsubscribe": {
+            "type": "boolean"
+          },
+          "frequency": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/bundled-contracts/maggie-service-booking/fact-provenance-v1.schema.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggie.noblox.app/contracts/service-fact-provenance-v1.json",
+  "title": "Maggie field-level provenance for imported business facts",
+  "description": "Per-field evidence from the user and from providers (Fresha, Google, website, ...). User-entered values are authoritative. Provider disagreement above policy.minConfidence becomes a needs-review conflict; a provider error is recorded and never blocks other sources. Merge with `maggie service fact-provenance`, which writes a maggie-service-fact-merge.v1 artifact for the host review UI.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "entityId",
+    "fields"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "maggie-service-fact-provenance.v1"
+    },
+    "entityId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "policy": {
+      "type": "object",
+      "properties": {
+        "precedence": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "prefixItems": [
+            {
+              "const": "user"
+            }
+          ],
+          "minItems": 1
+        },
+        "fieldPrecedence": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "prefixItems": [
+              {
+                "const": "user"
+              }
+            ],
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "minConfidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "fields": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "$ref": "#/$defs/field"
+      }
+    }
+  },
+  "$defs": {
+    "field": {
+      "type": "object",
+      "properties": {
+        "user": {
+          "type": [
+            "object",
+            "null"
+          ],
+          "required": [
+            "value"
+          ],
+          "properties": {
+            "value": {},
+            "at": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "actor": {
+              "type": "string"
+            }
+          }
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "source"
+            ],
+            "properties": {
+              "source": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_-]{0,39}$",
+                "not": {
+                  "const": "user"
+                }
+              },
+              "value": {},
+              "confidence": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1
+              },
+              "observedAt": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "sourceRef": {
+                "type": "string",
+                "description": "public page or record reference; never credentials"
+              },
+              "error": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/bundled-contracts/maggie-service-booking/import-stages-v1.schema.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggie.noblox.app/contracts/service-import-stages-v1.json",
+  "title": "Maggie provider-neutral multi-stage service import state",
+  "description": "One import runs source, enrichment, research and verification stages. Stage keys are idempotent and reused on retry; running stages heartbeat and become stale after staleAfterSeconds; downstream stages record the source revision they consumed so superseded (out-of-order) results are discarded; cancellation is propagated to every stage and late results are discarded. Validate with `maggie service import-stages-validate`.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "importId",
+    "idempotencyKey",
+    "state",
+    "staleAfterSeconds",
+    "stages"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "maggie-service-import-stages.v1"
+    },
+    "importId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
+    },
+    "provider": {
+      "type": "string"
+    },
+    "state": {
+      "enum": [
+        "queued",
+        "running",
+        "succeeded",
+        "partial",
+        "failed",
+        "cancelled",
+        "stale"
+      ]
+    },
+    "staleAfterSeconds": {
+      "type": "integer",
+      "minimum": 30,
+      "maximum": 86400
+    },
+    "evaluatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "nextAction": {
+      "type": "string",
+      "minLength": 1
+    },
+    "cancellation": {
+      "type": "object",
+      "properties": {
+        "requested": {
+          "type": "boolean"
+        },
+        "requestedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "propagated": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "stages": {
+      "type": "array",
+      "minItems": 4,
+      "maxItems": 4,
+      "items": {
+        "$ref": "#/$defs/stage"
+      }
+    }
+  },
+  "$defs": {
+    "stage": {
+      "type": "object",
+      "required": [
+        "name",
+        "stageKey",
+        "state",
+        "attempt",
+        "maxAttempts",
+        "progress"
+      ],
+      "properties": {
+        "name": {
+          "enum": [
+            "source",
+            "enrichment",
+            "research",
+            "verification"
+          ]
+        },
+        "stageKey": {
+          "type": "string",
+          "description": "<importId>:<stage>[:<input hash>]; reused on retry"
+        },
+        "dependsOn": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "source",
+              "enrichment",
+              "research",
+              "verification"
+            ]
+          },
+          "description": "defaults: enrichment/research -> source; verification -> enrichment, research"
+        },
+        "state": {
+          "enum": [
+            "queued",
+            "running",
+            "succeeded",
+            "failed",
+            "skipped",
+            "cancelled"
+          ]
+        },
+        "attempt": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "progress": {
+          "type": "object",
+          "required": [
+            "done",
+            "total"
+          ],
+          "properties": {
+            "done": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "total": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "heartbeatAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "completedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "resultRevision": {
+          "type": [
+            "string",
+            "integer"
+          ],
+          "description": "source stage: revision of its current result"
+        },
+        "inputRevision": {
+          "type": [
+            "string",
+            "integer"
+          ],
+          "description": "downstream stages: source revision consumed"
+        },
+        "resultDiscarded": {
+          "type": "boolean"
+        },
+        "errorCode": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/bundled-contracts/maggiedash/booking-browser-evidence-v1.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggiedash.topy.ai/contracts/booking-browser-evidence-v1.json",
+  "title": "MaggieDash Booking production browser evidence v1",
+  "type": "object",
+  "required": ["schemaVersion", "baseUrl", "generatedAt", "viewports", "screens", "consoleErrors", "failedRequests", "layoutErrors"],
+  "properties": {
+    "schemaVersion": { "const": "maggiedash-booking-browser-evidence.v1" },
+    "baseUrl": { "type": "string", "pattern": "^https://" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "version": { "type": "string" },
+    "viewports": { "type": "array", "minItems": 3, "items": { "type": "object", "required": ["name", "width", "height"] } },
+    "screens": { "type": "array", "minItems": 51, "items": { "type": "object", "required": ["route", "viewport", "httpStatus", "screenshot", "ready"] } },
+    "consoleErrors": { "type": "array", "items": { "type": "string" } },
+    "failedRequests": { "type": "array", "items": { "type": "string" } },
+    "layoutErrors": { "type": "array", "items": { "type": "string" } },
+    "notes": { "type": "array", "items": { "type": "string" } }
+  },
+  "x-required-routes": ["/_maggie/booking/", "/_maggie/booking/calendar", "/_maggie/booking/bookings", "/_maggie/booking/customers", "/_maggie/booking/waitlist", "/_maggie/booking/locations", "/_maggie/booking/catalog", "/_maggie/booking/packages", "/_maggie/booking/staff", "/_maggie/booking/resources", "/_maggie/booking/schedule", "/_maggie/booking/payments", "/_maggie/booking/notifications", "/_maggie/booking/email-templates", "/_maggie/booking/reports", "/_maggie/booking/settings", "/_maggie/booking/audit"],
+  "x-required-viewports": [{"name":"mobile","width":390,"height":844},{"name":"tablet","width":768,"height":1024},{"name":"desktop","width":1440,"height":1000}]
+}