@almadar/std 16.252.0 → 16.254.0

package/behaviors/registry/infra/atoms/std-approval-gate.orb

@@ -1 +1 @@
-{"name":"std-approval-gate","version":"1.1.0","description":"std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. blockSelfApproval additionally stops a reviewer approving their own request (four-eyes) — DENY stays allowed as self-withdrawal. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific.","orbitals":[{"name":"ApprovalGateOrbital","id":"orb_C47DR6W7883M466T0XHH12YMAQ","uses":[{"from":"std/behaviors/ui-spinner","as":"Spinner"},{"from":"std/behaviors/ui-typography","as":"Typography"},{"from":"std/behaviors/ui-icon","as":"Icon"},{"from":"std/behaviors/ui-button","as":"Button"},{"from":"std/behaviors/ui-divider","as":"Divider"},{"from":"std/behaviors/ui-alert","as":"Alert"}],"entity":{"name":"ApprovalRequest","id":"ent_RHD868NFTHQX8X1NVP40WHT37D","collection":"approval_requests","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string","default":"","description":"The event that triggered the approval request.","synonyms":"trigger, event, source"},{"name":"subjectLabel","type":"string","default":"","description":"Human title of the thing being approved (the article's headline, the page's title) — what the reviewer sees in the queue.","synonyms":"title, subject, what is being approved"},{"name":"subjectId","type":"string","default":"","description":"Id of the record being approved, for a queue row's View click-through to the subject's own surface.","synonyms":"record id, target id, article id, page id"},{"name":"requestedBy","type":"string","default":"","description":"User id of the submitter.","synonyms":"submitter, author, requester id"},{"name":"requestedByName","type":"string","default":"","description":"Display name of the submitter shown in the queue.","synonyms":"submitter name, requester, who asked"},{"name":"status","type":"string","default":"pending","values":["pending","approved","denied","escalated"],"description":"Current state of the approval process.","synonyms":"approval status, state, condition"},{"name":"reviewer","type":"string","default":"","description":"The user or system responsible for reviewing the request.","synonyms":"assignee, owner, approver, responsible party"},{"name":"requestedAt","type":"number","default":0,"description":"Timestamp indicating when the approval request was initiated.","synonyms":"creation time, request date, submission time"},{"name":"decidedAt","type":"number","default":0,"description":"Timestamp indicating when a decision was made on the request.","synonyms":"decision time, resolved at, completed at"},{"name":"escalatedAt","type":"number","default":0,"description":"Timestamp indicating when the request was escalated.","synonyms":"escalation time, escalation timestamp, escalated time"},{"name":"notes","type":"string","default":"","description":"The reviewer's written reason, captured by the deny step.","synonyms":"comments, remarks, explanation, reason, details"},{"name":"payload","type":"string","default":"","description":"The held data of the gated action as JSON text, replayed by the downstream listener when the request is granted.","synonyms":"request data, held payload, pending data, gated data"}],"access_waivers":{"read":"Shared review surface: submitters watch their requests, approvers work the queue; decision authority is enforced at the transitions, not by hiding rows."}},"traits":[{"ref":"Spinner.traits.SpinnerRender","id":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","name":"LoadingSpinner","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D"},{"ref":"Spinner.traits.SpinnerRender","id":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","name":"ErrorSpinner","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"size":{"type":"unknown","default":"sm"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","name":"LoadingText","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"color":{"type":"unknown","default":"muted"},"variant":{"type":"unknown","default":"caption"},"content":{"type":"unknown","default":"Loading approval queue…"}}},{"ref":"Icon.traits.IconRender","id":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","name":"ShieldCheckIcon","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"name":{"type":"unknown","default":"shield-check"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","name":"ApprovalQueueTitle","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"content":{"type":"unknown","default":"Approval queue"},"variant":{"type":"unknown","default":"h3"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","name":"DenyReasonTitle","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"content":{"type":"unknown","default":"Deny request"},"variant":{"type":"unknown","default":"h3"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","name":"DenyReasonHint","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"variant":{"type":"unknown","default":"caption"},"content":{"type":"unknown","default":"Tell the submitter why — the reason is recorded on the request."},"color":{"type":"unknown","default":"muted"}}},{"ref":"Button.traits.ButtonRender","id":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","name":"CloseButton","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"action":{"type":"unknown","default":"CLOSE"},"icon":{"type":"unknown","default":"x"},"label":{"type":"unknown","default":"Close"},"variant":{"type":"unknown","default":"ghost"}}},{"ref":"Divider.traits.DividerRender","id":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","name":"ApprovalDivider","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D"},{"ref":"Alert.traits.AlertRender","id":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","name":"ErrorAlert","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"message":{"type":"unknown","default":"@payload.error"},"variant":{"type":"unknown","default":"error"}}},{"name":"ApprovalGateReview","id":"trt_0380ZTKN4RTJC4JSD6H48CK9MY","entityRebindable":true,"entityContract":{"requires":[],"provides":["decidedAt","notes","reviewer","status","subjectLabel"]},"effectRow":[{"kind":"emit","resource":"ApprovalDenied"},{"kind":"emit","resource":"ApprovalGranted"},{"kind":"fetch","resource":"ApprovalRequest"},{"kind":"persist","resource":"ApprovalRequest"},{"kind":"render-ui","resource":"@config.reviewSlot","resolved":false},{"kind":"render-ui","resource":"toast"},{"kind":"set","resource":"@entity.decidedAt"},{"kind":"set","resource":"@entity.id"},{"kind":"set","resource":"@entity.notes"},{"kind":"set","resource":"@entity.reviewer"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.subjectLabel"}],"category":"interaction","capabilities":["approval"],"linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","entityRefIds":{"ApprovalRequest":"ent_RHD868NFTHQX8X1NVP40WHT37D"},"traitEmbedIds":{"LoadingText":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","CloseButton":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","ShieldCheckIcon":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","ApprovalQueueTitle":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","ApprovalDivider":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","ErrorAlert":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","ErrorSpinner":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","DenyReasonTitle":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","DenyReasonHint":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","LoadingSpinner":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V"},"emits":[{"event":"APPROVE","eventId":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","description":"Signals that an approval request has been approved.","synonyms":"accept, authorize, confirm, pass","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"DENY","eventId":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","description":"Opens the deny step for a request; the decision commits with the written reason.","synonyms":"reject, decline","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"OPEN_SUBJECT","eventId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","description":"A reviewer clicked View on a queue row. Hosts route subjectId to the subject record's own surface so the reviewer can read what they are approving. Scalars only — the row stays in the queue.","synonyms":"view subject, open record, inspect request, see the article","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"},{"name":"subjectId","type":"string"},{"name":"subjectLabel","type":"string"}]},{"event":"CONFIRM_DENY","eventId":"evt_175085C5M52T2SS2WHZRF8P52T","description":"The deny form committed; data carries the request id + the written reason.","synonyms":"submit denial, confirm rejection","tier":"internal","payloadSchema":[{"name":"data","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}]}]},{"event":"CANCEL_DENY","eventId":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","description":"The deny form was dismissed without committing; the queue repaints.","synonyms":"cancel denial, back to queue","tier":"internal"},{"event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","description":"Dismisses the review queue overlay.","synonyms":"dismiss, hide, cancel, done","tier":"domain"},{"event":"ApprovalGranted","eventId":"evt_ZNTAM4EABM55T7A9SD59550RFN","description":"Signals that an approval process has been successfully completed; carries the held payload for the downstream listener to replay. Contract: if the replay fails (access denial, write failure), the host MUST emit APPROVAL_REPLAY_FAILED back so the request reopens.","synonyms":"approved, authorized, confirmed, validated","tier":"domain","scope":"external","payloadSchema":[{"name":"requestId","type":"string"},{"name":"payload","type":"$p"}]},{"event":"ApprovalDenied","eventId":"evt_HXXJW22J7K93SZJV6F963QC4Q8","description":"Indicates an approval request has been denied, with the reviewer's written reason.","synonyms":"rejected, declined","tier":"domain","scope":"external","payloadSchema":[{"name":"requestId","type":"string"},{"name":"reason","type":"string"}]},{"event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ","description":"Indicates an approval request has been successfully loaded.","synonyms":"loaded, fetched, retrieved","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","description":"Indicates failure to load an approval request.","synonyms":"load error, failed load, request failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]},{"event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","description":"Signals that an approval request has been reviewed.","synonyms":"reviewed, processed, examined","tier":"internal","scope":"internal","payloadSchema":[{"name":"value","type":"@entity"}]},{"event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","description":"Indicates a failure to load or process an approval request for review.","synonyms":"load error, failed review, processing failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"loading"},{"name":"reviewing"},{"name":"denying"},{"name":"error"}],"events":[{"key":"INIT","id":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","name":"Initialize"},{"key":"ApprovalRequestLoaded","id":"evt_RC47PFV368HK4535PVWQWKS3MZ","name":"ApprovalRequest loaded","description":"Indicates an approval request has been successfully loaded.","synonyms":"loaded, fetched, retrieved","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"ApprovalRequestLoadFailed","id":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","name":"ApprovalRequest load failed","description":"Indicates failure to load an approval request.","synonyms":"load error, failed load, request failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"APPROVAL_REPLAY_FAILED","id":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","name":"Approval Replay Failed","description":"The host could not apply the granted action (access denial, failed write). The request reopens as pending so a decision is never silently lost.","synonyms":"replay failed, apply failed, approval rollback","tier":"domain","payloadSchema":[{"name":"requestId","type":"string","required":true},{"name":"error","type":"string"}],"listened":true},{"key":"ApprovalRequestReviewFailed","id":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","name":"ApprovalRequest review failed","description":"Indicates a failure to load or process an approval request for review.","synonyms":"load error, failed review, processing failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"OPEN","id":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","name":"Open","description":"Summons the review queue (host nav/affordance requests it).","synonyms":"open, show, review, view queue, open approvals","tier":"domain","listened":true},{"key":"CLOSE","id":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","name":"Close","description":"Dismisses the review queue overlay.","synonyms":"dismiss, hide, cancel, done","tier":"domain","listened":true},{"key":"APPROVE","id":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","name":"Approve","description":"Signals that an approval request has been approved.","synonyms":"accept, authorize, confirm, pass","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"DENY","id":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","name":"Deny","description":"Opens the deny step for a request; the decision commits with the written reason.","synonyms":"reject, decline","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"OPEN_SUBJECT","id":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","name":"Open Subject","description":"A reviewer clicked View on a queue row. Hosts route subjectId to the subject record's own surface so the reviewer can read what they are approving. Scalars only — the row stays in the queue.","synonyms":"view subject, open record, inspect request, see the article","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"subjectId","type":"string"},{"name":"subjectLabel","type":"string"}],"listened":true},{"key":"ApprovalRequestReviewed","id":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","name":"ApprovalRequest reviewed","description":"Signals that an approval request has been reviewed.","synonyms":"reviewed, processed, examined","tier":"internal","payloadSchema":[{"name":"value","type":"@entity"}],"listened":true},{"key":"CONFIRM_DENY","id":"evt_175085C5M52T2SS2WHZRF8P52T","name":"Confirm Deny","description":"The deny form committed; data carries the request id + the written reason.","synonyms":"submit denial, confirm rejection","tier":"internal","payloadSchema":[{"name":"data","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}]}],"listened":true},{"key":"CANCEL_DENY","id":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","name":"Cancel Deny","description":"The deny form was dismissed without committing; the queue repaints.","synonyms":"cancel denial, back to queue","tier":"internal","listened":true},{"key":"ApprovalGranted","id":"evt_ZNTAM4EABM55T7A9SD59550RFN","name":"Approval granted","description":"Signals that an approval process has been successfully completed; carries the held payload for the downstream listener to replay. Contract: if the replay fails (access denial, write failure), the host MUST emit APPROVAL_REPLAY_FAILED back so the request reopens.","synonyms":"approved, authorized, confirmed, validated","tier":"domain","payloadSchema":[{"name":"requestId","type":"string"},{"name":"payload","type":"$p"}]},{"key":"ApprovalDenied","id":"evt_HXXJW22J7K93SZJV6F963QC4Q8","name":"Approval denied","description":"Indicates an approval request has been denied, with the reviewer's written reason.","synonyms":"rejected, declined","tier":"domain","payloadSchema":[{"name":"requestId","type":"string"},{"name":"reason","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"idle","to":"idle","event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ"},{"from":"idle","to":"idle","event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","effects":[["render-ui","toast",{"type":"alert","variant":"error","message":["str/concat","Couldn't load the approval request — ","@payload.error"],"dismissible":true}]]},{"from":"idle","to":"idle","event":"APPROVAL_REPLAY_FAILED","eventId":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","effects":[["set","@entity.id","@payload.requestId"],["set","@entity.status","pending"],["set","@entity.reviewer",""],["set","@entity.decidedAt",0],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["render-ui","toast",{"type":"alert","variant":"error","message":"Approval could not be applied — the request was reopened.","dismissible":true}]]},{"from":"idle","to":"idle","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","toast",{"type":"alert","variant":"error","message":["str/concat","Couldn't reopen the approval request — ","@payload.error"],"dismissible":true}]]},{"from":"idle","to":"loading","event":"OPEN","eventId":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","guard":"@config.enabled","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}],["render-ui","@config.reviewSlot",{"align":"center","children":["@trait.LoadingSpinner","@trait.LoadingText"],"className":"py-12","direction":"vertical","gap":"md","type":"stack"}]]},{"from":"loading","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"loading","to":"reviewing","event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ","effects":[["render-ui","@config.reviewSlot",{"children":[{"align":"center","children":[{"align":"center","children":["@trait.ShieldCheckIcon","@trait.ApprovalQueueTitle"],"direction":"horizontal","gap":"sm","type":"stack"},"@trait.CloseButton"],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"},"@trait.ApprovalDivider",{"cols":1,"entity":"@payload.data","fields":[{"label":"What","name":"subjectLabel","variant":"h4"},{"label":"Action","name":"gatedEvent","variant":"badge"},{"label":"Requested by","name":"requestedByName","variant":"caption"},{"label":"Requested","format":"date","name":"requestedAt","variant":"caption"}],"gap":"sm","itemClickEvent":"@config.itemClickEvent","itemActions":["array/filter","@config.itemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"look":"@config.tableLook","type":"data-grid"}],"direction":"vertical","gap":"md","type":"stack"}]]},{"from":"loading","to":"error","event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"loading","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"reviewing","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"reviewing","to":"reviewing","event":"APPROVE","eventId":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","guard":["and",["or",["=",["array/len","@config.approverRoles"],0],["array/includes","@config.approverRoles","@user.role"]],["or",["=","@config.blockSelfApproval",false],["!=",["object/get","@payload.row","requestedBy"],"@user.id"]]],"effects":[["set","@entity.id","@payload.id"],["set","@entity.status","approved"],["set","@entity.reviewer","@user.id"],["set","@entity.decidedAt",["time/now"]],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["emit","ApprovalGranted",{"payload":["json/parse","@payload.row.payload","p"],"requestId":"@payload.id"}]]},{"from":"reviewing","to":"denying","event":"DENY","eventId":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","guard":["or",["=",["array/len","@config.approverRoles"],0],["array/includes","@config.approverRoles","@user.role"]],"effects":[["set","@entity.id","@payload.id"],["set","@entity.subjectLabel",["str/default",["object/get","@payload.row","subjectLabel"],""]],["render-ui","@config.reviewSlot",{"children":[{"align":"center","children":["@trait.DenyReasonTitle","@trait.CloseButton"],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"},"@trait.DenyReasonHint","@trait.ApprovalDivider",{"cancelEvent":"CANCEL_DENY","entity":{"id":"@entity.id"},"fields":["notes"],"mode":"edit","submitEvent":"CONFIRM_DENY","type":"form-section"}],"direction":"vertical","gap":"md","type":"stack"}]]},{"from":"reviewing","to":"reviewing","event":"OPEN_SUBJECT","eventId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP"},{"from":"reviewing","to":"loading","event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"reviewing","to":"reviewing","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"reviewing","to":"reviewing","event":"APPROVAL_REPLAY_FAILED","eventId":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","effects":[["set","@entity.id","@payload.requestId"],["set","@entity.status","pending"],["set","@entity.reviewer",""],["set","@entity.decidedAt",0],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["render-ui","toast",{"type":"alert","variant":"error","message":"Approval could not be applied — the request was reopened.","dismissible":true}]]},{"from":"reviewing","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"denying","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"reviewing","event":"CONFIRM_DENY","eventId":"evt_175085C5M52T2SS2WHZRF8P52T","effects":[["set","@entity.id",["object/get","@payload.data","id"]],["set","@entity.status","denied"],["set","@entity.reviewer","@user.id"],["set","@entity.decidedAt",["time/now"]],["set","@entity.notes",["str/default",["object/get","@payload.data","notes"],""]],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["emit","ApprovalDenied",{"requestId":["object/get","@payload.data","id"],"reason":["str/default",["object/get","@payload.data","notes"],""]}]]},{"from":"denying","to":"loading","event":"CANCEL_DENY","eventId":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"loading","event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"denying","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"denying","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"error","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"error","to":"loading","event":"OPEN","eventId":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}],["render-ui","@config.reviewSlot",{"children":["@trait.ErrorSpinner"],"type":"stack"}]]},{"from":"error","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]}]},"config":{"reviewSlot":{"type":"slot","default":"modal","label":"Review slot","description":"UI slot the review queue renders into. Defaults to the modal overlay so the queue never seizes the host's main content; summoned via OPEN, cleared via CLOSE.","tier":"internal"},"enabled":{"type":"boolean","default":false,"label":"Require approval","description":"Require sign-off before a record is finalized. Off by default.","synonyms":"enable, turn on, enforce, require, activate, apply, switch on, approval, needs approval, sign-off, signed off, review before, gatekeeper, editor approval, publishing approval, draft approval, content review, requires approval, manager approval, supervisor approval, admin approval, before going live","tier":"policy"},"itemActions":{"type":"[ItemAction]","default":[{"event":"OPEN_SUBJECT","icon":"eye","label":"View","variant":"ghost"},{"event":"APPROVE","icon":"check","label":"Approve","variant":"primary"},{"event":"DENY","icon":"x","label":"Deny","variant":"danger"}],"label":"Row actions","description":"Actions offered on each row; give an item `roles` to show it only to those viewer roles.","tier":"presentation","items":{"type":"object","properties":{"icon":{"name":"icon","type":"string","required":false},"when":{"name":"when","type":"SExpr","required":false},"roles":{"name":"roles","type":"array","required":false,"items":{"type":"string"}},"event":{"name":"event","type":"event","required":false},"variant":{"name":"variant","type":"string","required":false},"label":{"name":"label","type":"string","required":true}}}},"viewerRole":{"type":"string","default":"","label":"Viewer's role","description":"The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show.","tier":"policy"},"approverRoles":{"type":"[string]","default":[],"label":"Who can approve requests?","description":"Roles eligible to decide. ENFORCED by the APPROVE/DENY transition guards: a viewer whose @user.role is not listed cannot fire a decision, from the button or from the bus. Empty = every signed-in viewer may decide (ungated).","synonyms":"approver, reviewer, authorized roles, sign-off roles, who approves","tier":"policy","items":{"type":"string"}},"tableLook":{"type":"string","default":"dense","label":"Review queue table style","description":"Visual treatment for the approval-queue data table.","synonyms":"table style, grid look, compact, spacious, striped","tier":"presentation","values":["dense","spacious","striped","borderless","card-rows"]},"blockSelfApproval":{"type":"boolean","default":false,"label":"Block approving your own requests?","description":"When on, a reviewer cannot APPROVE a request they submitted themselves (requestedBy = the viewer's id) — enforced by the APPROVE transition guard, from the button or from the bus. Requires hosts to stamp requestedBy at request creation. DENY stays allowed on your own request (denying your own request withdraws it). Off by default.","synonyms":"self approval, self-approval, four eyes, four-eyes, separation of duties, cannot approve own, no self sign-off, dual control","tier":"policy"},"itemClickEvent":{"type":"event","default":"OPEN_SUBJECT","label":"Row click","description":"Event emitted when a row is clicked; opens the subject under review. Empty disables the row click.","tier":"presentation","refId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP"}},"scope":"collection","typeParams":[{"name":"p","kind":"Entity"}]}],"pages":[{"name":"ApprovalGateReviewPage","id":"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6","path":"/approvals/queue","traits":[{"ref":"ApprovalGateReview","refId":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"}]}],"types":{"DenyCommit":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}],"ItemAction":[{"name":"label","type":"string","required":true},{"name":"event","type":"event"},{"name":"variant","type":"string"},{"name":"icon","type":"string"},{"name":"roles","type":"[string]"},{"name":"when","type":"SExpr"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_RHD868NFTHQX8X1NVP40WHT37D":{"id":"ent_RHD868NFTHQX8X1NVP40WHT37D","kind":"entity","bakedName":"ApprovalRequest","curName":"ApprovalRequest","renames":[],"owner":"workspace"},"evt_0EP4VEQCCFP67ZEN3TVAN67T85":{"id":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","kind":"event","bakedName":"ApprovalRequestReviewFailed","curName":"ApprovalRequestReviewFailed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_175085C5M52T2SS2WHZRF8P52T":{"id":"evt_175085C5M52T2SS2WHZRF8P52T","kind":"event","bakedName":"CONFIRM_DENY","curName":"CONFIRM_DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_4T4NEH25ND2TPR2KGREPNJPB1B":{"id":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","kind":"event","bakedName":"APPROVE","curName":"APPROVE","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_5MNE8EC51V2GXH0F0QN1WRQMY0":{"id":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_CRE6YWV91FMGQW6XGDFSF4K17X":{"id":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","kind":"event","bakedName":"ApprovalRequestLoadFailed","curName":"ApprovalRequestLoadFailed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_HDQK9DN4WJJE90C3VEGJMWPSSK":{"id":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","kind":"event","bakedName":"CLOSE","curName":"CLOSE","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_HXXJW22J7K93SZJV6F963QC4Q8":{"id":"evt_HXXJW22J7K93SZJV6F963QC4Q8","kind":"event","bakedName":"ApprovalDenied","curName":"ApprovalDenied","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_JGR6YDM8BG45RB1CGAMBZB8JNP":{"id":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","kind":"event","bakedName":"DENY","curName":"DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_KK89PCP4D526JHH5AKFWPHCHZ6":{"id":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","kind":"event","bakedName":"CANCEL_DENY","curName":"CANCEL_DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ":{"id":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","kind":"event","bakedName":"APPROVAL_REPLAY_FAILED","curName":"APPROVAL_REPLAY_FAILED","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_RC47PFV368HK4535PVWQWKS3MZ":{"id":"evt_RC47PFV368HK4535PVWQWKS3MZ","kind":"event","bakedName":"ApprovalRequestLoaded","curName":"ApprovalRequestLoaded","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_S9CE4D2DFF6QQGRQG5YPK2N76C":{"id":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","kind":"event","bakedName":"OPEN","curName":"OPEN","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_T1J65W89XH4YRTYM57QM1W5ZZP":{"id":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","kind":"event","bakedName":"OPEN_SUBJECT","curName":"OPEN_SUBJECT","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_W7SA338X5MEJT9XWWK0ZRKR0E7":{"id":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","kind":"event","bakedName":"ApprovalRequestReviewed","curName":"ApprovalRequestReviewed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_ZNTAM4EABM55T7A9SD59550RFN":{"id":"evt_ZNTAM4EABM55T7A9SD59550RFN","kind":"event","bakedName":"ApprovalGranted","curName":"ApprovalGranted","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"orb_C47DR6W7883M466T0XHH12YMAQ":{"id":"orb_C47DR6W7883M466T0XHH12YMAQ","kind":"orbital","bakedName":"ApprovalGateOrbital","curName":"ApprovalGateOrbital","renames":[],"owner":"workspace"},"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6":{"id":"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6","kind":"page","bakedName":"ApprovalGateReviewPage","curName":"ApprovalGateReviewPage","renames":[],"owner":"workspace"},"trt_0380ZTKN4RTJC4JSD6H48CK9MY":{"id":"trt_0380ZTKN4RTJC4JSD6H48CK9MY","kind":"trait","bakedName":"ApprovalGateReview","curName":"ApprovalGateReview","renames":[],"owner":"workspace"},"trt_7ZRX4FHWYYYFF92MNANE0PZF9G":{"id":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","kind":"trait","bakedName":"ErrorSpinner","curName":"ErrorSpinner","renames":[],"owner":"workspace"},"trt_96ATJ2K01YG0ZA385FMHPBNGC5":{"id":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","kind":"trait","bakedName":"ShieldCheckIcon","curName":"ShieldCheckIcon","renames":[],"owner":"workspace"},"trt_BAA9G5YBEM5QA1NDKA9Q1XC940":{"id":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","kind":"trait","bakedName":"CloseButton","curName":"CloseButton","renames":[],"owner":"workspace"},"trt_BEBDJHPFW07Y06D1VMN21FN0JJ":{"id":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","kind":"trait","bakedName":"LoadingText","curName":"LoadingText","renames":[],"owner":"workspace"},"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A":{"id":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","kind":"trait","bakedName":"ErrorAlert","curName":"ErrorAlert","renames":[],"owner":"workspace"},"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V":{"id":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","kind":"trait","bakedName":"LoadingSpinner","curName":"LoadingSpinner","renames":[],"owner":"workspace"},"trt_MMHEPF3R0TW0DB4C0A82C1P6A4":{"id":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","kind":"trait","bakedName":"ApprovalDivider","curName":"ApprovalDivider","renames":[],"owner":"workspace"},"trt_RWMH37FBGHNR8Z65VXXBXQR9XH":{"id":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","kind":"trait","bakedName":"ApprovalQueueTitle","curName":"ApprovalQueueTitle","renames":[],"owner":"workspace"},"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9":{"id":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","kind":"trait","bakedName":"DenyReasonHint","curName":"DenyReasonHint","renames":[],"owner":"workspace"},"trt_YA6J959W4TY2DEBPBGX4FGM2JK":{"id":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","kind":"trait","bakedName":"DenyReasonTitle","curName":"DenyReasonTitle","renames":[],"owner":"workspace"}}}}
+{"name":"std-approval-gate","version":"1.1.0","description":"std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. blockSelfApproval additionally stops a reviewer approving their own request (four-eyes) — DENY stays allowed as self-withdrawal. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific.","orbitals":[{"name":"ApprovalGateOrbital","id":"orb_C47DR6W7883M466T0XHH12YMAQ","uses":[{"from":"std/behaviors/ui-spinner","as":"Spinner"},{"from":"std/behaviors/ui-typography","as":"Typography"},{"from":"std/behaviors/ui-icon","as":"Icon"},{"from":"std/behaviors/ui-button","as":"Button"},{"from":"std/behaviors/ui-divider","as":"Divider"},{"from":"std/behaviors/ui-alert","as":"Alert"}],"entity":{"name":"ApprovalRequest","id":"ent_RHD868NFTHQX8X1NVP40WHT37D","collection":"approval_requests","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string","default":"","description":"The event that triggered the approval request.","synonyms":"trigger, event, source"},{"name":"subjectLabel","type":"string","default":"","description":"Human title of the thing being approved (the article's headline, the page's title) — what the reviewer sees in the queue.","synonyms":"title, subject, what is being approved"},{"name":"subjectId","type":"string","default":"","description":"Id of the record being approved, for a queue row's View click-through to the subject's own surface.","synonyms":"record id, target id, article id, page id"},{"name":"requestedBy","type":"string","default":"","description":"User id of the submitter.","synonyms":"submitter, author, requester id"},{"name":"requestedByName","type":"string","default":"","description":"Display name of the submitter shown in the queue.","synonyms":"submitter name, requester, who asked"},{"name":"status","type":"string","default":"pending","values":["pending","approved","denied","escalated"],"description":"Current state of the approval process.","synonyms":"approval status, state, condition"},{"name":"reviewer","type":"string","default":"","description":"The user or system responsible for reviewing the request.","synonyms":"assignee, owner, approver, responsible party"},{"name":"requestedAt","type":"number","default":0,"description":"Timestamp indicating when the approval request was initiated.","synonyms":"creation time, request date, submission time"},{"name":"decidedAt","type":"number","default":0,"description":"Timestamp indicating when a decision was made on the request.","synonyms":"decision time, resolved at, completed at"},{"name":"escalatedAt","type":"number","default":0,"description":"Timestamp indicating when the request was escalated.","synonyms":"escalation time, escalation timestamp, escalated time"},{"name":"notes","type":"string","default":"","description":"The reviewer's written reason, captured by the deny step.","synonyms":"comments, remarks, explanation, reason, details"},{"name":"payload","type":"string","default":"","description":"The held data of the gated action as JSON text, replayed by the downstream listener when the request is granted.","synonyms":"request data, held payload, pending data, gated data"}],"access_waivers":{"read":"Shared review surface: submitters watch their requests, approvers work the queue; decision authority is enforced at the transitions, not by hiding rows."}},"traits":[{"ref":"Spinner.traits.SpinnerRender","id":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","name":"LoadingSpinner","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D"},{"ref":"Spinner.traits.SpinnerRender","id":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","name":"ErrorSpinner","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"size":{"type":"unknown","default":"sm"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","name":"LoadingText","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"variant":{"type":"unknown","default":"caption"},"color":{"type":"unknown","default":"muted"},"content":{"type":"unknown","default":"Loading approval queue…"}}},{"ref":"Icon.traits.IconRender","id":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","name":"ShieldCheckIcon","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"name":{"type":"unknown","default":"shield-check"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","name":"ApprovalQueueTitle","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"variant":{"type":"unknown","default":"h3"},"content":{"type":"unknown","default":"Approval queue"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","name":"DenyReasonTitle","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"content":{"type":"unknown","default":"Deny request"},"variant":{"type":"unknown","default":"h3"}}},{"ref":"Typography.traits.TypographyRender","id":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","name":"DenyReasonHint","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"color":{"type":"unknown","default":"muted"},"variant":{"type":"unknown","default":"caption"},"content":{"type":"unknown","default":"Tell the submitter why — the reason is recorded on the request."}}},{"ref":"Button.traits.ButtonRender","id":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","name":"CloseButton","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"variant":{"type":"unknown","default":"ghost"},"label":{"type":"unknown","default":"Close"},"icon":{"type":"unknown","default":"x"},"action":{"type":"unknown","default":"CLOSE"}}},{"ref":"Divider.traits.DividerRender","id":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","name":"ApprovalDivider","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D"},{"ref":"Alert.traits.AlertRender","id":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","name":"ErrorAlert","linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","config":{"variant":{"type":"unknown","default":"error"},"message":{"type":"unknown","default":"@payload.error"}}},{"name":"ApprovalGateReview","id":"trt_0380ZTKN4RTJC4JSD6H48CK9MY","entityRebindable":true,"entityContract":{"requires":[],"provides":["decidedAt","notes","reviewer","status","subjectLabel"]},"effectRow":[{"kind":"emit","resource":"ApprovalDenied"},{"kind":"emit","resource":"ApprovalGranted"},{"kind":"fetch","resource":"ApprovalRequest"},{"kind":"persist","resource":"ApprovalRequest"},{"kind":"render-ui","resource":"@config.reviewSlot","resolved":false},{"kind":"render-ui","resource":"toast"},{"kind":"set","resource":"@entity.decidedAt"},{"kind":"set","resource":"@entity.id"},{"kind":"set","resource":"@entity.notes"},{"kind":"set","resource":"@entity.reviewer"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.subjectLabel"}],"category":"interaction","capabilities":["approval"],"linkedEntity":"ApprovalRequest","linkedEntityId":"ent_RHD868NFTHQX8X1NVP40WHT37D","entityRefIds":{"ApprovalRequest":"ent_RHD868NFTHQX8X1NVP40WHT37D"},"traitEmbedIds":{"ShieldCheckIcon":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","DenyReasonTitle":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","ApprovalDivider":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","CloseButton":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","DenyReasonHint":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","ErrorAlert":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","LoadingSpinner":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","LoadingText":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","ErrorSpinner":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","ApprovalQueueTitle":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH"},"emits":[{"event":"APPROVE","eventId":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","description":"Signals that an approval request has been approved.","synonyms":"accept, authorize, confirm, pass","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"DENY","eventId":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","description":"Opens the deny step for a request; the decision commits with the written reason.","synonyms":"reject, decline","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"OPEN_SUBJECT","eventId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","description":"A reviewer clicked View on a queue row. Hosts route subjectId to the subject record's own surface so the reviewer can read what they are approving. Scalars only — the row stays in the queue.","synonyms":"view subject, open record, inspect request, see the article","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"},{"name":"subjectId","type":"string"},{"name":"subjectLabel","type":"string"}]},{"event":"CONFIRM_DENY","eventId":"evt_175085C5M52T2SS2WHZRF8P52T","description":"The deny form committed; data carries the request id + the written reason.","synonyms":"submit denial, confirm rejection","tier":"internal","payloadSchema":[{"name":"data","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}]}]},{"event":"CANCEL_DENY","eventId":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","description":"The deny form was dismissed without committing; the queue repaints.","synonyms":"cancel denial, back to queue","tier":"internal"},{"event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","description":"Dismisses the review queue overlay.","synonyms":"dismiss, hide, cancel, done","tier":"domain"},{"event":"ApprovalGranted","eventId":"evt_ZNTAM4EABM55T7A9SD59550RFN","description":"Signals that an approval process has been successfully completed; carries the held payload for the downstream listener to replay. Contract: if the replay fails (access denial, write failure), the host MUST emit APPROVAL_REPLAY_FAILED back so the request reopens.","synonyms":"approved, authorized, confirmed, validated","tier":"domain","scope":"external","payloadSchema":[{"name":"requestId","type":"string"},{"name":"payload","type":"$p"}]},{"event":"ApprovalDenied","eventId":"evt_HXXJW22J7K93SZJV6F963QC4Q8","description":"Indicates an approval request has been denied, with the reviewer's written reason.","synonyms":"rejected, declined","tier":"domain","scope":"external","payloadSchema":[{"name":"requestId","type":"string"},{"name":"reason","type":"string"}]},{"event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ","description":"Indicates an approval request has been successfully loaded.","synonyms":"loaded, fetched, retrieved","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}]},{"event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","description":"Indicates failure to load an approval request.","synonyms":"load error, failed load, request failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]},{"event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","description":"Signals that an approval request has been reviewed.","synonyms":"reviewed, processed, examined","tier":"internal","scope":"internal","payloadSchema":[{"name":"value","type":"@entity"}]},{"event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","description":"Indicates a failure to load or process an approval request for review.","synonyms":"load error, failed review, processing failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"loading"},{"name":"reviewing"},{"name":"denying"},{"name":"error"}],"events":[{"key":"INIT","id":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","name":"Initialize"},{"key":"ApprovalRequestLoaded","id":"evt_RC47PFV368HK4535PVWQWKS3MZ","name":"ApprovalRequest loaded","description":"Indicates an approval request has been successfully loaded.","synonyms":"loaded, fetched, retrieved","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"ApprovalRequestLoadFailed","id":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","name":"ApprovalRequest load failed","description":"Indicates failure to load an approval request.","synonyms":"load error, failed load, request failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"APPROVAL_REPLAY_FAILED","id":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","name":"Approval Replay Failed","description":"The host could not apply the granted action (access denial, failed write). The request reopens as pending so a decision is never silently lost.","synonyms":"replay failed, apply failed, approval rollback","tier":"domain","payloadSchema":[{"name":"requestId","type":"string","required":true},{"name":"error","type":"string"}],"listened":true},{"key":"ApprovalRequestReviewFailed","id":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","name":"ApprovalRequest review failed","description":"Indicates a failure to load or process an approval request for review.","synonyms":"load error, failed review, processing failure","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"OPEN","id":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","name":"Open","description":"Summons the review queue (host nav/affordance requests it).","synonyms":"open, show, review, view queue, open approvals","tier":"domain","listened":true},{"key":"CLOSE","id":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","name":"Close","description":"Dismisses the review queue overlay.","synonyms":"dismiss, hide, cancel, done","tier":"domain","listened":true},{"key":"APPROVE","id":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","name":"Approve","description":"Signals that an approval request has been approved.","synonyms":"accept, authorize, confirm, pass","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"DENY","id":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","name":"Deny","description":"Opens the deny step for a request; the decision commits with the written reason.","synonyms":"reject, decline","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"row","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"gatedEvent","type":"string"},{"name":"subjectLabel","type":"string"},{"name":"subjectId","type":"string"},{"name":"requestedBy","type":"string"},{"name":"requestedByName","type":"string"},{"name":"status","type":"string","values":["pending","approved","denied","escalated"]},{"name":"reviewer","type":"string"},{"name":"requestedAt","type":"number"},{"name":"decidedAt","type":"number"},{"name":"escalatedAt","type":"number"},{"name":"notes","type":"string"},{"name":"payload","type":"string"}],"entity":"ApprovalRequest"}],"listened":true},{"key":"OPEN_SUBJECT","id":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","name":"Open Subject","description":"A reviewer clicked View on a queue row. Hosts route subjectId to the subject record's own surface so the reviewer can read what they are approving. Scalars only — the row stays in the queue.","synonyms":"view subject, open record, inspect request, see the article","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"subjectId","type":"string"},{"name":"subjectLabel","type":"string"}],"listened":true},{"key":"ApprovalRequestReviewed","id":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","name":"ApprovalRequest reviewed","description":"Signals that an approval request has been reviewed.","synonyms":"reviewed, processed, examined","tier":"internal","payloadSchema":[{"name":"value","type":"@entity"}],"listened":true},{"key":"CONFIRM_DENY","id":"evt_175085C5M52T2SS2WHZRF8P52T","name":"Confirm Deny","description":"The deny form committed; data carries the request id + the written reason.","synonyms":"submit denial, confirm rejection","tier":"internal","payloadSchema":[{"name":"data","type":"object","properties":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}]}],"listened":true},{"key":"CANCEL_DENY","id":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","name":"Cancel Deny","description":"The deny form was dismissed without committing; the queue repaints.","synonyms":"cancel denial, back to queue","tier":"internal","listened":true},{"key":"ApprovalGranted","id":"evt_ZNTAM4EABM55T7A9SD59550RFN","name":"Approval granted","description":"Signals that an approval process has been successfully completed; carries the held payload for the downstream listener to replay. Contract: if the replay fails (access denial, write failure), the host MUST emit APPROVAL_REPLAY_FAILED back so the request reopens.","synonyms":"approved, authorized, confirmed, validated","tier":"domain","payloadSchema":[{"name":"requestId","type":"string"},{"name":"payload","type":"$p"}]},{"key":"ApprovalDenied","id":"evt_HXXJW22J7K93SZJV6F963QC4Q8","name":"Approval denied","description":"Indicates an approval request has been denied, with the reviewer's written reason.","synonyms":"rejected, declined","tier":"domain","payloadSchema":[{"name":"requestId","type":"string"},{"name":"reason","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"idle","to":"idle","event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ"},{"from":"idle","to":"idle","event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","effects":[["render-ui","toast",{"type":"alert","variant":"error","message":["str/concat","Couldn't load the approval request — ","@payload.error"],"dismissible":true}]]},{"from":"idle","to":"idle","event":"APPROVAL_REPLAY_FAILED","eventId":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","effects":[["set","@entity.id","@payload.requestId"],["set","@entity.status","pending"],["set","@entity.reviewer",""],["set","@entity.decidedAt",0],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["render-ui","toast",{"type":"alert","variant":"error","message":"Approval could not be applied — the request was reopened.","dismissible":true}]]},{"from":"idle","to":"idle","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","toast",{"type":"alert","variant":"error","message":["str/concat","Couldn't reopen the approval request — ","@payload.error"],"dismissible":true}]]},{"from":"idle","to":"loading","event":"OPEN","eventId":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","guard":"@config.enabled","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}],["render-ui","@config.reviewSlot",{"align":"center","children":["@trait.LoadingSpinner","@trait.LoadingText"],"className":"py-12","direction":"vertical","gap":"md","type":"stack"}]]},{"from":"loading","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"loading","to":"reviewing","event":"ApprovalRequestLoaded","eventId":"evt_RC47PFV368HK4535PVWQWKS3MZ","effects":[["render-ui","@config.reviewSlot",{"children":[{"align":"center","children":[{"align":"center","children":["@trait.ShieldCheckIcon","@trait.ApprovalQueueTitle"],"direction":"horizontal","gap":"sm","type":"stack"},"@trait.CloseButton"],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"},"@trait.ApprovalDivider",{"cols":1,"entity":"@payload.data","fields":[{"label":"What","name":"subjectLabel","variant":"h4"},{"label":"Action","name":"gatedEvent","variant":"badge"},{"label":"Requested by","name":"requestedByName","variant":"caption"},{"label":"Requested","format":"date","name":"requestedAt","variant":"caption"}],"gap":"sm","itemClickEvent":"@config.itemClickEvent","itemActions":["array/filter","@config.itemActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"look":"@config.tableLook","type":"data-grid"}],"direction":"vertical","gap":"md","type":"stack"}]]},{"from":"loading","to":"error","event":"ApprovalRequestLoadFailed","eventId":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"loading","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"reviewing","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"reviewing","to":"reviewing","event":"APPROVE","eventId":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","guard":["and",["or",["=",["array/len","@config.approverRoles"],0],["array/includes","@config.approverRoles","@user.role"]],["or",["=","@config.blockSelfApproval",false],["!=",["object/get","@payload.row","requestedBy"],"@user.id"]]],"effects":[["set","@entity.id","@payload.id"],["set","@entity.status","approved"],["set","@entity.reviewer","@user.id"],["set","@entity.decidedAt",["time/now"]],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["emit","ApprovalGranted",{"payload":["json/parse","@payload.row.payload","p"],"requestId":"@payload.id"}]]},{"from":"reviewing","to":"denying","event":"DENY","eventId":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","guard":["or",["=",["array/len","@config.approverRoles"],0],["array/includes","@config.approverRoles","@user.role"]],"effects":[["set","@entity.id","@payload.id"],["set","@entity.subjectLabel",["str/default",["object/get","@payload.row","subjectLabel"],""]],["render-ui","@config.reviewSlot",{"children":[{"align":"center","children":["@trait.DenyReasonTitle","@trait.CloseButton"],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"},"@trait.DenyReasonHint","@trait.ApprovalDivider",{"cancelEvent":"CANCEL_DENY","entity":{"id":"@entity.id"},"fields":["notes"],"mode":"edit","submitEvent":"CONFIRM_DENY","type":"form-section"}],"direction":"vertical","gap":"md","type":"stack"}]]},{"from":"reviewing","to":"reviewing","event":"OPEN_SUBJECT","eventId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP"},{"from":"reviewing","to":"loading","event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"reviewing","to":"reviewing","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"reviewing","to":"reviewing","event":"APPROVAL_REPLAY_FAILED","eventId":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","effects":[["set","@entity.id","@payload.requestId"],["set","@entity.status","pending"],["set","@entity.reviewer",""],["set","@entity.decidedAt",0],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["render-ui","toast",{"type":"alert","variant":"error","message":"Approval could not be applied — the request was reopened.","dismissible":true}]]},{"from":"reviewing","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"denying","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"reviewing","event":"CONFIRM_DENY","eventId":"evt_175085C5M52T2SS2WHZRF8P52T","effects":[["set","@entity.id",["object/get","@payload.data","id"]],["set","@entity.status","denied"],["set","@entity.reviewer","@user.id"],["set","@entity.decidedAt",["time/now"]],["set","@entity.notes",["str/default",["object/get","@payload.data","notes"],""]],["persist","update","ApprovalRequest","@entity",{"emit":{"failure":"ApprovalRequestReviewFailed","success":"ApprovalRequestReviewed"}}],["emit","ApprovalDenied",{"requestId":["object/get","@payload.data","id"],"reason":["str/default",["object/get","@payload.data","notes"],""]}]]},{"from":"denying","to":"loading","event":"CANCEL_DENY","eventId":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"loading","event":"ApprovalRequestReviewed","eventId":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"denying","to":"denying","event":"ApprovalRequestReviewFailed","eventId":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","effects":[["render-ui","@config.reviewSlot",{"children":["@trait.ErrorAlert"],"type":"stack"}]]},{"from":"denying","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]},{"from":"error","to":"idle","event":"INIT","eventId":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","effects":[["render-ui","@config.reviewSlot",null],["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}]]},{"from":"error","to":"loading","event":"OPEN","eventId":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","effects":[["fetch","ApprovalRequest",{"filter":["=",["object/get","@entity","status"],"pending"],"emit":{"failure":"ApprovalRequestLoadFailed","success":"ApprovalRequestLoaded"}}],["render-ui","@config.reviewSlot",{"children":["@trait.ErrorSpinner"],"type":"stack"}]]},{"from":"error","to":"idle","event":"CLOSE","eventId":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","effects":[["render-ui","@config.reviewSlot",null]]}]},"config":{"viewerRole":{"type":"string","default":"","label":"Viewer's role","description":"The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show.","tier":"policy"},"tableLook":{"type":"string","default":"dense","label":"Review queue table style","description":"Visual treatment for the approval-queue data table.","synonyms":"table style, grid look, compact, spacious, striped","tier":"presentation","values":["dense","spacious","striped","borderless","card-rows"]},"approverRoles":{"type":"[string]","default":[],"label":"Who can approve requests?","description":"Roles eligible to decide. ENFORCED by the APPROVE/DENY transition guards: a viewer whose @user.role is not listed cannot fire a decision, from the button or from the bus. Empty = every signed-in viewer may decide (ungated).","synonyms":"approver, reviewer, authorized roles, sign-off roles, who approves","tier":"policy","items":{"type":"string"}},"enabled":{"type":"boolean","default":false,"label":"Require approval","description":"Require sign-off before a record is finalized. Off by default.","synonyms":"enable, turn on, enforce, require, activate, apply, switch on, approval, needs approval, sign-off, signed off, review before, gatekeeper, editor approval, publishing approval, draft approval, content review, requires approval, manager approval, supervisor approval, admin approval, before going live","tier":"policy"},"blockSelfApproval":{"type":"boolean","default":false,"label":"Block approving your own requests?","description":"When on, a reviewer cannot APPROVE a request they submitted themselves (requestedBy = the viewer's id) — enforced by the APPROVE transition guard, from the button or from the bus. Requires hosts to stamp requestedBy at request creation. DENY stays allowed on your own request (denying your own request withdraws it). Off by default.","synonyms":"self approval, self-approval, four eyes, four-eyes, separation of duties, cannot approve own, no self sign-off, dual control","tier":"policy"},"reviewSlot":{"type":"slot","default":"modal","label":"Review slot","description":"UI slot the review queue renders into. Defaults to the modal overlay so the queue never seizes the host's main content; summoned via OPEN, cleared via CLOSE.","tier":"internal"},"itemActions":{"type":"[ItemAction]","default":[{"event":"OPEN_SUBJECT","icon":"eye","label":"View","variant":"ghost"},{"event":"APPROVE","icon":"check","label":"Approve","variant":"primary"},{"event":"DENY","icon":"x","label":"Deny","variant":"danger"}],"label":"Row actions","description":"Actions offered on each row; give an item `roles` to show it only to those viewer roles.","tier":"presentation","items":{"type":"object","properties":{"variant":{"name":"variant","type":"string","required":false},"icon":{"name":"icon","type":"string","required":false},"roles":{"name":"roles","type":"array","required":false,"items":{"type":"string"}},"label":{"name":"label","type":"string","required":true},"when":{"name":"when","type":"SExpr","required":false},"event":{"name":"event","type":"event","required":false}}}},"itemClickEvent":{"type":"event","default":"OPEN_SUBJECT","label":"Row click","description":"Event emitted when a row is clicked; opens the subject under review. Empty disables the row click.","tier":"presentation","refId":"evt_T1J65W89XH4YRTYM57QM1W5ZZP"}},"scope":"collection","typeParams":[{"name":"p","kind":"Entity"}]}],"pages":[{"name":"ApprovalGateReviewPage","id":"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6","path":"/approvals/queue","traits":[{"ref":"ApprovalGateReview","refId":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"}]}],"types":{"DenyCommit":[{"name":"id","type":"string","required":true},{"name":"notes","type":"string"}],"ItemAction":[{"name":"label","type":"string","required":true},{"name":"event","type":"event"},{"name":"variant","type":"string"},{"name":"icon","type":"string"},{"name":"roles","type":"[string]"},{"name":"when","type":"SExpr"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_RHD868NFTHQX8X1NVP40WHT37D":{"id":"ent_RHD868NFTHQX8X1NVP40WHT37D","kind":"entity","bakedName":"ApprovalRequest","curName":"ApprovalRequest","renames":[],"owner":"workspace"},"evt_0EP4VEQCCFP67ZEN3TVAN67T85":{"id":"evt_0EP4VEQCCFP67ZEN3TVAN67T85","kind":"event","bakedName":"ApprovalRequestReviewFailed","curName":"ApprovalRequestReviewFailed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_175085C5M52T2SS2WHZRF8P52T":{"id":"evt_175085C5M52T2SS2WHZRF8P52T","kind":"event","bakedName":"CONFIRM_DENY","curName":"CONFIRM_DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_4T4NEH25ND2TPR2KGREPNJPB1B":{"id":"evt_4T4NEH25ND2TPR2KGREPNJPB1B","kind":"event","bakedName":"APPROVE","curName":"APPROVE","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_5MNE8EC51V2GXH0F0QN1WRQMY0":{"id":"evt_5MNE8EC51V2GXH0F0QN1WRQMY0","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_CRE6YWV91FMGQW6XGDFSF4K17X":{"id":"evt_CRE6YWV91FMGQW6XGDFSF4K17X","kind":"event","bakedName":"ApprovalRequestLoadFailed","curName":"ApprovalRequestLoadFailed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_HDQK9DN4WJJE90C3VEGJMWPSSK":{"id":"evt_HDQK9DN4WJJE90C3VEGJMWPSSK","kind":"event","bakedName":"CLOSE","curName":"CLOSE","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_HXXJW22J7K93SZJV6F963QC4Q8":{"id":"evt_HXXJW22J7K93SZJV6F963QC4Q8","kind":"event","bakedName":"ApprovalDenied","curName":"ApprovalDenied","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_JGR6YDM8BG45RB1CGAMBZB8JNP":{"id":"evt_JGR6YDM8BG45RB1CGAMBZB8JNP","kind":"event","bakedName":"DENY","curName":"DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_KK89PCP4D526JHH5AKFWPHCHZ6":{"id":"evt_KK89PCP4D526JHH5AKFWPHCHZ6","kind":"event","bakedName":"CANCEL_DENY","curName":"CANCEL_DENY","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ":{"id":"evt_Q1FM2ANZ4YZJF0F90G9RR8NECQ","kind":"event","bakedName":"APPROVAL_REPLAY_FAILED","curName":"APPROVAL_REPLAY_FAILED","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_RC47PFV368HK4535PVWQWKS3MZ":{"id":"evt_RC47PFV368HK4535PVWQWKS3MZ","kind":"event","bakedName":"ApprovalRequestLoaded","curName":"ApprovalRequestLoaded","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_S9CE4D2DFF6QQGRQG5YPK2N76C":{"id":"evt_S9CE4D2DFF6QQGRQG5YPK2N76C","kind":"event","bakedName":"OPEN","curName":"OPEN","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_T1J65W89XH4YRTYM57QM1W5ZZP":{"id":"evt_T1J65W89XH4YRTYM57QM1W5ZZP","kind":"event","bakedName":"OPEN_SUBJECT","curName":"OPEN_SUBJECT","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_W7SA338X5MEJT9XWWK0ZRKR0E7":{"id":"evt_W7SA338X5MEJT9XWWK0ZRKR0E7","kind":"event","bakedName":"ApprovalRequestReviewed","curName":"ApprovalRequestReviewed","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"evt_ZNTAM4EABM55T7A9SD59550RFN":{"id":"evt_ZNTAM4EABM55T7A9SD59550RFN","kind":"event","bakedName":"ApprovalGranted","curName":"ApprovalGranted","renames":[],"owner":"workspace","parent":"trt_0380ZTKN4RTJC4JSD6H48CK9MY"},"orb_C47DR6W7883M466T0XHH12YMAQ":{"id":"orb_C47DR6W7883M466T0XHH12YMAQ","kind":"orbital","bakedName":"ApprovalGateOrbital","curName":"ApprovalGateOrbital","renames":[],"owner":"workspace"},"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6":{"id":"pag_24Y2VMS43ZJ1ZR1XKCWJHMSER6","kind":"page","bakedName":"ApprovalGateReviewPage","curName":"ApprovalGateReviewPage","renames":[],"owner":"workspace"},"trt_0380ZTKN4RTJC4JSD6H48CK9MY":{"id":"trt_0380ZTKN4RTJC4JSD6H48CK9MY","kind":"trait","bakedName":"ApprovalGateReview","curName":"ApprovalGateReview","renames":[],"owner":"workspace"},"trt_7ZRX4FHWYYYFF92MNANE0PZF9G":{"id":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","kind":"trait","bakedName":"ErrorSpinner","curName":"ErrorSpinner","renames":[],"owner":"workspace"},"trt_96ATJ2K01YG0ZA385FMHPBNGC5":{"id":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","kind":"trait","bakedName":"ShieldCheckIcon","curName":"ShieldCheckIcon","renames":[],"owner":"workspace"},"trt_BAA9G5YBEM5QA1NDKA9Q1XC940":{"id":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","kind":"trait","bakedName":"CloseButton","curName":"CloseButton","renames":[],"owner":"workspace"},"trt_BEBDJHPFW07Y06D1VMN21FN0JJ":{"id":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","kind":"trait","bakedName":"LoadingText","curName":"LoadingText","renames":[],"owner":"workspace"},"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A":{"id":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","kind":"trait","bakedName":"ErrorAlert","curName":"ErrorAlert","renames":[],"owner":"workspace"},"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V":{"id":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","kind":"trait","bakedName":"LoadingSpinner","curName":"LoadingSpinner","renames":[],"owner":"workspace"},"trt_MMHEPF3R0TW0DB4C0A82C1P6A4":{"id":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","kind":"trait","bakedName":"ApprovalDivider","curName":"ApprovalDivider","renames":[],"owner":"workspace"},"trt_RWMH37FBGHNR8Z65VXXBXQR9XH":{"id":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","kind":"trait","bakedName":"ApprovalQueueTitle","curName":"ApprovalQueueTitle","renames":[],"owner":"workspace"},"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9":{"id":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9","kind":"trait","bakedName":"DenyReasonHint","curName":"DenyReasonHint","renames":[],"owner":"workspace"},"trt_YA6J959W4TY2DEBPBGX4FGM2JK":{"id":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","kind":"trait","bakedName":"DenyReasonTitle","curName":"DenyReasonTitle","renames":[],"owner":"workspace"}}}}