@ai-matrx/records 0.6.2 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,73 @@
1
1
  # Changelog — @ai-matrx/records
2
2
 
3
+ ## 0.7.2
4
+
5
+ **The door catalogue, regenerated while the store was still growing.** 0.7.1
6
+ mirrored 300 doors and the gate, running twelve minutes later, counted 301 —
7
+ another lane shipped one in the window. Regenerated: 301 doors. Nothing else
8
+ changed.
9
+
10
+ ## 0.7.1
11
+
12
+ **The live suite opens the switch the way the store resolves it.**
13
+
14
+ 0.7.0's release gate failed four clauses against the live store and none of them
15
+ was about this package's code. `platform.knob_resolve` reads an organization's
16
+ own override ABOVE the base knob row, and Test's Org gained one
17
+ (`custom/system_enabled` = false, written through the ramp screen's own writer)
18
+ — so the suite's in-transaction `update platform.feature_knob` stopped opening
19
+ anything and three cases met the store's switched-off refusal. Both rungs are
20
+ set inside the transaction now, for the member's organization and for the
21
+ stranger organization the membership wall case names, and the `rollback` still
22
+ puts both back.
23
+
24
+ The fourth was the door catalogue: 293 mirrored names against 300 live doors,
25
+ because other lanes added seven. `src/store.generated.ts` is regenerated from
26
+ the live store — 300 doors, 35 knobs, 1020 entity tokens — which is the file's
27
+ whole contract: nothing in it is typed by a person.
28
+
29
+ ## 0.7.0
30
+
31
+ **A screen can ask what this person may do, before it offers it.**
32
+
33
+ The 19–20 September verdict (sixth pass) watched a colleague who had been shared
34
+ a table at Viewer double-click a cell, get a live editor, type a value and press
35
+ Enter — and only then be told she may not write. "The permission is right; the
36
+ screen told her she could." No screen could have done better: the store answers
37
+ "what may this person do to this thing?" in exactly one place,
38
+ `custom.effective_level`, which has no grant to `authenticated` and no decision
39
+ of its own — it takes ANY principal and ANY subject, so granting it to clients
40
+ would be handing out a visibility probe.
41
+
42
+ - **`client.myLevels({ ids })`** — the new `custom.my_levels` door. What level
43
+ the CALLER holds on the subjects they name, with no principal argument: the
44
+ person is resolved from the session, so you can ask about your own access and
45
+ about nobody else's. It takes a LIST so a page of fifty rows is one call, and
46
+ **every id asked about gets a row** — `null` included, because a missing row
47
+ and "no access" would be the same thing to the screen that asked and one of
48
+ them is a silence. `null` for an id that does not exist is the same answer, so
49
+ it is not an existence oracle.
50
+ - **`useMyLevel(id)` / `useMyLevels(ids)`** in `/react`.
51
+ - **`level.ts`**: `PermissionLevel`, `PERMISSION_LEVELS`, `atLeast`,
52
+ `asPermissionLevel`, `highestLevel`. The ladder a screen compares with is the
53
+ ladder the door compares with; two orderings would be two answers to one
54
+ question and the second is always wrong.
55
+
56
+ **What this release deliberately does NOT do.** A `Table.your_level` carried off
57
+ the read door looked free and was wrong: `tableList` reads the Table KERNEL, so
58
+ `read_records`'s `level` there is the caller's level on the kernel — viewer, for
59
+ everybody — and not on the table that row describes. It was written, measured
60
+ wrong within the hour (a table's own owner came back `viewer`), and removed; the
61
+ reason is in `core/client.ts` where the next person will reach for it. A table
62
+ is a record, and its level is asked for like any other record's.
63
+
64
+ ### Consumer action
65
+
66
+ None required. `custom.my_levels` is live on the main database (lane UI-HONEST,
67
+ `uihonest_a_screen_can_ask_what_it_may_offer.sql` +
68
+ `uihonest_the_level_door_takes_a_json_list.sql`), so `myLevels` answers as soon
69
+ as this version is installed.
70
+
3
71
  ## 0.6.2
4
72
 
5
73
  The generated store contract, regenerated at 279 doors. 0.6.1's gate was red on
@@ -51,6 +51,7 @@ __export(core_exports, {
51
51
  ON_DELETE: () => ON_DELETE,
52
52
  OVERRIDE_POLICIES: () => OVERRIDE_POLICIES,
53
53
  PARITY_FIELD_TYPES: () => PARITY_FIELD_TYPES,
54
+ PERMISSION_LEVELS: () => PERMISSION_LEVELS,
54
55
  PER_VALUE_ACCESS_WORDS: () => PER_VALUE_ACCESS_WORDS,
55
56
  RELATION_BINDINGS: () => RELATION_BINDINGS,
56
57
  RELATION_CARDINALITIES: () => RELATION_CARDINALITIES,
@@ -67,7 +68,9 @@ __export(core_exports, {
67
68
  TABLE_TYPES: () => TABLE_TYPES,
68
69
  VALUE_ALTERNATE_KEYS: () => VALUE_ALTERNATE_KEYS,
69
70
  VALUE_ENVELOPE_KEYS: () => VALUE_ENVELOPE_KEYS,
71
+ asPermissionLevel: () => asPermissionLevel,
70
72
  asWriteConflict: () => asWriteConflict,
73
+ atLeast: () => atLeast,
71
74
  cellText: () => cellText,
72
75
  createRecordsClient: () => createRecordsClient,
73
76
  doorAbsent: () => doorAbsent,
@@ -76,6 +79,7 @@ __export(core_exports, {
76
79
  err: () => err,
77
80
  exportCsv: () => exportCsv,
78
81
  exportXlsx: () => exportXlsx,
82
+ highestLevel: () => highestLevel,
79
83
  importCsv: () => importCsv,
80
84
  importXlsx: () => importXlsx,
81
85
  intersectIds: () => intersectIds,
@@ -151,6 +155,33 @@ var OVERRIDE_POLICIES = [
151
155
  var FRESHNESS = ["live", "cached", "snapshot"];
152
156
  var TABLE_DISPLAYS = ["list", "grid", "board", "calendar", "timeline"];
153
157
 
158
+ // src/level.ts
159
+ var PERMISSION_LEVELS = [
160
+ "viewer",
161
+ "commenter",
162
+ "editor",
163
+ "admin"
164
+ ];
165
+ var ORDINAL = {
166
+ viewer: 1,
167
+ commenter: 2,
168
+ editor: 3,
169
+ admin: 4
170
+ };
171
+ function atLeast(held, needed) {
172
+ if (!held) return false;
173
+ const have = ORDINAL[held];
174
+ return have !== void 0 && have >= ORDINAL[needed];
175
+ }
176
+ function asPermissionLevel(word) {
177
+ return typeof word === "string" && word in ORDINAL ? word : null;
178
+ }
179
+ function highestLevel(left, right) {
180
+ if (!left) return right ?? null;
181
+ if (!right) return left;
182
+ return ORDINAL[left] >= ORDINAL[right] ? left : right;
183
+ }
184
+
154
185
  // src/aggregate.ts
155
186
  function measureKey(measure) {
156
187
  return measure.op === "count" ? "count" : `${measure.op}_${measure.key ?? ""}`;
@@ -225,7 +256,9 @@ var STORE_DOORS = [
225
256
  { name: "absence_reasons", args: "", returns: "text[]", security: "invoker" },
226
257
  { name: "actor_vocabulary", args: "", returns: "text[]", security: "invoker" },
227
258
  { name: "actor_word", args: "p_declared text", returns: "text", security: "invoker" },
259
+ { name: "agent_change_approval", args: "p_organization uuid, p_conversation uuid DEFAULT NULL::uuid, p_table uuid DEFAULT NULL::uuid", returns: "jsonb", security: "definer" },
228
260
  { name: "agent_context", args: "p_organization_id uuid, p_table_id uuid, p_limit integer DEFAULT 50", returns: "jsonb", security: "invoker" },
261
+ { name: "agent_table_claim", args: "p_organization uuid, p_table uuid, p_conversation uuid DEFAULT NULL::uuid", returns: "void", security: "definer" },
229
262
  { name: "agg_assert_key", args: "p_key text", returns: "text", security: "invoker" },
230
263
  { name: "agg_buckets", args: "", returns: "text[]", security: "invoker" },
231
264
  { name: "agg_deliver", args: "p_organization_id uuid, p_rule_id uuid, p_record_id uuid, p_channel text, p_recipient_user_id uuid, p_event_key text, p_subject text, p_body text, p_payload jsonb DEFAULT '{}'::jsonb", returns: "uuid", security: "invoker" },
@@ -243,6 +276,7 @@ var STORE_DOORS = [
243
276
  { name: "anon_inbound_land", args: "p_address text, p_secret text, p_payload jsonb, p_raw_payload jsonb DEFAULT '{}'::jsonb, p_client_key text DEFAULT NULL::text", returns: "uuid", security: "definer" },
244
277
  { name: "anon_publish", args: "p_organization_id uuid, p_form_id uuid, p_published boolean DEFAULT true", returns: "timestamp with time zone", security: "definer" },
245
278
  { name: "anon_rate_take", args: "p_organization_id uuid, p_form_id uuid, p_bucket text, p_token_id uuid DEFAULT NULL::uuid", returns: "integer", security: "definer" },
279
+ { name: "anon_submissions", args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_state text DEFAULT NULL::text, p_limit integer DEFAULT 100, p_offset integer DEFAULT 0", returns: "TABLE(id uuid, form_id uuid, inbound_id uuid, table_id uuid, source text, state text, payload jsonb, raw_payload jsonb, client_key text, record_id uuid, remote_origin text, rejection_reason text, created_at timestamp with time zone, cleared_at timestamp with time zone)", security: "definer" },
246
280
  { name: "anon_token_issue", args: "p_organization_id uuid, p_mode text, p_allowed_origins jsonb, p_form_id uuid DEFAULT NULL::uuid, p_saved_view_id uuid DEFAULT NULL::uuid, p_record_id uuid DEFAULT NULL::uuid, p_expires_at timestamp with time zone DEFAULT NULL::timestamp with time zone", returns: "TABLE(token_id uuid, secret text)", security: "definer" },
247
281
  { name: "anon_token_revoke", args: "p_organization_id uuid, p_token_id uuid", returns: "boolean", security: "definer" },
248
282
  { name: "anon_token_verify", args: "p_secret text, p_origin text, p_required_mode text", returns: "TABLE(token_id uuid, organization_id uuid, form_id uuid, saved_view_id uuid, record_id uuid, mode text)", security: "definer" },
@@ -258,6 +292,8 @@ var STORE_DOORS = [
258
292
  { name: "bump_epoch", args: "p_entity_type text, p_entity_id uuid, p_organization_id uuid DEFAULT NULL::uuid", returns: "bigint", security: "definer" },
259
293
  { name: "cache_lookup", args: "p_container_type text, p_container_id uuid, p_item_type text, p_item_id uuid", returns: "permission_level", security: "definer" },
260
294
  { name: "caller_role", args: "", returns: "name", security: "invoker" },
295
+ { name: "carrying_edges_in", args: "p_organization_id uuid", returns: "TABLE(container_type text, container_id uuid, item_type text, item_id uuid, conveys_max permission_level)", security: "definer" },
296
+ { name: "carrying_edges_of", args: "p_item_type text, p_item_id uuid", returns: "TABLE(container_type text, container_id uuid, conveys_max permission_level)", security: "definer" },
261
297
  { name: "client_write_grants", args: "", returns: "TABLE(role_name text, object_name text, privilege text)", security: "invoker" },
262
298
  { name: "computed_provenance", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(field_key text, field_id uuid, value jsonb, rule_id uuid, rule_version integer, computed_at timestamp with time zone)", security: "invoker" },
263
299
  { name: "containment_chain", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(ancestor_id uuid, depth integer)", security: "invoker" },
@@ -267,6 +303,7 @@ var STORE_DOORS = [
267
303
  { name: "cross_organization_links_open", args: "p_source_organization_id uuid, p_target_organization_id uuid", returns: "boolean", security: "invoker" },
268
304
  { name: "custom_fields_tables", args: "", returns: "TABLE(token text, schema_name text, table_name text)", security: "invoker" },
269
305
  { name: "delete_cascade_closure", args: "p_organization_id uuid, p_record_id uuid", returns: "uuid[]", security: "invoker" },
306
+ { name: "delete_preview", args: "p_organization_id uuid, p_record_id uuid", returns: "jsonb", security: "definer" },
270
307
  { name: "delete_rule", args: "p_organization_id uuid, p_record_id uuid, p_apply boolean DEFAULT true", returns: "jsonb", security: "definer" },
271
308
  { name: "dependency_cycle", args: "p_organization_id uuid, p_row custom.record", returns: "text[]", security: "invoker" },
272
309
  { name: "dependency_label", args: "p_organization_id uuid, p_node text", returns: "text", security: "invoker" },
@@ -301,7 +338,7 @@ var STORE_DOORS = [
301
338
  { name: "external_writes_set", args: "p_organization_id uuid, p_source_id uuid, p_enabled boolean", returns: "boolean", security: "definer" },
302
339
  { name: "field_behaviour", args: "p_field_data jsonb", returns: "text", security: "invoker" },
303
340
  { name: "field_declare", args: "p_organization_id uuid, p_table_id uuid, p_spec jsonb", returns: "uuid", security: "definer" },
304
- { name: "field_dependants", args: "p_organization_id uuid, p_field_id uuid", returns: "TABLE(kind text, dependant_id uuid, label text, how text)", security: "invoker" },
341
+ { name: "field_dependants", args: "p_organization_id uuid, p_field_id uuid", returns: "TABLE(kind text, dependant_id uuid, label text, how text)", security: "definer" },
305
342
  { name: "field_kernel_id", args: "", returns: "uuid", security: "invoker" },
306
343
  { name: "field_options", args: "p_organization_id uuid, p_field_id uuid", returns: "SETOF custom.record", security: "definer" },
307
344
  { name: "field_retire", args: "p_organization_id uuid, p_field_id uuid", returns: "boolean", security: "definer" },
@@ -310,6 +347,7 @@ var STORE_DOORS = [
310
347
  { name: "field_value_convert", args: "p_to jsonb, p_value jsonb", returns: "jsonb", security: "invoker" },
311
348
  { name: "file_kernel_id", args: "", returns: "uuid", security: "invoker" },
312
349
  { name: "formula_value", args: "p_organization_id uuid, p_record_id uuid, p_field_data jsonb, p_values jsonb DEFAULT NULL::jsonb", returns: "jsonb", security: "invoker" },
350
+ { name: "guard_refusals_are_complete", args: "", returns: "TABLE(guard text, said text)", security: "invoker" },
313
351
  { name: "has_visibility", args: "p_user_id uuid, p_type text, p_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level", returns: "boolean", security: "definer" },
314
352
  { name: "has_visibility_at", args: "p_user_id uuid, p_type text, p_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level, p_organization_id uuid DEFAULT NULL::uuid, p_min_version bigint DEFAULT NULL::bigint", returns: "boolean", security: "definer" },
315
353
  { name: "hidden_field_notice", args: "p_field custom.record, p_action text DEFAULT 'read'::text", returns: "jsonb", security: "invoker" },
@@ -341,6 +379,7 @@ var STORE_DOORS = [
341
379
  { name: "io_record_changed", args: "", returns: "trigger", security: "definer" },
342
380
  { name: "io_restore", args: "p_organization_id uuid, p_record_id uuid, p_version integer", returns: "integer", security: "definer" },
343
381
  { name: "io_revisions", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(version integer, changed_at timestamp with time zone, changed_by uuid, summary text, operation text, changed_fields jsonb)", security: "definer" },
382
+ { name: "is_a_retirement", args: "p_old_deleted timestamp with time zone, p_new_deleted timestamp with time zone, p_old_data jsonb, p_new_data jsonb, p_old_table uuid, p_new_table uuid, p_old_org uuid, p_new_org uuid, p_old_class text, p_new_class text", returns: "boolean", security: "invoker" },
344
383
  { name: "lookup_value", args: "p_organization_id uuid, p_record_id uuid, p_field_data jsonb", returns: "jsonb", security: "invoker" },
345
384
  { name: "mask_document", args: "p_document jsonb, p_visible_keys text[], p_notices jsonb, p_by_id boolean DEFAULT false, p_key_ids jsonb DEFAULT '{}'::jsonb", returns: "jsonb", security: "invoker" },
346
385
  { name: "mask_document", args: "p_document jsonb, p_visible_keys text[], p_notices jsonb, p_by_id boolean DEFAULT false, p_key_ids jsonb DEFAULT '{}'::jsonb, p_declared_keys text[] DEFAULT NULL::text[]", returns: "jsonb", security: "invoker" },
@@ -353,9 +392,12 @@ var STORE_DOORS = [
353
392
  { name: "migrate_purge", args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_dry_run boolean DEFAULT true", returns: "jsonb", security: "definer" },
354
393
  { name: "migrate_rename", args: "p_organization_id uuid, p_id uuid, p_to text, p_note text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
355
394
  { name: "migrate_reparent", args: "p_organization_id uuid, p_id uuid, p_parent_id uuid, p_note text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
356
- { name: "migrate_retype", args: "p_organization_id uuid, p_id uuid, p_to text, p_note text DEFAULT NULL::text", returns: "jsonb", security: "invoker" },
395
+ { name: "migrate_retype", args: "p_organization_id uuid, p_id uuid, p_to text, p_note text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
357
396
  { name: "migrate_split", args: "p_organization_id uuid, p_record_id uuid, p_moved_keys text[], p_note text DEFAULT NULL::text", returns: "jsonb", security: "definer" },
358
397
  { name: "migrate_undo", args: "p_organization_id uuid, p_log_id uuid", returns: "jsonb", security: "definer" },
398
+ { name: "migrations", args: "p_organization_id uuid, p_target_id uuid DEFAULT NULL::uuid, p_limit integer DEFAULT 100", returns: "TABLE(id uuid, verb text, target_kind text, target_id uuid, note text, applied_at timestamp with time zone, applied_by uuid, undone_at timestamp with time zone)", security: "definer" },
399
+ { name: "my_level", args: "p_organization_id uuid, p_id uuid, p_type text DEFAULT 'record'::text", returns: "permission_level", security: "definer" },
400
+ { name: "my_levels", args: "p_organization_id uuid, p_ids jsonb, p_type text DEFAULT 'record'::text", returns: "TABLE(id uuid, level permission_level)", security: "definer" },
359
401
  { name: "organization_kernel_id", args: "", returns: "uuid", security: "invoker" },
360
402
  { name: "organization_references", args: "p_kind text, p_organization_id uuid, p_row jsonb", returns: "TABLE(site text, what text, ref_id uuid, openable boolean)", security: "invoker" },
361
403
  { name: "owning_table", args: "p_organization_id uuid, p_record_id uuid", returns: "uuid", security: "invoker" },
@@ -396,11 +438,17 @@ var STORE_DOORS = [
396
438
  { name: "query_visibility_parity", args: "p_organization_id uuid", returns: "TABLE(side text, container_type text, container_id uuid, item_type text, item_id uuid, stored_level permission_level, derived_level permission_level, reason text)", security: "definer" },
397
439
  { name: "query_visible_ids", args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_required text DEFAULT 'viewer'::text", returns: "SETOF uuid", security: "definer" },
398
440
  { name: "reachable_from", args: "p_organization_id uuid, p_roots uuid[]", returns: "TABLE(record_id uuid, depth integer, via text)", security: "invoker" },
441
+ { name: "reaches_directly", args: "p_user_id uuid, p_type text, p_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level", returns: "boolean", security: "definer" },
442
+ { name: "read_door_carried_ids", args: "p_user uuid, p_organization_id uuid, p_table_id uuid, p_required permission_level, OUT o_ids uuid[], OUT o_containers integer", returns: "record", security: "definer" },
443
+ { name: "read_door_granted_ids", args: "p_organization_id uuid, p_table_id uuid", returns: "uuid[]", security: "definer" },
444
+ { name: "read_door_ladder_ceiling", args: "", returns: "integer", security: "invoker" },
445
+ { name: "read_door_parity", args: "p_organization_id uuid, p_table_id uuid, p_user uuid, p_required permission_level, p_sample integer", returns: "TABLE(record_id uuid, set_based boolean, per_row boolean, verdict text)", security: "definer" },
399
446
  { name: "read_paths_outside_the_door", args: "", returns: "TABLE(object_name text, why text)", security: "invoker" },
400
447
  { name: "read_record", args: "p_organization_id uuid, p_record_id uuid, p_by_id boolean DEFAULT false", returns: "jsonb", security: "definer" },
401
448
  { name: "read_records", args: "p_organization_id uuid, p_table_id uuid, p_by_id boolean DEFAULT false, p_limit integer DEFAULT 200, p_offset integer DEFAULT 0", returns: "TABLE(id uuid, document jsonb, level permission_level)", security: "definer" },
402
449
  { name: "record_aggregate", args: "p_organization_id uuid, p_table_id uuid, p_group_by jsonb DEFAULT '[]'::jsonb, p_measures jsonb DEFAULT '[]'::jsonb, p_bucket jsonb DEFAULT NULL::jsonb, p_filter jsonb DEFAULT '{}'::jsonb, p_limit integer DEFAULT 200, p_required text DEFAULT 'viewer'::text", returns: "TABLE(groups jsonb, measures jsonb, row_count bigint)", security: "definer" },
403
450
  { name: "record_applicability", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(rule_id uuid, rule_name text, rule_version integer, applies boolean, answer jsonb)", security: "invoker" },
451
+ { name: "record_as_of", args: "p_organization_id uuid, p_record_id uuid, p_at timestamp with time zone", returns: "TABLE(state jsonb, replayed boolean)", security: "definer" },
404
452
  { name: "record_card", args: "p_viewer uuid, p_organization_id uuid, p_record_id uuid", returns: "jsonb", security: "definer" },
405
453
  { name: "record_carrying_edges", args: "p_id uuid, p_data_class text, p_data jsonb, p_deleted_at timestamp with time zone", returns: "TABLE(container_id uuid, item_id uuid, edge_role text)", security: "invoker" },
406
454
  { name: "record_delete", args: "p_organization_id uuid, p_record_id uuid", returns: "timestamp with time zone", security: "definer" },
@@ -440,6 +488,7 @@ var STORE_DOORS = [
440
488
  { name: "rule_truth", args: "p_answer jsonb", returns: "boolean", security: "invoker" },
441
489
  { name: "rule_uses", args: "", returns: "text[]", security: "invoker" },
442
490
  { name: "rule_version", args: "p_organization_id uuid, p_rule_id uuid", returns: "integer", security: "invoker" },
491
+ { name: "said", args: "p_value text, p_when_there_is_none text", returns: "text", security: "invoker" },
443
492
  { name: "share_access", args: "p_organization_id uuid, p_subject_id uuid", returns: "TABLE(principal_kind text, principal_id uuid, principal_label text, level permission_level, reason text, reason_detail text, via_type text, via_id uuid, revocable boolean)", security: "definer" },
444
493
  { name: "share_grant", args: "p_organization_id uuid, p_subject_id uuid, p_principal_kind text, p_principal_id uuid, p_level permission_level DEFAULT 'viewer'::permission_level", returns: "jsonb", security: "definer" },
445
494
  { name: "share_lane_set", args: "p_organization_id uuid, p_subject_id uuid, p_choice text, p_level permission_level DEFAULT NULL::permission_level", returns: "jsonb", security: "definer" },
@@ -448,6 +497,7 @@ var STORE_DOORS = [
448
497
  { name: "share_people", args: "p_organization_id uuid, p_subject_id uuid DEFAULT NULL::uuid, p_query text DEFAULT NULL::text, p_limit integer DEFAULT 25", returns: "TABLE(user_id uuid, email text, display_name text, membership text, already_at permission_level, already_why text)", security: "definer" },
449
498
  { name: "share_revoke", args: "p_organization_id uuid, p_subject_id uuid, p_principal_kind text, p_principal_id uuid", returns: "jsonb", security: "definer" },
450
499
  { name: "share_subject_name", args: "p_organization_id uuid, p_type text, p_id uuid", returns: "text", security: "definer" },
500
+ { name: "shared_only_disagreements", args: "p_pretend text DEFAULT NULL::text", returns: "TABLE(organization_id uuid, organization_name text, member_id uuid, record_id uuid, table_id uuid, ladder boolean, read_door boolean, rls_mirror boolean, why text)", security: "invoker" },
451
501
  { name: "size_refusal", args: "p_organization_id uuid, p_data jsonb", returns: "text", security: "invoker" },
452
502
  { name: "source_next_pointer", args: "p_sources jsonb", returns: "text", security: "invoker" },
453
503
  { name: "source_pointer", args: "p_sources jsonb, p_source jsonb", returns: "text", security: "invoker" },
@@ -457,13 +507,14 @@ var STORE_DOORS = [
457
507
  { name: "table_capacity", args: "p_organization_id uuid, p_table_id uuid", returns: "jsonb", security: "definer" },
458
508
  { name: "table_contents", args: "p_organization_id uuid, p_table_id uuid", returns: "TABLE(record_id uuid, kind text, goes_at integer)", security: "invoker" },
459
509
  { name: "table_declare", args: "p_organization_id uuid, p_spec jsonb", returns: "uuid", security: "definer" },
510
+ { name: "table_has_a_visible_record", args: "p_user uuid, p_organization_id uuid, p_table_id uuid", returns: "boolean", security: "definer" },
460
511
  { name: "table_is_live", args: "p_organization_id uuid, p_table_id uuid", returns: "boolean", security: "invoker" },
461
512
  { name: "table_kernel_id", args: "", returns: "uuid", security: "invoker" },
462
513
  { name: "table_record_ceiling", args: "", returns: "integer", security: "invoker" },
463
514
  { name: "table_record_ceiling", args: "p_organization_id uuid", returns: "integer", security: "invoker" },
464
515
  { name: "table_rules", args: "p_organization_id uuid, p_table_id uuid, p_use text, p_record_type text DEFAULT NULL::text", returns: "SETOF custom.record", security: "invoker" },
465
516
  { name: "table_storage", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "invoker" },
466
- { name: "table_type_field", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "invoker" },
517
+ { name: "table_type_field", args: "p_organization_id uuid, p_table_id uuid", returns: "text", security: "definer" },
467
518
  { name: "tables_at_home", args: "p_organization_id uuid, p_home_ids uuid[]", returns: "TABLE(table_id uuid, home_record_id uuid, kind text)", security: "definer" },
468
519
  { name: "tables_described_without_asking", args: "", returns: "TABLE(function_name text, identity_args text, why text)", security: "invoker" },
469
520
  { name: "trg_associations_bump_visibility", args: "", returns: "trigger", security: "definer" },
@@ -474,14 +525,16 @@ var STORE_DOORS = [
474
525
  { name: "value_envelope_keys", args: "", returns: "text[]", security: "invoker" },
475
526
  { name: "value_envelope_ok", args: "p_data jsonb", returns: "boolean", security: "invoker" },
476
527
  { name: "value_envelope_refusal", args: "p_data jsonb", returns: "text", security: "invoker" },
477
- { name: "value_read", args: "p_organization_id uuid, p_record_id uuid, p_key text", returns: "TABLE(field_key text, field_id uuid, value jsonb, value_version integer, source jsonb, absent_reason text, actor text, on_behalf_of text, written_at timestamp with time zone, alternates jsonb)", security: "invoker" },
528
+ { name: "value_read", args: "p_organization_id uuid, p_record_id uuid, p_key text", returns: "TABLE(field_key text, field_id uuid, value jsonb, value_version integer, source jsonb, absent_reason text, actor text, on_behalf_of text, written_at timestamp with time zone, alternates jsonb)", security: "definer" },
478
529
  { name: "value_versions", args: "p_old jsonb, p_new jsonb", returns: "jsonb", security: "invoker" },
479
530
  { name: "visibility_ancestors", args: "p_item_type text, p_item_id uuid", returns: "TABLE(container_type text, container_id uuid, depth integer, max_level permission_level)", security: "definer" },
480
531
  { name: "visibility_as_of", args: "p_organization_id uuid, p_record_id uuid, p_at timestamp with time zone", returns: "TABLE(principal_kind text, principal_id uuid, level permission_level, through_kind text, through_id uuid, reason text, replayed boolean, held_from timestamp with time zone, held_to timestamp with time zone)", security: "definer" },
481
532
  { name: "visibility_cache_rebuild", args: "", returns: "integer", security: "definer" },
482
533
  { name: "visibility_parity", args: "", returns: "TABLE(side text, container_type text, container_id uuid, item_type text, item_id uuid, stored_level permission_level, derived_level permission_level, reason text)", security: "definer" },
483
534
  { name: "visibility_warm", args: "p_container_type text, p_container_id uuid", returns: "integer", security: "definer" },
535
+ { name: "visible_predicate_sql", args: "p_user uuid, p_organization_id uuid, p_table_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level, p_alias text DEFAULT 'r'::text", returns: "text", security: "definer" },
484
536
  { name: "visible_record_ids", args: "p_user_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level", returns: "TABLE(id uuid)", security: "definer" },
537
+ { name: "visible_set", args: "p_user uuid, p_organization_id uuid, p_table_id uuid, p_required permission_level DEFAULT 'viewer'::permission_level, OUT o_all_visible boolean, OUT o_true_visibility platform.visibility[], OUT o_granted_all uuid[], OUT o_granted_visible uuid[], OUT o_carried_visible uuid[], OUT o_ladder_calls integer, OUT o_fallback boolean, OUT o_note text", returns: "record", security: "definer" },
485
538
  { name: "widget_kernel_id", args: "", returns: "uuid", security: "invoker" },
486
539
  { name: "work_assignment_fields", args: "p_options_table_id uuid DEFAULT NULL::uuid", returns: "TABLE(key text, label text, spec jsonb)", security: "invoker" },
487
540
  { name: "work_has_assignment", args: "p_organization_id uuid, p_table_id uuid", returns: "boolean", security: "invoker" },
@@ -503,9 +556,9 @@ var STORE_DOORS = [
503
556
  { name: "work_whose_turn", args: "p_organization_id uuid, p_table_id uuid, p_include_finished boolean DEFAULT false", returns: "TABLE(record_id uuid, title text, assignee_id uuid, turn text, due_on timestamp with time zone, state text, status text, terminal boolean)", security: "invoker" }
504
557
  ];
505
558
  var STORE_KNOBS = [
506
- { key: "accessible_entity_ids_guard", value: "false", type: "boolean" },
507
- { key: "agent_schema_changes", value: '"propose"', type: "string" },
508
- { key: "associations_guard", value: "false", type: "boolean" },
559
+ { key: "accessible_entity_ids_guard", value: "true", type: "boolean" },
560
+ { key: "agent_schema_changes", value: '"ask"', type: "string" },
561
+ { key: "associations_guard", value: "true", type: "boolean" },
509
562
  { key: "code_paths_enabled", value: "false", type: "boolean" },
510
563
  { key: "consumer_chat_seeding_enabled", value: "false", type: "boolean" },
511
564
  { key: "consumer_checkout_enabled", value: "false", type: "boolean" },
@@ -525,7 +578,7 @@ var STORE_KNOBS = [
525
578
  { key: "external_principal_enabled", value: "false", type: "boolean" },
526
579
  { key: "field_index_guard", value: "false", type: "boolean" },
527
580
  { key: "field_sensitivity_levels", value: '{"edit": {"public": "editor", "internal": "editor", "restricted": "admin", "confidential": "admin"}, "read": {"public": "viewer", "internal": "viewer", "restricted": "admin", "confidential": "editor"}}', type: "json" },
528
- { key: "member_default_level", value: '"viewer"', type: "string" },
581
+ { key: "member_default_level", value: '"viewer"', type: "enum" },
529
582
  { key: "member_default_visibility", value: '"all_records"', type: "enum" },
530
583
  { key: "records_tool_default", value: "true", type: "boolean" },
531
584
  { key: "row_versions_guard", value: "false", type: "boolean" },
@@ -544,12 +597,12 @@ var STORE_REFUSAL_CODES = [
544
597
  { code: "0A000", raised_by: "external_rows,external_source_declare,external_write_through,promote_field,promoted_index_expr,promoted_query_sql,promoted_read,rule_eval,work_slots_declare" },
545
598
  { code: "22004", raised_by: "_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,doc_render_write,doc_sign,doc_signature_write,doc_template_save,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,home_add,io_comment_write,io_import_open,io_outbox_drain,io_restore,migrate_purge,migrate_split,migrate_undo,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,relation_carry,relation_own,share_grant,table_declare,work_template_declare" },
546
599
  { code: "22012", raised_by: "rule_eval" },
547
- { code: "22023", raised_by: "_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,containment_parent,doc_render_body,doc_render_write,doc_signature_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,io_import_open,io_proposal_accept,migrate_merge,query_by_coordinates,query_rollup,record_update,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,table_rules,visibility_as_of,work_slot_hold" },
600
+ { code: "22023", raised_by: "_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,containment_parent,doc_render_body,doc_render_write,doc_signature_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,io_import_open,io_proposal_accept,migrate_merge,my_levels,query_by_coordinates,query_rollup,record_update,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,table_rules,visibility_as_of,work_slot_hold" },
548
601
  { code: "23503", raised_by: "_containment_guard,_record_rule_uses,anon_publish,anon_rate_take,anon_token_issue,anon_write,assert_organization_wall,delete_rule,doc_sign,doc_template_save,home_add,io_comment_write,io_import_rows,io_proposal_accept,migrate_demote,migrate_promote,promote_field,promote_table,record_applicability,record_reparent,relation_carry,relation_own,resolve_first_match,rule_applies,rule_eval,rule_members,rule_run,work_take_assignment,work_template_instantiate" },
549
- { code: "23505", raised_by: "doc_sign,doc_signature_write,field_declare,home_add,io_proposal_accept,relation_carry,relation_own,share_grant,work_slot_hold" },
550
- { code: "23514", raised_by: "_containment_guard,_dated_values_guard,_derived_fields,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_shape_guard,_value_envelope,_work_shape_guard,doc_sign,doc_signature_write,doc_template_save,field_declare,field_retire,field_update,home_add,migrate_merge,relation_carry,relation_own,validate_value_envelope,validate_values,work_slots_declare,work_take_assignment,work_template_instantiate" },
602
+ { code: "23505", raised_by: "_unique_rule_holds,doc_sign,doc_signature_write,field_declare,home_add,io_proposal_accept,relation_carry,relation_own,share_grant,work_slot_hold" },
603
+ { code: "23514", raised_by: "_containment_guard,_dated_values_guard,_derived_fields,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_shape_guard,_value_envelope,_work_shape_guard,doc_sign,doc_signature_write,doc_template_save,field_declare,field_retire,field_update,home_add,migrate_merge,relation_carry,relation_own,validate_value_envelope,validate_values,work_slots_declare,work_take_assignment,work_template_instantiate" },
551
604
  { code: "40001", raised_by: "has_visibility_at" },
552
- { code: "42501", raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_organization_admin,assert_store_door,external_write_through,io_comment_resolve,io_comment_write,io_restore,migrate_purge,promote_table,query_visibility_parity,read_record,read_records,share_grant,visibility_as_of" },
605
+ { code: "42501", raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,external_write_through,io_comment_resolve,io_comment_write,io_restore,migrate_purge,my_levels,promote_table,query_visibility_parity,read_record,read_records,share_grant,visibility_as_of" },
553
606
  { code: "53400", raised_by: "anon_rate_take,delete_cascade_closure,promote_field" },
554
607
  { code: "54001", raised_by: "record_delete" },
555
608
  { code: "PT409", raised_by: "record_update" }
@@ -1671,6 +1724,10 @@ var DOORS = {
1671
1724
  recordReparent: "record_reparent",
1672
1725
  containmentChain: "containment_chain",
1673
1726
  storeIsOpen: "store_is_open",
1727
+ // DOOR-1, from the screen's side. What level the CALLER holds on the subjects
1728
+ // they name — the one question a screen has to answer BEFORE it draws a
1729
+ // control, and the only one the store had no client answer to.
1730
+ myLevels: "my_levels",
1674
1731
  // DOOR-11. The record's own revision list. A screen that offers an optimistic
1675
1732
  // save needs the version it LOADED, and the read door answers documents, not
1676
1733
  // versions — so the version comes from here, once, for the one record being
@@ -2663,6 +2720,18 @@ function createRecordsClient(config) {
2663
2720
  },
2664
2721
  async storeIsOpen() {
2665
2722
  return callDoor(DOORS.storeIsOpen, { p_organization_id: org }, "storeIsOpen");
2723
+ },
2724
+ async myLevels({ ids, subject }) {
2725
+ if (ids.length === 0) return ok([]);
2726
+ const answered = await callDoor(
2727
+ DOORS.myLevels,
2728
+ { p_organization_id: org, p_ids: ids, p_type: subject ?? "record" },
2729
+ "myLevels"
2730
+ );
2731
+ if (!answered.ok) return err(answered.error);
2732
+ return ok(
2733
+ (answered.data ?? []).map((row) => ({ id: row.id, level: asPermissionLevel(row.level) }))
2734
+ );
2666
2735
  }
2667
2736
  };
2668
2737
  return client;