@almadar/std 16.215.0 → 16.217.0

package/dist/behaviors-registry.json

@@ -1,13 +1,13 @@
 {
-  "$generated": "2026-09-13T02:15:16.706Z",
+  "$generated": "2026-09-15T07:17:39.933Z",
   "$source": "tools/almadar-pattern-sync/behaviors",
   "$package": "@almadar/std",
-  "totalBehaviors": 463,
-  "atoms": 299,
+  "totalBehaviors": 467,
+  "atoms": 303,
   "molecules": 111,
   "organisms": 53,
   "layers": {
-    "UI Patterns": 450,
+    "UI Patterns": 454,
     "ML": 13
   },
   "behaviors": {
@@ -73,6 +73,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -354,6 +355,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -727,6 +729,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -1025,6 +1028,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -1399,6 +1403,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -1700,6 +1705,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -2067,6 +2073,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -2348,6 +2355,7 @@
         "std-circuit-breaker",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -2884,6 +2892,7 @@
         "std-civics-gerrymander",
         "std-coding-academy",
         "std-cooldown",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -3231,6 +3240,7 @@
         "std-civics-gerrymander",
         "std-coding-academy",
         "std-cooldown",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -3610,13 +3620,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -3848,8 +3862,10 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-gallery",
         "std-game-clock",
+        "std-global-search",
         "std-helpdesk-ticket",
         "std-integration-settings",
         "std-inventory",
@@ -3861,7 +3877,9 @@
         "std-moderation-rule",
         "std-notification-center",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rate-limiter",
@@ -4618,13 +4636,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -4889,13 +4911,18 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
+        "std-executive-dashboard",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -6082,13 +6109,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -6484,13 +6515,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -6778,12 +6813,14 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
         "std-form-advanced",
         "std-game-clock",
         "std-geo-vonthunen",
+        "std-global-search",
         "std-graph-builder",
         "std-hist-ccot",
         "std-hist-sourcing",
@@ -6815,7 +6852,9 @@
         "std-ml-similarity",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-physics-diagram",
         "std-physics-field-3d",
         "std-physics-orbit-3d",
@@ -7583,13 +7622,17 @@
         "std-coding-academy",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -7793,13 +7836,17 @@
         "std-circuit-breaker",
         "std-cooldown",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -8041,8 +8088,10 @@
         "std-confirmation",
         "std-cooldown",
         "std-cross-reference",
+        "std-data-import",
         "std-gallery",
         "std-game-clock",
+        "std-global-search",
         "std-helpdesk-ticket",
         "std-integration-settings",
         "std-inventory",
@@ -8054,7 +8103,9 @@
         "std-moderation-rule",
         "std-notification-center",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rate-limiter",
@@ -8608,6 +8659,420 @@
       ],
       "sourceValid": true
     },
+    "std-data-import": {
+      "name": "std-data-import",
+      "level": "atom",
+      "topic": "infra",
+      "family": "infra",
+      "layer": "UI Patterns",
+      "description": "std-data-import — staged CSV import run, source-agnostic: upload → staged review → confirm → handoff. UPLOAD_CSV opens a run and persists an ImportBatch row (status uploaded, fieldMappingJson recorded verbatim for provenance); the host's file UI parses the CSV and answers with STAGE_ROWS, one JSON string per raw row, which the atom bulk-persists into import_rows against the batch id and presents as a staged review (row/error counts + Confirm/Discard). CONFIRM_IMPORT marks the batch confirmed and emits IMPORT_CONFIRMED { batchId, sourceName, rowCount } — the mapping+persist half is the CONSUMER organism's: it listens for IMPORT_CONFIRMED, fetches import_rows where batchId matches, maps each rowJson through its own field mapping, and persists into its own target entity (cross-atom persist into a consumer's entity is not expressible from here). This is deliberately the CSV-file path: the atom never calls a source service — sourceName/fieldMappingJson/targetEntity/historyWindowDays are declarative consumer configs, and any persist failure lands in failed with IMPORT_FAILED, never a silent swallow. Compose with std-import for the file-picker menu.",
+      "defaultOrbitalName": "DataImportOrbital",
+      "statePattern": "confirmed, failed, idle, staged, uploaded",
+      "complexity": {
+        "states": 5,
+        "events": 11,
+        "transitions": 15
+      },
+      "defaultEntity": {
+        "name": "ImportBatch",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "sourceName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "uploaded"
+          },
+          {
+            "name": "rowCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "errorCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "mappingJson",
+            "type": "string",
+            "default": "{}"
+          },
+          {
+            "name": "createdAt",
+            "type": "number",
+            "default": 0
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "ImportBatchs",
+        "entitySingular": "ImportBatch",
+        "entityPlural": "ImportBatchs"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "std-agent-builder",
+        "std-agent-completion",
+        "std-agent-context",
+        "std-agent-fix-loop",
+        "std-agent-memory",
+        "std-agent-planner",
+        "std-agent-rabit",
+        "std-agent-session",
+        "std-agent-tool-call",
+        "std-agent-tool-loop",
+        "std-algo-bst",
+        "std-algo-dp",
+        "std-algo-hashing",
+        "std-algo-queue",
+        "std-algo-stack",
+        "std-anim-tick",
+        "std-approval-gate",
+        "std-astro-orbit-3d",
+        "std-audit-capture",
+        "std-bio-cell-3d",
+        "std-cache-aside",
+        "std-calendar-sync",
+        "std-cascade-on-delete",
+        "std-circuit-breaker",
+        "std-civics-electoral",
+        "std-civics-gerrymander",
+        "std-cooldown",
+        "std-cross-reference",
+        "std-data-erasure",
+        "std-econ-gdp",
+        "std-econ-phillips",
+        "std-escalating-decision",
+        "std-form-advanced",
+        "std-game-clock",
+        "std-geo-vonthunen",
+        "std-global-search",
+        "std-graph-builder",
+        "std-hist-ccot",
+        "std-hist-sourcing",
+        "std-import",
+        "std-integration-settings",
+        "std-learn-coupled-sim",
+        "std-learn-derivation",
+        "std-learn-doser",
+        "std-learn-goal-seek",
+        "std-learn-grid-sim",
+        "std-learn-live-sim",
+        "std-learn-measure",
+        "std-learn-perturb",
+        "std-learn-sample-accumulator",
+        "std-learn-sandbox",
+        "std-learn-scatter-fit",
+        "std-learn-sim-3d",
+        "std-learn-tour-3d",
+        "std-learn-transport",
+        "std-learn-tree",
+        "std-lifecycle",
+        "std-ling-morphology",
+        "std-logic-inference",
+        "std-logic-venn",
+        "std-migration-job",
+        "std-ml-classify",
+        "std-ml-exact-check",
+        "std-ml-infer",
+        "std-ml-lookup",
+        "std-ml-similarity",
+        "std-mod-queue",
+        "std-notification-center",
+        "std-notification-preferences",
+        "std-notify-on-event",
+        "std-permission-matrix",
+        "std-physics-diagram",
+        "std-physics-field-3d",
+        "std-physics-orbit-3d",
+        "std-physics-projectile-3d",
+        "std-physics-wave-3d",
+        "std-prob-regression",
+        "std-psych-memory",
+        "std-psych-operant",
+        "std-psych-signal",
+        "std-psych-stroop",
+        "std-rate-limiter",
+        "std-reminder-scheduler",
+        "std-row-access-control",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "std-soc-conformity",
+        "std-soc-mobility",
+        "std-soc-network",
+        "std-status-lifecycle",
+        "std-status-lifecycle-control",
+        "std-tokenizer",
+        "std-weight-validator",
+        "ui-sports-board"
+      ],
+      "connectableEvents": [
+        "UPLOAD_CSV",
+        "BATCH_CREATED",
+        "STAGE_ROWS",
+        "IMPORT_PERSIST_FAILED",
+        "DISCARD_IMPORT",
+        "ROWS_STAGED",
+        "CONFIRM_IMPORT",
+        "RESET",
+        "IMPORT_CONFIRMED",
+        "IMPORT_FAILED"
+      ],
+      "eventPayloads": {},
+      "exposure": "both",
+      "provenance": "authored",
+      "traits": [
+        {
+          "name": "DataImportLifecycle",
+          "orbital": "DataImportOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "BATCH_CREATED",
+            "ROWS_STAGED",
+            "IMPORT_PERSIST_FAILED",
+            "IMPORT_CONFIRMED",
+            "IMPORT_FAILED"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "fieldMappingJson",
+              "type": "string",
+              "default": "{}",
+              "label": "Field mapping (JSON)",
+              "description": "JSON object mapping source CSV column names to target field names. Stored verbatim on the batch row (mappingJson) so the consumer's mapping layer applies the same mapping when it persists staged rows into the target entity.",
+              "synonyms": "field mapping, column mapping, map columns, remap fields, csv columns",
+              "tier": "domain"
+            },
+            {
+              "key": "historyWindowDays",
+              "type": "number",
+              "default": 0,
+              "label": "Historical data range (days)",
+              "description": "How many days back an import may reach (0 = unbounded). A declared import-config knob for the consumer's staging/mapping layer — the atom stages whatever rows it is handed and never filters by date.",
+              "synonyms": "history window, historical range, import range, days back, lookback period",
+              "tier": "policy"
+            },
+            {
+              "key": "sourceName",
+              "type": "string",
+              "default": "",
+              "label": "Source name",
+              "description": "Free-form name of the upstream source this import pulls from — whatever tool or file export the user names. Recorded on the batch row for provenance and echoed on IMPORT_CONFIRMED.",
+              "synonyms": "source, origin, import from, provider name, data source",
+              "tier": "domain"
+            },
+            {
+              "key": "targetEntity",
+              "type": "string",
+              "default": "",
+              "label": "Target entity",
+              "description": "Name of the consumer organism's entity the staged rows land in after confirm. Declarative contract only — the atom never writes the target entity; the consumer persists on IMPORT_CONFIRMED.",
+              "synonyms": "destination, import into, target type",
+              "tier": "domain"
+            }
+          ],
+          "capabilities": [
+            "import"
+          ],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "lifecycle",
+          "entityRebindable": true,
+          "linkedEntity": "ImportBatch",
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "errorCount",
+              "mappingJson",
+              "rowCount",
+              "sourceName",
+              "status"
+            ]
+          },
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "IMPORT_CONFIRMED"
+            },
+            {
+              "kind": "emit",
+              "resource": "IMPORT_FAILED"
+            },
+            {
+              "kind": "persist",
+              "resource": "ImportBatch"
+            },
+            {
+              "kind": "persist",
+              "resource": "ImportRow"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.createdAt"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.errorCount"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.id"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.mappingJson"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.rowCount"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.sourceName"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.status"
+            }
+          ],
+          "transitionEvents": [
+            "BATCH_CREATED",
+            "CONFIRM_IMPORT",
+            "DISCARD_IMPORT",
+            "IMPORT_CONFIRMED",
+            "IMPORT_FAILED",
+            "IMPORT_PERSIST_FAILED",
+            "INIT",
+            "RESET",
+            "ROWS_STAGED",
+            "STAGE_ROWS",
+            "UPLOAD_CSV"
+          ],
+          "events": [
+            {
+              "name": "BATCH_CREATED",
+              "direction": "emit",
+              "description": "import_batches persist-create success — the payload carries the created row's id, captured onto the trait entity so staged rows can reference batchId",
+              "tier": "secondary"
+            },
+            {
+              "name": "ROWS_STAGED",
+              "direction": "emit",
+              "description": "import_rows bulk persist-create success signal — payload carries the persisted rows flat; the atom never reads it (self-loop only)",
+              "tier": "secondary"
+            },
+            {
+              "name": "IMPORT_PERSIST_FAILED",
+              "direction": "emit",
+              "description": "Any import_batches / import_rows persist failure — lands the run in failed, never a silent swallow",
+              "tier": "secondary"
+            },
+            {
+              "name": "IMPORT_CONFIRMED",
+              "direction": "emit",
+              "description": "The user confirmed the staged review and the batch row is persisted as confirmed. Consumers listen, fetch import_rows where batchId matches, map each rowJson through their field mapping, and persist into their own target entity.",
+              "synonyms": "import confirmed, commit import, accept staged rows, approve import",
+              "tier": "domain"
+            },
+            {
+              "name": "IMPORT_FAILED",
+              "direction": "emit",
+              "description": "The run failed (persist failure or empty staging); error carries the detail and the batch row was updated to failed",
+              "synonyms": "import failed, upload failed, staging failed",
+              "tier": "domain"
+            },
+            {
+              "name": "INIT",
+              "direction": "listen"
+            },
+            {
+              "name": "UPLOAD_CSV",
+              "direction": "listen",
+              "description": "Starts an import run for a CSV file upload. The host's file UI (e.g. a sibling std-import menu) only announces the upload — parsing is host work and arrives as STAGE_ROWS.",
+              "synonyms": "upload csv, import csv, start import, import file, bulk import",
+              "tier": "domain"
+            },
+            {
+              "name": "STAGE_ROWS",
+              "direction": "listen",
+              "description": "Host-side CSV parsing finished: rows carries one JSON string per parsed row (raw source shape, pre-mapping); errorCount counts rows the parser flagged. The atom bulk-persists them into import_rows and opens the staged review.",
+              "tier": "internal"
+            },
+            {
+              "name": "DISCARD_IMPORT",
+              "direction": "listen",
+              "description": "The user discarded the staged run before confirm; the batch row stays for provenance.",
+              "tier": "internal"
+            },
+            {
+              "name": "CONFIRM_IMPORT",
+              "direction": "listen",
+              "description": "The user approved the staged review; the batch is marked confirmed and IMPORT_CONFIRMED fires for the consumer's mapping+persist half.",
+              "synonyms": "confirm import, approve staged rows, accept import",
+              "tier": "domain"
+            },
+            {
+              "name": "RESET",
+              "direction": "listen",
+              "description": "Returns the atom to idle from a terminal state",
+              "tier": "internal"
+            }
+          ],
+          "definerKnobs": []
+        }
+      ],
+      "factoryPath": "behaviors/functions/infra/atoms/std-data-import.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
     "std-game-clock": {
       "name": "std-game-clock",
       "level": "atom",
@@ -8660,7 +9125,9 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-drip-sequence",
+        "std-global-search",
         "std-integration-settings",
         "std-learn-coupled-sim",
         "std-learn-grid-sim",
@@ -8673,7 +9140,9 @@
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-physics-projectile-3d",
         "std-rate-limiter",
         "std-reminder-scheduler",
@@ -8804,6 +9273,516 @@
       ],
       "sourceValid": true
     },
+    "std-global-search": {
+      "name": "std-global-search",
+      "level": "atom",
+      "topic": "infra",
+      "family": "infra",
+      "layer": "UI Patterns",
+      "description": "std-global-search — cross-module federated search. Use when a user voices that one search box should query several modules at once (global search, search everything, unified search, cross-module search, federated search, search across records, omnisearch, one search box, aggregated results, grouped results). One SEARCH event fans out to every module key listed in the `modules` config (comma-separated, deterministic — no registry magic): the trait walks the parsed key list with an internal FAN_OUT_STEP sentinel and emits one scoped MODULE_SEARCH_REQUESTED { moduleKey, queryText, typeFilter, scopeJson } -> external per key, so modules respond in parallel rather than in sequence. Modules answer with SEARCH_RESULTS { moduleKey, resultsJson }; each answer appends a SearchResultGroup to the entity, so the merged view stays grouped by module. Client/person/date/type filters ride `scopeJson` — the atom never interprets them. Every query persists as a SearchQuery row (recent/saved searches) when `saveHistory` is on. The input is the mapped `search-input` type rendered inline with event renamed to SEARCH (the std-geosearch idiom); its native {searchTerm}/{value} payloads are bridged via str/default, so programmatic SEARCH { queryText, typeFilter, scopeJson } emitters and the UI box drive the same arm.",
+      "defaultOrbitalName": "GlobalSearchOrbital",
+      "statePattern": "idle, searching",
+      "complexity": {
+        "states": 2,
+        "events": 8,
+        "transitions": 8
+      },
+      "defaultEntity": {
+        "name": "SearchQuery",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "personId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "queryText",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "typeFilter",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "scopeJson",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "createdAt",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "pendingModules",
+            "type": "array",
+            "default": []
+          },
+          {
+            "name": "requestedCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "respondedCount",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "fanOutDone",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "searching",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "results",
+            "type": "array",
+            "default": []
+          },
+          {
+            "name": "resultsSummary",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "savedQueryId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "lastError",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "SearchQuerys",
+        "entitySingular": "SearchQuery",
+        "entityPlural": "SearchQuerys"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "std-anim-tick",
+        "std-app-layout",
+        "std-approval-gate",
+        "std-audit-capture",
+        "std-cache-aside",
+        "std-calendar-sync",
+        "std-cascade-on-delete",
+        "std-circuit-breaker",
+        "std-cooldown",
+        "std-cross-reference",
+        "std-data-erasure",
+        "std-data-import",
+        "std-game-clock",
+        "std-integration-settings",
+        "std-lifecycle",
+        "std-migration-job",
+        "std-mod-queue",
+        "std-notification-center",
+        "std-notification-preferences",
+        "std-notify-on-event",
+        "std-permission-matrix",
+        "std-rate-limiter",
+        "std-reminder-scheduler",
+        "std-row-access-control",
+        "std-search",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "std-status-lifecycle",
+        "std-status-lifecycle-control",
+        "ui-search-input"
+      ],
+      "connectableEvents": [
+        "SEARCH",
+        "FAN_OUT_STEP",
+        "SEARCH_RESULTS",
+        "QUERY_SAVED",
+        "QUERY_SAVE_FAILED",
+        "MODULE_SEARCH_REQUESTED",
+        "GLOBAL_SEARCH_COMPLETED"
+      ],
+      "eventPayloads": {},
+      "exposure": "both",
+      "provenance": "authored",
+      "traits": [
+        {
+          "name": "GlobalSearch",
+          "orbital": "GlobalSearchOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "SEARCH",
+            "MODULE_SEARCH_REQUESTED",
+            "GLOBAL_SEARCH_COMPLETED",
+            "QUERY_SAVED",
+            "QUERY_SAVE_FAILED",
+            "FAN_OUT_STEP"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "modules",
+              "type": "string",
+              "default": "",
+              "label": "Modules to search",
+              "description": "Comma-separated module keys to fan each query out to (e.g. \"contacts,projects,invoices\"). Each key gets one scoped MODULE_SEARCH_REQUESTED; the module owning a key subscribes to it and answers with SEARCH_RESULTS. Empty = no fan-out (the query is still persisted to history).",
+              "synonyms": "search modules, search scope, sources, providers, search providers, indexes, search targets, modules",
+              "tier": "internal"
+            },
+            {
+              "key": "placeholder",
+              "type": "string",
+              "default": "Search across modules…",
+              "label": "Search placeholder",
+              "description": "Hint text in the search input.",
+              "synonyms": "placeholder, hint text, input hint",
+              "tier": "presentation"
+            },
+            {
+              "key": "saveHistory",
+              "type": "boolean",
+              "default": true,
+              "label": "Keep recent searches",
+              "description": "Persist each query as a SearchQuery row so recent and saved searches survive reloads.",
+              "synonyms": "search history, recent searches, saved searches, remember searches, keep history",
+              "tier": "policy"
+            }
+          ],
+          "capabilities": [
+            "discovery",
+            "search"
+          ],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "lifecycle",
+          "entityRebindable": true,
+          "linkedEntity": "SearchQuery",
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "fanOutDone",
+              "lastError",
+              "pendingModules",
+              "personId",
+              "queryText",
+              "requestedCount",
+              "respondedCount",
+              "results",
+              "resultsSummary",
+              "savedQueryId",
+              "scopeJson",
+              "searching",
+              "typeFilter"
+            ]
+          },
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "FAN_OUT_STEP"
+            },
+            {
+              "kind": "emit",
+              "resource": "GLOBAL_SEARCH_COMPLETED"
+            },
+            {
+              "kind": "emit",
+              "resource": "MODULE_SEARCH_REQUESTED"
+            },
+            {
+              "kind": "fetch",
+              "resource": "SearchQuery"
+            },
+            {
+              "kind": "persist",
+              "resource": "SearchQuery"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "toast"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.createdAt"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.fanOutDone"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.lastError"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.pendingModules"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.personId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.queryText"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.requestedCount"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.respondedCount"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.results"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.resultsSummary"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.savedQueryId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.scopeJson"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.searching"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.typeFilter"
+            }
+          ],
+          "transitionEvents": [
+            "FAN_OUT_STEP",
+            "INIT",
+            "QUERY_SAVED",
+            "QUERY_SAVE_FAILED",
+            "SEARCH",
+            "SEARCH_RESULTS"
+          ],
+          "events": [
+            {
+              "name": "SEARCH",
+              "direction": "emit",
+              "description": "The query as submitted — re-broadcast so downstream listeners (recent-searches trays, analytics) can react without intercepting the input",
+              "tier": "essential"
+            },
+            {
+              "name": "MODULE_SEARCH_REQUESTED",
+              "direction": "emit",
+              "description": "One per configured module key — the module owning that key runs its own search and answers with SEARCH_RESULTS",
+              "tier": "essential"
+            },
+            {
+              "name": "GLOBAL_SEARCH_COMPLETED",
+              "direction": "emit",
+              "description": "Every requested module has answered; the grouped view is final",
+              "tier": "secondary"
+            },
+            {
+              "name": "QUERY_SAVED",
+              "direction": "emit",
+              "description": "The query persisted to search history",
+              "tier": "secondary"
+            },
+            {
+              "name": "QUERY_SAVE_FAILED",
+              "direction": "emit",
+              "description": "Persisting the query failed — the search itself is unaffected",
+              "tier": "secondary"
+            },
+            {
+              "name": "FAN_OUT_STEP",
+              "direction": "emit",
+              "description": "Internal sentinel draining the module queue, one MODULE_SEARCH_REQUESTED per pass",
+              "tier": "internal"
+            },
+            {
+              "name": "INIT",
+              "direction": "listen"
+            },
+            {
+              "name": "SEARCH_RESULTS",
+              "direction": "listen"
+            }
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "InlineTypographyRender1",
+          "orbital": "GlobalSearchOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "color",
+              "type": "unknown",
+              "default": "muted"
+            },
+            {
+              "key": "content",
+              "type": "unknown",
+              "default": "Search across every connected module — results group by module."
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "caption"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Typography.traits.TypographyRender",
+          "category": "interaction",
+          "linkedEntity": "SearchQuery",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "InlineSpinnerRender2",
+          "orbital": "GlobalSearchOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Spinner.traits.SpinnerRender",
+          "category": "interaction",
+          "linkedEntity": "SearchQuery",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "InlineTypographyRender3",
+          "orbital": "GlobalSearchOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "color",
+              "type": "unknown",
+              "default": "muted"
+            },
+            {
+              "key": "content",
+              "type": "unknown",
+              "default": "Searching…"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "caption"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Typography.traits.TypographyRender",
+          "category": "interaction",
+          "linkedEntity": "SearchQuery",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "InlineTypographyRender4",
+          "orbital": "GlobalSearchOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "content",
+              "type": "unknown",
+              "default": "@entity.resultsSummary"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "body"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Typography.traits.TypographyRender",
+          "category": "interaction",
+          "linkedEntity": "SearchQuery",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        }
+      ],
+      "factoryPath": "behaviors/functions/infra/atoms/std-global-search.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
     "std-lifecycle": {
       "name": "std-lifecycle",
       "level": "atom",
@@ -8881,12 +9860,16 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -9228,6 +10211,7 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -9235,6 +10219,7 @@
         "std-gallery",
         "std-game-clock",
         "std-geo-vonthunen",
+        "std-global-search",
         "std-graph-builder",
         "std-helpdesk-ticket",
         "std-hist-ccot",
@@ -9271,7 +10256,9 @@
         "std-moderation-rule",
         "std-notification-center",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-physics-diagram",
         "std-physics-field-3d",
         "std-physics-orbit-3d",
@@ -9767,9 +10754,11 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-dunning",
         "std-gallery",
         "std-game-clock",
+        "std-global-search",
         "std-helpdesk-ticket",
         "std-integration-settings",
         "std-inventory",
@@ -9780,7 +10769,9 @@
         "std-moderation-rule",
         "std-notification-center",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rate-limiter",
@@ -10329,12 +11320,16 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -10757,6 +11752,512 @@
       ],
       "sourceValid": true
     },
+    "std-notification-preferences": {
+      "name": "std-notification-preferences",
+      "level": "atom",
+      "topic": "infra",
+      "family": "infra",
+      "layer": "UI Patterns",
+      "description": "std-notification-preferences — per-person notification preference store plus a consultable gate. Owns NotificationPreference rows (one per person + event key: channel override in_app/email/push/slack, mode instant/digest, quiet-hours window 'HH:MM-HH:MM' such as 22:00-07:00). The PreferencesManage trait is standard CRUD over the store (list / create / update / delete, persisted, success/failure cascade arms). The PreferenceGate trait is the consult half other notify traits call: emit CHECK_PREFERENCE { personId, eventKey } and the gate fetches the matching row (a row whose eventKey is blank applies to every event) and answers PREFERENCE_RESOLVED { personId, eventKey, channel, mode, suppressed } — suppressed is true only when the row's quietHours window covers the current hour; mode 'digest' rides on the verdict for the caller to defer. Default policy: no matching row — or a failed lookup — resolves fail-open to { channel: in_app, mode: instant, suppressed: false }; the absence of a preference never silences a notification.",
+      "defaultOrbitalName": "NotificationPreferencesOrbital",
+      "statePattern": "browsing, creating, editing, error, loading",
+      "complexity": {
+        "states": 5,
+        "events": 16,
+        "transitions": 26
+      },
+      "defaultEntity": {
+        "name": "NotificationPreference",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "personId",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "eventKey",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "channel",
+            "type": "string",
+            "default": "in_app"
+          },
+          {
+            "name": "mode",
+            "type": "string",
+            "default": "instant"
+          },
+          {
+            "name": "quietHours",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "createdAt",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "updatedAt",
+            "type": "number",
+            "default": 0
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "NotificationPreferences",
+        "entitySingular": "NotificationPreference",
+        "entityPlural": "NotificationPreferences"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "std-anim-tick",
+        "std-application",
+        "std-approval-gate",
+        "std-approval-request",
+        "std-arcade-board-3d",
+        "std-audit-capture",
+        "std-broadcast-builder",
+        "std-browse",
+        "std-builder",
+        "std-cache-aside",
+        "std-calendar-sync",
+        "std-cascade-on-delete",
+        "std-circuit-breaker",
+        "std-confirmation",
+        "std-cooldown",
+        "std-crew-board-2d",
+        "std-cross-reference",
+        "std-data-erasure",
+        "std-data-import",
+        "std-event",
+        "std-form-advanced",
+        "std-game-clock",
+        "std-global-search",
+        "std-image-upload-multi",
+        "std-integration-settings",
+        "std-lifecycle",
+        "std-list",
+        "std-market-board-3d",
+        "std-menu",
+        "std-migration-job",
+        "std-mod-queue",
+        "std-modal",
+        "std-modal-editor",
+        "std-modifier-group",
+        "std-notification-center",
+        "std-notify-on-event",
+        "std-objective-board-3d",
+        "std-permission-matrix",
+        "std-purchase-order",
+        "std-rate-limiter",
+        "std-record-detail",
+        "std-reminder-scheduler",
+        "std-row-access-control",
+        "std-saved-search",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "std-status-lifecycle",
+        "std-status-lifecycle-control",
+        "std-survival-board-3d",
+        "std-tactics-board-2d",
+        "std-tactics-board-3d",
+        "std-trade-order",
+        "std-vendor-onboarding",
+        "std-waitlist",
+        "std-wizard",
+        "std-work-order",
+        "studio-canvas",
+        "ui-code-block",
+        "ui-minigolf-board-3d",
+        "ui-pirate-board"
+      ],
+      "connectableEvents": [
+        "PreferencesLoaded",
+        "PreferencesLoadFailed",
+        "NEW",
+        "EDIT",
+        "DELETE",
+        "PreferenceSaved",
+        "PreferenceDeleted",
+        "PreferenceSaveFailed",
+        "SET_PERSON_ID",
+        "SET_EVENT_KEY",
+        "SET_CHANNEL",
+        "SET_MODE",
+        "SET_QUIET_HOURS",
+        "SAVE",
+        "CANCEL"
+      ],
+      "eventPayloads": {},
+      "exposure": "both",
+      "provenance": "authored",
+      "traits": [
+        {
+          "name": "PreferencesManage",
+          "orbital": "NotificationPreferencesOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "NEW",
+            "EDIT",
+            "DELETE",
+            "SAVE",
+            "CANCEL",
+            "SET_PERSON_ID",
+            "SET_EVENT_KEY",
+            "SET_CHANNEL",
+            "SET_MODE",
+            "SET_QUIET_HOURS",
+            "PreferencesLoaded",
+            "PreferencesLoadFailed",
+            "PreferenceSaved",
+            "PreferenceSaveFailed",
+            "PreferenceDeleted"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "tableLook",
+              "type": "string",
+              "default": "dense",
+              "label": "Table look",
+              "description": "Layer 2 visual treatment for the preference data table rendered by this atom.",
+              "tier": "presentation",
+              "enumValues": [
+                "dense",
+                "spacious",
+                "striped",
+                "borderless",
+                "card-rows"
+              ]
+            },
+            {
+              "key": "title",
+              "type": "string",
+              "default": "Notification preferences",
+              "label": "Section title",
+              "description": "Heading shown above the preference list",
+              "tier": "presentation"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "interaction",
+          "linkedEntity": "NotificationPreference",
+          "effectRow": [
+            {
+              "kind": "fetch",
+              "resource": "NotificationPreference"
+            },
+            {
+              "kind": "persist",
+              "resource": "NotificationPreference"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.channel"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.createdAt"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.eventKey"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.id"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.mode"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.personId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.quietHours"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.updatedAt"
+            }
+          ],
+          "transitionEvents": [
+            "CANCEL",
+            "DELETE",
+            "EDIT",
+            "INIT",
+            "NEW",
+            "PreferenceDeleted",
+            "PreferenceSaveFailed",
+            "PreferenceSaved",
+            "PreferencesLoadFailed",
+            "PreferencesLoaded",
+            "SAVE",
+            "SET_CHANNEL",
+            "SET_EVENT_KEY",
+            "SET_MODE",
+            "SET_PERSON_ID",
+            "SET_QUIET_HOURS"
+          ],
+          "events": [
+            {
+              "name": "NEW",
+              "direction": "emit",
+              "description": "Opens the blank preference form.",
+              "synonyms": "add, create, new preference",
+              "tier": "presentation"
+            },
+            {
+              "name": "EDIT",
+              "direction": "emit",
+              "description": "Opens a preference row in the edit form.",
+              "synonyms": "modify, update, change",
+              "tier": "presentation"
+            },
+            {
+              "name": "DELETE",
+              "direction": "emit",
+              "description": "Removes a preference row.",
+              "synonyms": "remove, discard, clear",
+              "tier": "presentation"
+            },
+            {
+              "name": "SAVE",
+              "direction": "emit",
+              "description": "Persists the preference form.",
+              "synonyms": "persist, store, commit",
+              "tier": "domain"
+            },
+            {
+              "name": "CANCEL",
+              "direction": "emit",
+              "description": "Aborts the preference form.",
+              "synonyms": "abort, dismiss, undo",
+              "tier": "domain"
+            },
+            {
+              "name": "SET_PERSON_ID",
+              "direction": "emit",
+              "description": "Preference form: person id changed.",
+              "tier": "internal"
+            },
+            {
+              "name": "SET_EVENT_KEY",
+              "direction": "emit",
+              "description": "Preference form: event key changed.",
+              "tier": "internal"
+            },
+            {
+              "name": "SET_CHANNEL",
+              "direction": "emit",
+              "description": "Preference form: channel changed.",
+              "tier": "internal"
+            },
+            {
+              "name": "SET_MODE",
+              "direction": "emit",
+              "description": "Preference form: delivery mode changed.",
+              "tier": "internal"
+            },
+            {
+              "name": "SET_QUIET_HOURS",
+              "direction": "emit",
+              "description": "Preference form: quiet-hours window changed.",
+              "tier": "internal"
+            },
+            {
+              "name": "PreferencesLoaded",
+              "direction": "emit",
+              "description": "The preference collection finished loading.",
+              "synonyms": "loaded, fetched, retrieved",
+              "tier": "domain"
+            },
+            {
+              "name": "PreferencesLoadFailed",
+              "direction": "emit",
+              "description": "The preference collection failed to load.",
+              "synonyms": "error, failure, load error",
+              "tier": "internal"
+            },
+            {
+              "name": "PreferenceSaved",
+              "direction": "emit",
+              "description": "A preference row persisted (create or update).",
+              "synonyms": "created, updated, persisted",
+              "tier": "domain"
+            },
+            {
+              "name": "PreferenceSaveFailed",
+              "direction": "emit",
+              "description": "A preference persist failed.",
+              "synonyms": "failed, error, unsuccessful",
+              "tier": "internal"
+            },
+            {
+              "name": "PreferenceDeleted",
+              "direction": "emit",
+              "description": "A preference row was deleted.",
+              "synonyms": "removed, purged, discarded",
+              "tier": "domain"
+            },
+            {
+              "name": "INIT",
+              "direction": "listen"
+            }
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "PreferenceGate",
+          "orbital": "NotificationPreferencesOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "PREFERENCE_RESOLVED",
+            "PREFERENCE_ROWS_LOADED",
+            "PREFERENCE_CHECK_FAILED"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "eventKey",
+              "type": "string",
+              "default": "",
+              "label": "Event key",
+              "description": "Stable key naming the event this gate checks preferences for (e.g. 'BudgetThreshold' — the std-finance-tracker NotifyOnEventListener convention). A blank CHECK_PREFERENCE payload eventKey falls back to this value. Preference rows whose eventKey is blank apply to every event.",
+              "synonyms": "preference key, event name, subscription key, notification topic",
+              "tier": "policy"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "lifecycle",
+          "linkedEntity": "GateView",
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "PREFERENCE_RESOLVED"
+            },
+            {
+              "kind": "fetch",
+              "resource": "NotificationPreference"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "toast"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.channel"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.eventKey"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.mode"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.personId"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.quietHours"
+            }
+          ],
+          "transitionEvents": [
+            "CHECK_PREFERENCE",
+            "PREFERENCE_CHECK_FAILED",
+            "PREFERENCE_ROWS_LOADED"
+          ],
+          "events": [
+            {
+              "name": "PREFERENCE_RESOLVED",
+              "direction": "emit",
+              "description": "The gate's verdict for a CHECK_PREFERENCE consult: resolved channel and mode, and whether quiet hours suppress delivery right now. Fail-open: no row or failed lookup = { channel: in_app, mode: instant, suppressed: false }.",
+              "synonyms": "verdict, preference answer, gate result, resolved preference",
+              "tier": "domain"
+            },
+            {
+              "name": "PREFERENCE_ROWS_LOADED",
+              "direction": "emit",
+              "description": "NotificationPreference rows loaded; the arm filters to the (personId, eventKey) match and resolves the verdict",
+              "tier": "internal"
+            },
+            {
+              "name": "PREFERENCE_CHECK_FAILED",
+              "direction": "emit",
+              "description": "The preference fetch failed — the arm emits the fail-open verdict",
+              "tier": "internal"
+            },
+            {
+              "name": "CHECK_PREFERENCE",
+              "direction": "listen",
+              "description": "Consult the gate for a person's effective notification preference.",
+              "synonyms": "check preference, resolve preference, should notify, gate notification",
+              "tier": "domain"
+            }
+          ],
+          "definerKnobs": []
+        }
+      ],
+      "factoryPath": "behaviors/functions/infra/atoms/std-notification-preferences.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
     "std-notify-on-event": {
       "name": "std-notify-on-event",
       "level": "atom",
@@ -10869,12 +12370,16 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -11377,6 +12882,779 @@
       ],
       "sourceValid": true
     },
+    "std-permission-matrix": {
+      "name": "std-permission-matrix",
+      "level": "atom",
+      "topic": "infra",
+      "family": "infra",
+      "layer": "UI Patterns",
+      "description": "std-permission-matrix — role × module permission grant table / capability matrix admin surface. Use when a user voices that permissions must be managed per role and module (permission matrix, role permissions, capability matrix, permission grants, access matrix, who can see finance, hide margins, module-level permissions, admin permission screen, grant management, finance visibility by role, restrict modules by role). Persists PermissionGrant rows (workspaceId + role + module + capability flags canReadFinance / canSeeOthersHours / canSeeMargins) with full CRUD on an admin page mounted at /admin/permissions, and ships a query trait other traits consult event-wise: CHECK_GRANT { role, module } fetches the matching grant(s) and re-emits GRANT_RESOLVED { role, module, canReadFinance, canSeeOthersHours, canSeeMargins, found }. Grant SURFACE only — entity-layer @read/@update gate integration is a recorded core gap (gates are pure @entity/@user S-expressions and cannot consult another entity's rows), so enforcement stays with the consumer until that core lands.",
+      "defaultOrbitalName": "PermissionMatrixOrbital",
+      "statePattern": "editing, error, listing, loading",
+      "complexity": {
+        "states": 4,
+        "events": 14,
+        "transitions": 16
+      },
+      "defaultEntity": {
+        "name": "PermissionGrant",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "workspaceId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "role",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "module",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "canReadFinance",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "canSeeOthersHours",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "canSeeMargins",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "createdAt",
+            "type": "number",
+            "default": 0
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "PermissionGrants",
+        "entitySingular": "PermissionGrant",
+        "entityPlural": "PermissionGrants"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "kflow-learning-companion",
+        "std-anim-tick",
+        "std-application",
+        "std-approval-gate",
+        "std-approval-request",
+        "std-audit-capture",
+        "std-broadcast-builder",
+        "std-browse",
+        "std-builder",
+        "std-cache-aside",
+        "std-calendar-sync",
+        "std-cascade-on-delete",
+        "std-circuit-breaker",
+        "std-confirmation",
+        "std-cooldown",
+        "std-cross-reference",
+        "std-data-erasure",
+        "std-data-import",
+        "std-gallery",
+        "std-game-clock",
+        "std-global-search",
+        "std-helpdesk-ticket",
+        "std-image-upload-multi",
+        "std-integration-settings",
+        "std-inventory",
+        "std-iram",
+        "std-lifecycle",
+        "std-list",
+        "std-menu",
+        "std-migration-job",
+        "std-mod-queue",
+        "std-modal",
+        "std-moderation-rule",
+        "std-modifier-group",
+        "std-notification-center",
+        "std-notification-panel",
+        "std-notification-preferences",
+        "std-notify-on-event",
+        "std-purchase-order",
+        "std-question-bank",
+        "std-rate-limiter",
+        "std-record-detail",
+        "std-reminder-scheduler",
+        "std-reorder-rule",
+        "std-rfi",
+        "std-row-access-control",
+        "std-saved-search",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "std-status-lifecycle",
+        "std-status-lifecycle-control",
+        "std-stock-level",
+        "std-tag-taxonomy",
+        "std-ticket-tier",
+        "std-trait-wars",
+        "std-warehouse",
+        "ui-confirm-dialog",
+        "ui-drawer",
+        "ui-lightbox",
+        "ui-modal",
+        "ui-side-panel",
+        "ui-subagent-trace-panel"
+      ],
+      "connectableEvents": [
+        "PermissionGrantLoaded",
+        "PermissionGrantLoadFailed",
+        "NEW",
+        "EDIT",
+        "DELETE",
+        "PermissionGrantDeleted",
+        "PermissionGrantDeleteFailed",
+        "CREATE_GRANT",
+        "SAVE_GRANT",
+        "CANCEL_GRANT",
+        "PermissionGrantSaved",
+        "PermissionGrantSaveFailed",
+        "CLOSE"
+      ],
+      "eventPayloads": {},
+      "exposure": "both",
+      "provenance": "authored",
+      "traits": [
+        {
+          "name": "LoadingSpinner",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Spinner.traits.SpinnerRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "ErrorSpinner",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "size",
+              "type": "unknown",
+              "default": "sm"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Spinner.traits.SpinnerRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "LoadingText",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "color",
+              "type": "unknown",
+              "default": "muted"
+            },
+            {
+              "key": "content",
+              "type": "unknown",
+              "default": "Loading permission grants…"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "caption"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Typography.traits.TypographyRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "ShieldCheckIcon",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "name",
+              "type": "unknown",
+              "default": "shield-check"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Icon.traits.IconRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "PermissionMatrixTitle",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "content",
+              "type": "unknown",
+              "default": "Permission matrix"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "h3"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Typography.traits.TypographyRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "NewGrantButton",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "action",
+              "type": "unknown",
+              "default": "NEW"
+            },
+            {
+              "key": "icon",
+              "type": "unknown",
+              "default": "plus"
+            },
+            {
+              "key": "label",
+              "type": "unknown",
+              "default": "New grant"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "primary"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Button.traits.ButtonRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": [
+            "action"
+          ]
+        },
+        {
+          "name": "BackButton",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "action",
+              "type": "unknown",
+              "default": "CANCEL_GRANT"
+            },
+            {
+              "key": "icon",
+              "type": "unknown",
+              "default": "x"
+            },
+            {
+              "key": "label",
+              "type": "unknown",
+              "default": "Cancel"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "ghost"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Button.traits.ButtonRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": [
+            "action"
+          ]
+        },
+        {
+          "name": "GrantDivider",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Divider.traits.DividerRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "ErrorAlert",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "message",
+              "type": "unknown",
+              "default": "@payload.error"
+            },
+            {
+              "key": "variant",
+              "type": "unknown",
+              "default": "error"
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "ref": "Alert.traits.AlertRender",
+          "category": "interaction",
+          "linkedEntity": "PermissionGrant",
+          "transitionEvents": [
+            "INIT"
+          ],
+          "definerKnobs": [
+            "onClose",
+            "onDismiss"
+          ]
+        },
+        {
+          "name": "PermissionMatrixAdmin",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "NEW",
+            "EDIT",
+            "DELETE",
+            "CREATE_GRANT",
+            "SAVE_GRANT",
+            "CANCEL_GRANT",
+            "CLOSE",
+            "PermissionGrantLoaded",
+            "PermissionGrantLoadFailed",
+            "PermissionGrantSaved",
+            "PermissionGrantSaveFailed",
+            "PermissionGrantDeleted",
+            "PermissionGrantDeleteFailed"
+          ],
+          "listenedEvents": [
+            "NEW",
+            "CANCEL_GRANT"
+          ],
+          "overridableConfigKeys": [
+            {
+              "key": "adminRoles",
+              "type": "[string]",
+              "default": [],
+              "label": "Who can manage grants?",
+              "description": "Roles eligible to create, edit, or delete grants. ENFORCED by the NEW/EDIT/DELETE/CREATE_GRANT/SAVE_GRANT transition guards: a viewer whose @user.role is not listed cannot fire a mutation, from the button or from the bus. Empty = every signed-in viewer may manage grants (ungated).",
+              "synonyms": "admin roles, permission managers, who edits permissions, grant admins",
+              "tier": "policy",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "key": "enabled",
+              "type": "boolean",
+              "default": false,
+              "label": "Manage role permissions",
+              "description": "Allow creating, editing, and deleting permission grants from this surface. Off by default.",
+              "synonyms": "enable, turn on, enforce, require, activate, apply, switch on, permission matrix, role permissions, capability matrix, permission grants, access matrix, manage permissions, who can see finance, hide margins, module-level permissions",
+              "tier": "policy"
+            }
+          ],
+          "capabilities": [
+            "access"
+          ],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "interaction",
+          "entityRebindable": true,
+          "linkedEntity": "PermissionGrant",
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "canReadFinance",
+              "canSeeMargins",
+              "canSeeOthersHours",
+              "module",
+              "role",
+              "workspaceId"
+            ]
+          },
+          "effectRow": [
+            {
+              "kind": "fetch",
+              "resource": "PermissionGrant"
+            },
+            {
+              "kind": "persist",
+              "resource": "PermissionGrant"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "modal"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "toast"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.canReadFinance"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.canSeeMargins"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.canSeeOthersHours"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.id"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.module"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.role"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.workspaceId"
+            }
+          ],
+          "transitionEvents": [
+            "CANCEL_GRANT",
+            "CLOSE",
+            "CREATE_GRANT",
+            "DELETE",
+            "EDIT",
+            "INIT",
+            "NEW",
+            "PermissionGrantDeleteFailed",
+            "PermissionGrantDeleted",
+            "PermissionGrantLoadFailed",
+            "PermissionGrantLoaded",
+            "PermissionGrantSaveFailed",
+            "PermissionGrantSaved",
+            "SAVE_GRANT"
+          ],
+          "events": [
+            {
+              "name": "NEW",
+              "direction": "emit",
+              "description": "Opens the create-grant form.",
+              "synonyms": "add grant, new permission, create grant",
+              "tier": "domain"
+            },
+            {
+              "name": "EDIT",
+              "direction": "emit",
+              "description": "Opens the edit form for a grant row.",
+              "synonyms": "modify grant, change permission, update grant",
+              "tier": "domain"
+            },
+            {
+              "name": "DELETE",
+              "direction": "emit",
+              "description": "Deletes a grant row (persisted; the grid refetches on success).",
+              "synonyms": "remove grant, revoke permission, delete grant",
+              "tier": "domain"
+            },
+            {
+              "name": "CREATE_GRANT",
+              "direction": "emit",
+              "description": "The create-grant form committed; data carries the new grant's fields.",
+              "synonyms": "submit grant, confirm create",
+              "tier": "internal"
+            },
+            {
+              "name": "SAVE_GRANT",
+              "direction": "emit",
+              "description": "The edit-grant form committed; data carries the grant id + updated fields.",
+              "synonyms": "submit edit, confirm update",
+              "tier": "internal"
+            },
+            {
+              "name": "CANCEL_GRANT",
+              "direction": "emit",
+              "description": "The grant form was dismissed without committing; the grid repaints.",
+              "synonyms": "cancel, back to matrix, dismiss form",
+              "tier": "internal"
+            },
+            {
+              "name": "CLOSE",
+              "direction": "emit",
+              "description": "Dismisses the grant form overlay (the modal shell's own X / Escape / overlay-click).",
+              "synonyms": "dismiss, hide, close form, done",
+              "tier": "domain"
+            },
+            {
+              "name": "PermissionGrantLoaded",
+              "direction": "emit",
+              "description": "Indicates the permission-grant collection has been successfully loaded.",
+              "synonyms": "loaded, fetched, retrieved",
+              "tier": "internal"
+            },
+            {
+              "name": "PermissionGrantLoadFailed",
+              "direction": "emit",
+              "description": "Indicates failure to load the permission-grant collection.",
+              "synonyms": "load error, failed load, request failure",
+              "tier": "internal"
+            },
+            {
+              "name": "PermissionGrantSaved",
+              "direction": "emit",
+              "description": "Signals that a permission grant has been persisted (create / update).",
+              "synonyms": "saved, created, updated, persisted",
+              "tier": "internal"
+            },
+            {
+              "name": "PermissionGrantSaveFailed",
+              "direction": "emit",
+              "description": "Indicates a failure to persist a permission grant.",
+              "synonyms": "save error, failed save, persist failure",
+              "tier": "internal"
+            },
+            {
+              "name": "PermissionGrantDeleted",
+              "direction": "emit",
+              "description": "Signals that a permission grant has been deleted.",
+              "synonyms": "deleted, removed, revoked",
+              "tier": "internal"
+            },
+            {
+              "name": "PermissionGrantDeleteFailed",
+              "direction": "emit",
+              "description": "Indicates a failure to delete a permission grant.",
+              "synonyms": "delete error, failed delete",
+              "tier": "internal"
+            },
+            {
+              "name": "INIT",
+              "direction": "listen"
+            }
+          ],
+          "definerKnobs": []
+        },
+        {
+          "name": "PermissionGrantQuery",
+          "orbital": "PermissionMatrixOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "GRANT_RESOLVED",
+            "GrantCheckLoaded",
+            "GrantCheckFailed"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "enabled",
+              "type": "boolean",
+              "default": false,
+              "label": "Answer permission lookups",
+              "description": "Answer CHECK_GRANT lookups with GRANT_RESOLVED from the persisted grant table. Off by default.",
+              "synonyms": "enable, turn on, activate, permission lookup, grant query, resolve capabilities",
+              "tier": "policy"
+            }
+          ],
+          "capabilities": [
+            "access"
+          ],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "lifecycle",
+          "entityRebindable": true,
+          "linkedEntity": "PermissionGrant",
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "module",
+              "role"
+            ]
+          },
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "GRANT_RESOLVED"
+            },
+            {
+              "kind": "fetch",
+              "resource": "PermissionGrant"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "toast"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.module"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.role"
+            }
+          ],
+          "transitionEvents": [
+            "CHECK_GRANT",
+            "GrantCheckFailed",
+            "GrantCheckLoaded"
+          ],
+          "events": [
+            {
+              "name": "GRANT_RESOLVED",
+              "direction": "emit",
+              "description": "Answers a CHECK_GRANT: the capability flags of the first matching grant row, with found=false (and all flags false) when no row matches. Rename to wire the downstream listener; default-deny on found=false is the consumer's choice.",
+              "synonyms": "grant resolved, permission answer, capabilities returned, access decision data",
+              "tier": "domain"
+            },
+            {
+              "name": "GrantCheckLoaded",
+              "direction": "emit",
+              "description": "Indicates the grant lookup for a CHECK_GRANT has been successfully loaded.",
+              "synonyms": "loaded, fetched, retrieved",
+              "tier": "internal"
+            },
+            {
+              "name": "GrantCheckFailed",
+              "direction": "emit",
+              "description": "Indicates the grant lookup for a CHECK_GRANT failed.",
+              "synonyms": "lookup error, failed lookup, request failure",
+              "tier": "internal"
+            },
+            {
+              "name": "CHECK_GRANT",
+              "direction": "listen",
+              "description": "Asks which capabilities a role holds in a module; the answer arrives as GRANT_RESOLVED (asynchronous — correlate by the echoed role/module).",
+              "synonyms": "check grant, lookup permission, resolve capabilities, can this role see",
+              "tier": "domain"
+            }
+          ],
+          "definerKnobs": []
+        }
+      ],
+      "factoryPath": "behaviors/functions/infra/atoms/std-permission-matrix.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
     "std-rate-limiter": {
       "name": "std-rate-limiter",
       "level": "atom",
@@ -11470,12 +13748,14 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
         "std-form-advanced",
         "std-game-clock",
         "std-geo-vonthunen",
+        "std-global-search",
         "std-graph-builder",
         "std-hist-ccot",
         "std-hist-sourcing",
@@ -11507,7 +13787,9 @@
         "std-ml-similarity",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-physics-diagram",
         "std-physics-field-3d",
         "std-physics-orbit-3d",
@@ -12249,13 +14531,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-row-access-control",
         "std-service-accounting",
@@ -12522,13 +14808,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-service-accounting",
@@ -12722,13 +15012,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -12990,13 +15284,17 @@
         "std-cooldown",
         "std-cross-reference",
         "std-data-erasure",
+        "std-data-import",
         "std-game-clock",
+        "std-global-search",
         "std-integration-settings",
         "std-lifecycle",
         "std-migration-job",
         "std-mod-queue",
         "std-notification-center",
+        "std-notification-preferences",
         "std-notify-on-event",
+        "std-permission-matrix",
         "std-rate-limiter",
         "std-reminder-scheduler",
         "std-row-access-control",
@@ -13566,6 +15864,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -13813,6 +16112,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -14081,6 +16381,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -14330,6 +16631,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -14813,6 +17115,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -15315,6 +17618,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -15609,6 +17913,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -15887,6 +18192,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-escalating-decision",
@@ -16128,6 +18434,7 @@
         "std-civics-electoral",
         "std-civics-gerrymander",
         "std-data-collector",
+        "std-data-import",
         "std-econ-gdp",
         "std-econ-phillips",
         "std-form-advanced",
@@ -17935,6 +20242,7 @@
         "std-form-advanced",
         "std-gallery",
         "std-geosearch",
+        "std-global-search",
         "std-graphs",
         "std-image-upload-multi",
         "std-import",
@@ -20413,6 +22721,7 @@
                     "children": [
                       {
                         "name": "kanban-square",
+                        "size": "lg",
                         "type": "icon"
                       },
                       {
@@ -20831,6 +23140,7 @@
                     "children": [
                       {
                         "name": "kanban-square",
+                        "size": "xl",
                         "type": "icon"
                       },
                       {
@@ -21401,7 +23711,9 @@
         "std-modifier-group",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -23572,6 +25884,7 @@
                         "children": [
                           {
                             "name": "list",
+                            "size": "xl",
                             "type": "icon"
                           },
                           {
@@ -23773,6 +26086,7 @@
                         "children": [
                           {
                             "name": "calendar",
+                            "size": "xl",
                             "type": "icon"
                           },
                           {
@@ -24147,6 +26461,7 @@
                         "children": [
                           {
                             "name": "calendar",
+                            "size": "xl",
                             "type": "icon"
                           },
                           {
@@ -24506,8 +26821,10 @@
         "std-moderation-rule",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rate-limiter",
@@ -30609,6 +32926,7 @@
         "std-confirmation",
         "std-crew-board-2d",
         "std-dashboard-grid-embedded",
+        "std-data-import",
         "std-date-range",
         "std-detail-layout",
         "std-econ-gdp",
@@ -30662,6 +32980,7 @@
         "std-modal-editor",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-pagination",
         "std-physics-diagram",
@@ -31314,6 +33633,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -33204,7 +35524,9 @@
         "std-modifier-group",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
+        "std-permission-matrix",
         "std-rating-review",
         "std-record-detail",
         "std-recurrence",
@@ -33689,6 +36011,7 @@
         "std-calendar",
         "std-confirmation",
         "std-dashboard-grid-embedded",
+        "std-data-import",
         "std-date-range",
         "std-detail-layout",
         "std-esign-flow",
@@ -34359,7 +36682,9 @@
         "std-multi-party-flow",
         "std-nonprofit-donations",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
+        "std-permission-matrix",
         "std-property-mgmt",
         "std-public-help-center",
         "std-rating-review",
@@ -35178,6 +37503,7 @@
         "std-modal",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
         "std-rating-review",
         "std-record-detail",
@@ -36103,7 +38429,9 @@
         "std-moderation-rule",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -37586,6 +39914,7 @@
         "std-moderation-rule",
         "std-multi-party-flow",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -39559,11 +41888,13 @@
         "std-modifier-group",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-nps-survey",
         "std-offer-letter",
         "std-pagination",
         "std-patient",
         "std-payout-ledger",
+        "std-permission-matrix",
         "std-portfolio",
         "std-prescription",
         "std-purchase-order",
@@ -42004,8 +44335,10 @@
         "std-modifier-group",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-rating-review",
         "std-record-detail",
@@ -42964,6 +45297,7 @@
         "std-form-advanced",
         "std-gallery",
         "std-geosearch",
+        "std-global-search",
         "std-graphs",
         "std-image-upload-multi",
         "std-import",
@@ -45845,6 +48179,7 @@
                     "children": [
                       {
                         "name": "shield-check",
+                        "size": "lg",
                         "type": "icon"
                       },
                       {
@@ -45872,7 +48207,7 @@
                             "children": [
                               {
                                 "name": "@entity.currentStepIcon",
-                                "size": "lg",
+                                "size": "xl",
                                 "type": "icon"
                               },
                               {
@@ -47372,6 +49707,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -50605,6 +52941,7 @@
         "std-motion-body",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -82572,6 +84909,7 @@
         "std-modal-editor",
         "std-multi-party-flow",
         "std-notification-panel",
+        "std-notification-preferences",
         "std-pagination",
         "std-rating-review",
         "std-record-detail",
@@ -84008,6 +86346,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -92212,6 +94551,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -105895,6 +108235,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -110155,6 +112496,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -119993,6 +122335,7 @@
         "std-form-advanced",
         "std-gallery",
         "std-geosearch",
+        "std-global-search",
         "std-graphs",
         "std-image-upload-multi",
         "std-import",
@@ -120948,6 +123291,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -146571,6 +148915,7 @@
         "std-multi-party-flow",
         "std-notification-panel",
         "std-pagination",
+        "std-permission-matrix",
         "std-purchase-order",
         "std-question-bank",
         "std-rating-review",
@@ -181522,6 +183867,7 @@
         "std-mesh-tactics",
         "std-motion-body",
         "std-multi-party-flow",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -183294,6 +185640,7 @@
         "std-mesh-asset-art",
         "std-mesh-tactics",
         "std-motion-body",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -188347,6 +190694,7 @@
         "std-mesh-tactics",
         "std-motion-body",
         "std-multi-party-flow",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -190669,6 +193017,7 @@
         "std-mesh-tactics",
         "std-motion-body",
         "std-multi-party-flow",
+        "std-notification-preferences",
         "std-objective-flow",
         "std-objective-reach",
         "std-pad-lock",
@@ -196411,6 +198760,7 @@
         "std-mesh-tactics",
         "std-motion-body",
         "std-multi-party-flow",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -198197,6 +200547,7 @@
         "std-mesh-asset-art",
         "std-mesh-tactics",
         "std-motion-body",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -200288,6 +202639,7 @@
         "std-mesh-asset-art",
         "std-mesh-tactics",
         "std-motion-body",
+        "std-notification-preferences",
         "std-objective-board-3d",
         "std-objective-flow",
         "std-objective-reach",
@@ -206785,6 +209137,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -207598,6 +209951,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -209093,6 +211447,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -211297,6 +213652,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -212047,6 +214403,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -213442,6 +215799,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -214124,6 +216482,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -215402,6 +217761,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -217017,6 +219377,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -217546,6 +219907,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -218264,6 +220626,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -220033,6 +222396,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-drip-sequence",
         "std-earth-plates",
         "std-earth-plates-3d",
@@ -222478,6 +224842,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -224175,6 +226540,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",
@@ -224749,6 +227115,7 @@
         "std-civics-checks",
         "std-civics-electoral",
         "std-civics-gerrymander",
+        "std-data-import",
         "std-earth-plates",
         "std-earth-plates-3d",
         "std-earth-watercycle",