@almadar/std 16.253.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":{"content":{"type":"unknown","default":"Loading approval queue…"},"variant":{"type":"unknown","default":"caption"},"color":{"type":"unknown","default":"muted"}}},{"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":{"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":{"icon":{"type":"unknown","default":"x"},"action":{"type":"unknown","default":"CLOSE"},"variant":{"type":"unknown","default":"ghost"},"label":{"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":{"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":{"LoadingSpinner":"trt_H9BXNCBJZPSFV9EWZX6GQ65Y3V","LoadingText":"trt_BEBDJHPFW07Y06D1VMN21FN0JJ","ErrorAlert":"trt_DR8Z4MA8YB4F5M7YNVTA5ZVN0A","ApprovalQueueTitle":"trt_RWMH37FBGHNR8Z65VXXBXQR9XH","ApprovalDivider":"trt_MMHEPF3R0TW0DB4C0A82C1P6A4","ShieldCheckIcon":"trt_96ATJ2K01YG0ZA385FMHPBNGC5","ErrorSpinner":"trt_7ZRX4FHWYYYFF92MNANE0PZF9G","CloseButton":"trt_BAA9G5YBEM5QA1NDKA9Q1XC940","DenyReasonTitle":"trt_YA6J959W4TY2DEBPBGX4FGM2JK","DenyReasonHint":"trt_TEWAFEG1NB0TNJ55E6MYRD7PM9"},"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":{"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"},"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"]},"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},"roles":{"name":"roles","type":"array","required":false,"items":{"type":"string"}},"event":{"name":"event","type":"event","required":false},"label":{"name":"label","type":"string","required":true},"variant":{"name":"variant","type":"string","required":false},"when":{"name":"when","type":"SExpr","required":false}}}},"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"},"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"}}}}

package/behaviors/registry/infra/atoms/std-audit-capture.orb

@@ -1 +1 @@
-{"name":"std-audit-capture","version":"1.3.0","description":"std-audit-capture — event-interceptor audit log / audit trail. Use when a user voices that a record's changes must be tracked, logged, or auditable (audit trail, track changes, change history, who edited what, mutation log, record changes, log every edit, edit history, modification log, who did what when, accountability log). Listens for the generic `EntityMutated` sentinel (rename via traitOverrides.events to the real mutation event, e.g. ContactSaved) and persists an AuditEntry row capturing actor, action, entity type/id, before/after snapshots, and timestamp. `captureEventTypes` filters on @payload.data.kind, or on the delivered event's own name when the payload carries no kind (empty = capture all). Every entry also records where the change came from — the delivering event, the behavior and module that emitted it, and the scheduled job when a tick caused it — with no change to the upstream emitter. Compose with `std-lifecycle` to apply retention. Composable via `extraTraits` to interpose audit logging behind any mutating trait.","orbitals":[{"name":"AuditCaptureOrbital","id":"orb_D7ET0XFFENQQARN7NQG8VE4RF9","entity":{"name":"AuditEntry","id":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","collection":"audit_entries","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"actor","type":"string","default":"","description":"The user or system performing the action.","synonyms":"user, source, originator"},{"name":"action","type":"string","default":"","description":"The specific operation performed on the entity.","synonyms":"operation, event, activity, change"},{"name":"entityType","type":"string","default":"","description":"The type of entity that was modified.","synonyms":"type, kind, class"},{"name":"entityId","type":"string","default":"","description":"Unique identifier for the entity being audited.","synonyms":"entity identifier, record id, item id"},{"name":"before","type":"string","default":"","description":"The state of the entity prior to the modification, as JSON text.","synonyms":"previous, original, old value"},{"name":"after","type":"string","default":"","description":"The state of the entity after a modification, as JSON text.","synonyms":"new, updated, post, subsequent"},{"name":"recordedAt","type":"number","default":0,"description":"Timestamp indicating when the audit event was recorded.","synonyms":"timestamp, date, time"},{"name":"sourceEvent","type":"string","default":"","description":"The event that delivered the change to the audit trail, e.g. ContactSaved.","synonyms":"triggering event, cause, origin event"},{"name":"sourceTrait","type":"string","default":"","description":"The behavior that emitted the change.","synonyms":"emitter, origin, raised by"},{"name":"sourceOrbital","type":"string","default":"","description":"The module the change came from.","synonyms":"origin module, source module"},{"name":"sourceTick","type":"string","default":"","description":"The scheduled job that caused the change; blank when a person or an event did.","synonyms":"scheduled job, background job, timer"}]},"traits":[{"name":"AuditCaptureListener","id":"trt_F72EZKBG06R03AXMGTDB7KEQ32","entityRebindable":true,"entityContract":{"requires":[],"provides":["action","actor","after","before","entityId","entityType","recordedAt"]},"effectRow":[{"kind":"emit","resource":"AuditRecorded"},{"kind":"persist","resource":"AuditEntry"},{"kind":"set","resource":"@entity.action"},{"kind":"set","resource":"@entity.actor"},{"kind":"set","resource":"@entity.after"},{"kind":"set","resource":"@entity.before"},{"kind":"set","resource":"@entity.entityId"},{"kind":"set","resource":"@entity.entityType"},{"kind":"set","resource":"@entity.recordedAt"}],"category":"lifecycle","capabilities":["audit","compliance"],"linkedEntity":"AuditEntry","linkedEntityId":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","entityRefIds":{"AuditEntry":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX"},"emits":[{"event":"AuditRecorded","eventId":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","scope":"external","payloadSchema":[{"name":"actor","type":"string"},{"name":"action","type":"string"},{"name":"entityType","type":"string"},{"name":"entityId","type":"string"},{"name":"recordedAt","type":"number"},{"name":"sourceEvent","type":"string"},{"name":"sourceTrait","type":"string"},{"name":"sourceOrbital","type":"string"},{"name":"sourceTick","type":"string"}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"EntityMutated","id":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","name":"Entity mutated","payloadSchema":[{"name":"data","type":"@entity(captureEntity)"}],"listened":true},{"key":"AuditRecorded","id":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","name":"Audit recorded","payloadSchema":[{"name":"actor","type":"string"},{"name":"action","type":"string"},{"name":"entityType","type":"string"},{"name":"entityId","type":"string"},{"name":"recordedAt","type":"number"},{"name":"sourceEvent","type":"string"},{"name":"sourceTrait","type":"string"},{"name":"sourceOrbital","type":"string"},{"name":"sourceTick","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"EntityMutated","eventId":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","guard":"@config.enabled","effects":[["when",["or",["=",["array/len","@config.captureEventTypes"],0],["array/includes","@config.captureEventTypes",["object/get","@payload.data","kind","@event.event"]]],["do",["set","@entity.actor","@user.id"],["set","@entity.action",["object/get","@payload.data","kind","@event.event"]],["set","@entity.entityType","@config.captureEntity"],["set","@entity.entityId",["object/get","@payload.data","id",""]],["set","@entity.before",["if","@config.captureBeforeAfter",["json/stringify",["object/omit",["object/get","@payload.data","before",{}],"@config.excludeFields"]],""]],["set","@entity.after",["if","@config.captureBeforeAfter",["json/stringify",["object/omit",["object/get","@payload.data","after",{}],"@config.excludeFields"]],""]],["set","@entity.recordedAt",0],["persist","create","AuditEntry",{"action":"@entity.action","actor":"@user.id","after":"@entity.after","before":"@entity.before","entityId":"@entity.entityId","entityType":"@config.captureEntity","recordedAt":0,"sourceEvent":"@event.event","sourceTrait":["str/default","@event.source.trait",""],"sourceOrbital":["str/default","@event.source.orbital",""],"sourceTick":["str/default","@event.source.tick",""]}],["emit","AuditRecorded",{"action":"@entity.action","actor":"@user.id","entityId":"@entity.entityId","entityType":"@config.captureEntity","recordedAt":0,"sourceEvent":"@event.event","sourceTrait":["str/default","@event.source.trait",""],"sourceOrbital":["str/default","@event.source.orbital",""],"sourceTick":["str/default","@event.source.tick",""]}]]]]}]},"config":{"enabled":{"type":"boolean","default":false,"label":"Track every change","description":"Keep an audit trail of every change to records — who changed what, and when. Off by default.","synonyms":"enable, turn on, enforce, require, activate, apply, switch on, audit, audit trail, log changes, track changes, who edited what, mutation log, change history, edit history, modification log, accountability log, record changes, log every edit, compliance log","tier":"policy"},"captureBeforeAfter":{"type":"boolean","default":false,"label":"Store before-and-after snapshots?","description":"Store a full before-and-after snapshot of each change. More detail, but a larger audit log.","synonyms":"before after, snapshot, diff, change snapshot, field diff","tier":"policy"},"captureEventTypes":{"type":"[string]","default":[],"label":"Event-kind filter","description":"When set, only these kinds are audited: the payload's `kind` field, or the delivering event's name when there is no kind. Empty list = capture every event.","tier":"internal","items":{"type":"string"}},"excludeFields":{"type":"[string]","default":[],"label":"Skip fields","description":"Entity fields to omit from the before/after snapshots — e.g. passwords or other sensitive fields you do not want copied into the audit trail.","tier":"internal","items":{"type":"string"}},"captureEntity":{"type":"entity","default":"","label":"Entity to audit","description":"Type name of the entity whose mutations get logged","tier":"internal"}},"scope":"instance"}],"pages":[{"name":"AuditCapturePage","id":"pag_6ZYWS2CR18C0M9HBYA27T1X78N","path":"/audit-capture","traits":[{"ref":"AuditCaptureListener","refId":"trt_F72EZKBG06R03AXMGTDB7KEQ32"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX":{"id":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","kind":"entity","bakedName":"AuditEntry","curName":"AuditEntry","renames":[],"owner":"workspace"},"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50":{"id":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","kind":"event","bakedName":"EntityMutated","curName":"EntityMutated","renames":[],"owner":"workspace","parent":"trt_F72EZKBG06R03AXMGTDB7KEQ32"},"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY":{"id":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","kind":"event","bakedName":"AuditRecorded","curName":"AuditRecorded","renames":[],"owner":"workspace","parent":"trt_F72EZKBG06R03AXMGTDB7KEQ32"},"orb_D7ET0XFFENQQARN7NQG8VE4RF9":{"id":"orb_D7ET0XFFENQQARN7NQG8VE4RF9","kind":"orbital","bakedName":"AuditCaptureOrbital","curName":"AuditCaptureOrbital","renames":[],"owner":"workspace"},"pag_6ZYWS2CR18C0M9HBYA27T1X78N":{"id":"pag_6ZYWS2CR18C0M9HBYA27T1X78N","kind":"page","bakedName":"AuditCapturePage","curName":"AuditCapturePage","renames":[],"owner":"workspace"},"trt_F72EZKBG06R03AXMGTDB7KEQ32":{"id":"trt_F72EZKBG06R03AXMGTDB7KEQ32","kind":"trait","bakedName":"AuditCaptureListener","curName":"AuditCaptureListener","renames":[],"owner":"workspace"}}}}
+{"name":"std-audit-capture","version":"1.3.0","description":"std-audit-capture — event-interceptor audit log / audit trail. Use when a user voices that a record's changes must be tracked, logged, or auditable (audit trail, track changes, change history, who edited what, mutation log, record changes, log every edit, edit history, modification log, who did what when, accountability log). Listens for the generic `EntityMutated` sentinel (rename via traitOverrides.events to the real mutation event, e.g. ContactSaved) and persists an AuditEntry row capturing actor, action, entity type/id, before/after snapshots, and timestamp. `captureEventTypes` filters on @payload.data.kind, or on the delivered event's own name when the payload carries no kind (empty = capture all). Every entry also records where the change came from — the delivering event, the behavior and module that emitted it, and the scheduled job when a tick caused it — with no change to the upstream emitter. Compose with `std-lifecycle` to apply retention. Composable via `extraTraits` to interpose audit logging behind any mutating trait.","orbitals":[{"name":"AuditCaptureOrbital","id":"orb_D7ET0XFFENQQARN7NQG8VE4RF9","entity":{"name":"AuditEntry","id":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","collection":"audit_entries","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"actor","type":"string","default":"","description":"The user or system performing the action.","synonyms":"user, source, originator"},{"name":"action","type":"string","default":"","description":"The specific operation performed on the entity.","synonyms":"operation, event, activity, change"},{"name":"entityType","type":"string","default":"","description":"The type of entity that was modified.","synonyms":"type, kind, class"},{"name":"entityId","type":"string","default":"","description":"Unique identifier for the entity being audited.","synonyms":"entity identifier, record id, item id"},{"name":"before","type":"string","default":"","description":"The state of the entity prior to the modification, as JSON text.","synonyms":"previous, original, old value"},{"name":"after","type":"string","default":"","description":"The state of the entity after a modification, as JSON text.","synonyms":"new, updated, post, subsequent"},{"name":"recordedAt","type":"number","default":0,"description":"Timestamp indicating when the audit event was recorded.","synonyms":"timestamp, date, time"},{"name":"sourceEvent","type":"string","default":"","description":"The event that delivered the change to the audit trail, e.g. ContactSaved.","synonyms":"triggering event, cause, origin event"},{"name":"sourceTrait","type":"string","default":"","description":"The behavior that emitted the change.","synonyms":"emitter, origin, raised by"},{"name":"sourceOrbital","type":"string","default":"","description":"The module the change came from.","synonyms":"origin module, source module"},{"name":"sourceTick","type":"string","default":"","description":"The scheduled job that caused the change; blank when a person or an event did.","synonyms":"scheduled job, background job, timer"}]},"traits":[{"name":"AuditCaptureListener","id":"trt_F72EZKBG06R03AXMGTDB7KEQ32","entityRebindable":true,"entityContract":{"requires":[],"provides":["action","actor","after","before","entityId","entityType","recordedAt"]},"effectRow":[{"kind":"emit","resource":"AuditRecorded"},{"kind":"persist","resource":"AuditEntry"},{"kind":"set","resource":"@entity.action"},{"kind":"set","resource":"@entity.actor"},{"kind":"set","resource":"@entity.after"},{"kind":"set","resource":"@entity.before"},{"kind":"set","resource":"@entity.entityId"},{"kind":"set","resource":"@entity.entityType"},{"kind":"set","resource":"@entity.recordedAt"}],"category":"lifecycle","capabilities":["audit","compliance"],"linkedEntity":"AuditEntry","linkedEntityId":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","entityRefIds":{"AuditEntry":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX"},"emits":[{"event":"AuditRecorded","eventId":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","scope":"external","payloadSchema":[{"name":"actor","type":"string"},{"name":"action","type":"string"},{"name":"entityType","type":"string"},{"name":"entityId","type":"string"},{"name":"recordedAt","type":"number"},{"name":"sourceEvent","type":"string"},{"name":"sourceTrait","type":"string"},{"name":"sourceOrbital","type":"string"},{"name":"sourceTick","type":"string"}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"EntityMutated","id":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","name":"Entity mutated","payloadSchema":[{"name":"data","type":"@entity(captureEntity)"}],"listened":true},{"key":"AuditRecorded","id":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","name":"Audit recorded","payloadSchema":[{"name":"actor","type":"string"},{"name":"action","type":"string"},{"name":"entityType","type":"string"},{"name":"entityId","type":"string"},{"name":"recordedAt","type":"number"},{"name":"sourceEvent","type":"string"},{"name":"sourceTrait","type":"string"},{"name":"sourceOrbital","type":"string"},{"name":"sourceTick","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"EntityMutated","eventId":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","guard":"@config.enabled","effects":[["when",["or",["=",["array/len","@config.captureEventTypes"],0],["array/includes","@config.captureEventTypes",["object/get","@payload.data","kind","@event.event"]]],["do",["set","@entity.actor","@user.id"],["set","@entity.action",["object/get","@payload.data","kind","@event.event"]],["set","@entity.entityType","@config.captureEntity"],["set","@entity.entityId",["object/get","@payload.data","id",""]],["set","@entity.before",["if","@config.captureBeforeAfter",["json/stringify",["object/omit",["object/get","@payload.data","before",{}],"@config.excludeFields"]],""]],["set","@entity.after",["if","@config.captureBeforeAfter",["json/stringify",["object/omit",["object/get","@payload.data","after",{}],"@config.excludeFields"]],""]],["set","@entity.recordedAt",0],["persist","create","AuditEntry",{"action":"@entity.action","actor":"@user.id","after":"@entity.after","before":"@entity.before","entityId":"@entity.entityId","entityType":"@config.captureEntity","recordedAt":0,"sourceEvent":"@event.event","sourceTrait":["str/default","@event.source.trait",""],"sourceOrbital":["str/default","@event.source.orbital",""],"sourceTick":["str/default","@event.source.tick",""]}],["emit","AuditRecorded",{"action":"@entity.action","actor":"@user.id","entityId":"@entity.entityId","entityType":"@config.captureEntity","recordedAt":0,"sourceEvent":"@event.event","sourceTrait":["str/default","@event.source.trait",""],"sourceOrbital":["str/default","@event.source.orbital",""],"sourceTick":["str/default","@event.source.tick",""]}]]]]}]},"config":{"captureEventTypes":{"type":"[string]","default":[],"label":"Event-kind filter","description":"When set, only these kinds are audited: the payload's `kind` field, or the delivering event's name when there is no kind. Empty list = capture every event.","tier":"internal","items":{"type":"string"}},"enabled":{"type":"boolean","default":false,"label":"Track every change","description":"Keep an audit trail of every change to records — who changed what, and when. Off by default.","synonyms":"enable, turn on, enforce, require, activate, apply, switch on, audit, audit trail, log changes, track changes, who edited what, mutation log, change history, edit history, modification log, accountability log, record changes, log every edit, compliance log","tier":"policy"},"captureEntity":{"type":"entity","default":"","label":"Entity to audit","description":"Type name of the entity whose mutations get logged","tier":"internal"},"excludeFields":{"type":"[string]","default":[],"label":"Skip fields","description":"Entity fields to omit from the before/after snapshots — e.g. passwords or other sensitive fields you do not want copied into the audit trail.","tier":"internal","items":{"type":"string"}},"captureBeforeAfter":{"type":"boolean","default":false,"label":"Store before-and-after snapshots?","description":"Store a full before-and-after snapshot of each change. More detail, but a larger audit log.","synonyms":"before after, snapshot, diff, change snapshot, field diff","tier":"policy"}},"scope":"instance"}],"pages":[{"name":"AuditCapturePage","id":"pag_6ZYWS2CR18C0M9HBYA27T1X78N","path":"/audit-capture","traits":[{"ref":"AuditCaptureListener","refId":"trt_F72EZKBG06R03AXMGTDB7KEQ32"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX":{"id":"ent_52WH1WQ71DKGPJCXHJZBAEQ6BX","kind":"entity","bakedName":"AuditEntry","curName":"AuditEntry","renames":[],"owner":"workspace"},"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50":{"id":"evt_3TKNDQS2X4HEJ8SBNGCQGRSS50","kind":"event","bakedName":"EntityMutated","curName":"EntityMutated","renames":[],"owner":"workspace","parent":"trt_F72EZKBG06R03AXMGTDB7KEQ32"},"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY":{"id":"evt_4WTB9JQT8KX49VZXGWXR9Z8BCY","kind":"event","bakedName":"AuditRecorded","curName":"AuditRecorded","renames":[],"owner":"workspace","parent":"trt_F72EZKBG06R03AXMGTDB7KEQ32"},"orb_D7ET0XFFENQQARN7NQG8VE4RF9":{"id":"orb_D7ET0XFFENQQARN7NQG8VE4RF9","kind":"orbital","bakedName":"AuditCaptureOrbital","curName":"AuditCaptureOrbital","renames":[],"owner":"workspace"},"pag_6ZYWS2CR18C0M9HBYA27T1X78N":{"id":"pag_6ZYWS2CR18C0M9HBYA27T1X78N","kind":"page","bakedName":"AuditCapturePage","curName":"AuditCapturePage","renames":[],"owner":"workspace"},"trt_F72EZKBG06R03AXMGTDB7KEQ32":{"id":"trt_F72EZKBG06R03AXMGTDB7KEQ32","kind":"trait","bakedName":"AuditCaptureListener","curName":"AuditCaptureListener","renames":[],"owner":"workspace"}}}}