latticesql 3.4.3 → 3.4.4

package/dist/index.cjs

@@ -238,13 +238,14 @@ function readManifest(outputDir) {
 function writeManifest(outputDir, manifest) {
   atomicWrite(manifestPath(outputDir), JSON.stringify(manifest, null, 2));
 }
-var import_node_path2, import_node_fs2;
+var import_node_path2, import_node_fs2, TEMPLATE_VERSION;
 var init_manifest = __esm({
   "src/lifecycle/manifest.ts"() {
     "use strict";
     import_node_path2 = require("path");
     import_node_fs2 = require("fs");
     init_writer();
+    TEMPLATE_VERSION = 1;
   }
 });
 
@@ -278,6 +279,126 @@ var init_adapter = __esm({
   }
 });
 
+// src/lifecycle/render-cursor.ts
+function markToString(v2) {
+  if (v2 == null) return null;
+  if (v2 instanceof Date) return v2.toISOString();
+  if (typeof v2 === "string") return v2;
+  if (typeof v2 === "number" || typeof v2 === "bigint" || typeof v2 === "boolean") return String(v2);
+  return null;
+}
+function padNumericMark(v2) {
+  const s2 = markToString(v2);
+  if (s2 == null) return null;
+  if (/^\d+$/.test(s2)) return s2.padStart(20, "0");
+  return s2;
+}
+async function changelogExists(adapter) {
+  if (adapter.dialect === "postgres") {
+    const row2 = await getAsyncOrSync(
+      adapter,
+      `SELECT to_regclass('__lattice_changelog') AS reg`
+    );
+    return !!row2 && row2.reg != null;
+  }
+  const row = await getAsyncOrSync(
+    adapter,
+    `SELECT name FROM sqlite_master WHERE type='table' AND name='__lattice_changelog'`
+  );
+  return !!row;
+}
+async function changelogMark(adapter) {
+  try {
+    if (!await changelogExists(adapter)) return null;
+    const col = adapter.dialect === "postgres" ? "seq" : "rowid";
+    const row = await getAsyncOrSync(
+      adapter,
+      `SELECT MAX(${col}) AS m FROM __lattice_changelog`
+    );
+    return padNumericMark(row?.m);
+  } catch {
+    return null;
+  }
+}
+async function sharingMarks(adapter) {
+  if (adapter.dialect !== "postgres") return { grants: null, owners: null };
+  try {
+    const reg = await getAsyncOrSync(
+      adapter,
+      `SELECT to_regclass('__lattice_changes') AS reg`
+    );
+    const hasFeed = !!reg && reg.reg != null;
+    if (hasFeed) {
+      const row = await getAsyncOrSync(
+        adapter,
+        `SELECT COUNT(*) AS n, MAX(seq) AS m FROM lattice_changes_since(0, 1000)`
+      );
+      const digest = digestOf(row?.n, row?.m);
+      return { grants: digest, owners: digest };
+    }
+  } catch {
+  }
+  let owners = null;
+  let grants = null;
+  try {
+    const o3 = await getAsyncOrSync(
+      adapter,
+      `SELECT COUNT(*) AS n, MAX(updated_at) AS m FROM __lattice_owners`
+    );
+    owners = digestOf(o3?.n, o3?.m);
+  } catch {
+    owners = null;
+  }
+  try {
+    const g6 = await getAsyncOrSync(
+      adapter,
+      `SELECT COUNT(*) AS n, MAX(granted_at) AS m FROM __lattice_row_grants`
+    );
+    grants = digestOf(g6?.n, g6?.m);
+  } catch {
+    grants = null;
+  }
+  return { grants, owners };
+}
+function digestOf(count, max) {
+  const n3 = padNumericMark(count);
+  if (n3 == null) return null;
+  const m4 = markToString(max) ?? "";
+  return `${n3}#${m4}`;
+}
+async function computeRenderCursor(adapter) {
+  try {
+    const [changelog, sharing] = await Promise.all([changelogMark(adapter), sharingMarks(adapter)]);
+    return { changelog, grants: sharing.grants, owners: sharing.owners };
+  } catch {
+    return { ...EMPTY_CURSOR };
+  }
+}
+function cursorIsFresh(recorded, live, templateVersion = TEMPLATE_VERSION) {
+  if (recorded == null) return false;
+  if (recorded.templateVersion !== templateVersion) return false;
+  const rc = recorded.cursor;
+  if (rc == null) return false;
+  if (!fieldFresh(rc.changelog, live.changelog, (r6, l4) => l4 <= r6)) return false;
+  if (!fieldFresh(rc.grants, live.grants, (r6, l4) => l4 === r6)) return false;
+  if (!fieldFresh(rc.owners, live.owners, (r6, l4) => l4 === r6)) return false;
+  return true;
+}
+function fieldFresh(recorded, live, ok) {
+  if (recorded == null && live == null) return true;
+  if (recorded == null || live == null) return false;
+  return ok(recorded, live);
+}
+var EMPTY_CURSOR;
+var init_render_cursor = __esm({
+  "src/lifecycle/render-cursor.ts"() {
+    "use strict";
+    init_adapter();
+    init_manifest();
+    EMPTY_CURSOR = { changelog: null, grants: null, owners: null };
+  }
+});
+
 // src/db/sqlite.ts
 var import_better_sqlite3, SQLiteAdapter;
 var init_sqlite = __esm({
@@ -2320,7 +2441,18 @@ var init_concurrency = __esm({
 });
 
 // src/render/engine.ts
-var import_node_path5, import_node_fs4, YIELD_EVERY_ENTITIES, RENDER_TABLE_CONCURRENCY, NOOP_RENDER, RenderEngine;
+function entityContentChanged(fresh, prior) {
+  const freshKeys = Object.keys(fresh);
+  const priorKeys = Object.keys(prior);
+  if (freshKeys.length !== priorKeys.length) return true;
+  for (const k6 of freshKeys) {
+    const p3 = prior[k6];
+    if (p3 == null) return true;
+    if (p3.hash === "" || p3.hash !== fresh[k6]?.hash) return true;
+  }
+  return false;
+}
+var import_node_path5, import_node_fs4, DeferredTableProgress, YIELD_EVERY_ENTITIES, RENDER_TABLE_CONCURRENCY, NOOP_RENDER, RenderEngine;
 var init_engine = __esm({
   "src/render/engine.ts"() {
     "use strict";
@@ -2332,9 +2464,44 @@ var init_engine = __esm({
     init_entity_query();
     init_entity_templates();
     init_manifest();
+    init_render_cursor();
     init_cleanup();
     init_progress();
     init_concurrency();
+    DeferredTableProgress = class {
+      constructor(throttle) {
+        this.throttle = throttle;
+      }
+      changed = false;
+      pendingStart = null;
+      /** Buffer the `table-start` event; emitted only if/when the table changes. */
+      start(event) {
+        if (this.changed) {
+          this.throttle.force(event);
+          return;
+        }
+        this.pendingStart = event;
+      }
+      /** Mark that an entity's content changed — flush the held `table-start` once. */
+      markChanged() {
+        if (this.changed) return;
+        this.changed = true;
+        if (this.pendingStart) {
+          this.throttle.force(this.pendingStart);
+          this.pendingStart = null;
+        }
+      }
+      /** Coalesced per-entity progress — dropped entirely until the table changed. */
+      tick(event) {
+        if (!this.changed) return;
+        this.throttle.tick(event);
+      }
+      /** Lifecycle event (`table-done`) — emitted only if the table changed. */
+      force(event) {
+        if (!this.changed) return;
+        this.throttle.force(event);
+      }
+    };
     YIELD_EVERY_ENTITIES = 200;
     RENDER_TABLE_CONCURRENCY = 4;
     NOOP_RENDER = () => "";
@@ -2451,20 +2618,23 @@ var init_engine = __esm({
           }
           const content = def.tokenBudget ? applyTokenBudget(rows, def.render, def.tokenBudget, def.prioritizeBy) : def.render(rows);
           const filePath = (0, import_node_path5.join)(outputDir, def.outputFile);
-          if (atomicWrite(filePath, content)) {
+          const wrote = atomicWrite(filePath, content);
+          if (wrote) {
             filesWritten.push(filePath);
           } else {
             counters.skipped++;
           }
-          throttle.force({
-            kind: "table-done",
-            table: name,
-            entitiesRendered: rows.length,
-            entitiesTotal: rows.length,
-            tableIndex: 0,
-            tableCount: 0,
-            pct: 100
-          });
+          if (wrote) {
+            throttle.force({
+              kind: "table-done",
+              table: name,
+              entitiesRendered: rows.length,
+              entitiesTotal: rows.length,
+              tableIndex: 0,
+              tableCount: 0,
+              pct: 100
+            });
+          }
         }
         for (const [name, def] of this._schema.getMultis()) {
           if (signal?.aborted) return this._abortedResult(filesWritten, counters, start);
@@ -2478,32 +2648,38 @@ var init_engine = __esm({
               tables[t8] = await this._schema.queryTable(this._adapter, t8, this._readRel);
             }
           }
+          let wroteAny = false;
           for (const key of keys) {
             const content = def.render(key, tables);
             const filePath = (0, import_node_path5.join)(outputDir, def.outputFile(key));
             if (atomicWrite(filePath, content)) {
               filesWritten.push(filePath);
+              wroteAny = true;
             } else {
               counters.skipped++;
             }
           }
-          throttle.force({
-            kind: "table-done",
-            table: name,
-            entitiesRendered: keys.length,
-            entitiesTotal: keys.length,
-            tableIndex: 0,
-            tableCount: 0,
-            pct: 100
-          });
+          if (wroteAny) {
+            throttle.force({
+              kind: "table-done",
+              table: name,
+              entitiesRendered: keys.length,
+              entitiesTotal: keys.length,
+              tableIndex: 0,
+              tableCount: 0,
+              pct: 100
+            });
+          }
         }
+        const priorManifest = readManifest(outputDir);
         const entityContextManifest = await this._renderEntityContexts(
           outputDir,
           filesWritten,
           counters,
           throttle,
           signal,
-          opts.changedTables
+          opts.changedTables,
+          priorManifest
         );
         if (entityContextManifest === null) {
           return this._abortedResult(filesWritten, counters, start);
@@ -2514,10 +2690,13 @@ var init_engine = __esm({
             const prev = readManifest(outputDir);
             entityContexts = { ...prev?.entityContexts ?? {}, ...entityContextManifest };
           }
+          const cursor = await computeRenderCursor(this._adapter);
           writeManifest(outputDir, {
             version: 2,
             generated_at: (/* @__PURE__ */ new Date()).toISOString(),
-            entityContexts
+            entityContexts,
+            templateVersion: TEMPLATE_VERSION,
+            cursor
           });
         }
         const result = {
@@ -2583,7 +2762,7 @@ var init_engine = __esm({
        * partial tree). Progress is reported through `throttle`; abort is observed
        * via `signal`.
        */
-      async _renderEntityContexts(outputDir, filesWritten, counters, throttle, signal, changedTables) {
+      async _renderEntityContexts(outputDir, filesWritten, counters, throttle, signal, changedTables, priorManifest) {
         const protectedTables = /* @__PURE__ */ new Set();
         for (const [t8, d6] of this._schema.getEntityContexts()) {
           if (d6.protected) protectedTables.add(t8);
@@ -2602,8 +2781,10 @@ var init_engine = __esm({
             const baseRows = await this._schema.queryTable(this._adapter, table, this._readRel);
             const allRows = this._foldRows ? await this._foldRows(table, baseRows) : baseRows;
             const directoryRoot = def.directoryRoot ?? table;
+            const deferred = new DeferredTableProgress(throttle);
+            const priorEntities = priorManifest?.entityContexts[table]?.entities ?? {};
             const entitiesTotal = allRows.length;
-            throttle.force({
+            deferred.start({
               kind: "table-start",
               table,
               entitiesRendered: 0,
@@ -2612,6 +2793,7 @@ var init_engine = __esm({
               tableCount,
               pct: 0
             });
+            if (Object.keys(priorEntities).length !== entitiesTotal) deferred.markChanged();
             const manifestEntry = {
               directoryRoot,
               ...def.index ? { indexFile: def.index.outputFile } : {},
@@ -2727,8 +2909,10 @@ var init_engine = __esm({
                 }
               }
               manifestEntry.entities[slug] = entityFileHashes;
+              const priorHashes = normalizeEntityFiles(priorEntities[slug] ?? {});
+              if (entityContentChanged(entityFileHashes, priorHashes)) deferred.markChanged();
               const entitiesRendered = i6 + 1;
-              throttle.tick({
+              deferred.tick({
                 kind: "table-progress",
                 table,
                 entitiesRendered,
@@ -2738,7 +2922,7 @@ var init_engine = __esm({
                 pct: entitiesTotal > 0 ? entitiesRendered / entitiesTotal * 100 : 100
               });
             }
-            throttle.force({
+            deferred.force({
               kind: "table-done",
               table,
               entitiesRendered: entitiesTotal,
@@ -4161,6 +4345,22 @@ function deleteAssistantCredential(kind) {
   void _removed;
   saveAssistantCredentials(rest);
 }
+function isAssistantCredentialCleared(kind) {
+  return loadAssistantCredentials()[CLEARED_SENTINEL_PREFIX + kind] === "1";
+}
+function setAssistantCredentialCleared(kind) {
+  const creds = loadAssistantCredentials();
+  creds[CLEARED_SENTINEL_PREFIX + kind] = "1";
+  saveAssistantCredentials(creds);
+}
+function clearAssistantCredentialCleared(kind) {
+  const creds = loadAssistantCredentials();
+  const sentinel = CLEARED_SENTINEL_PREFIX + kind;
+  if (!(sentinel in creds)) return;
+  const { [sentinel]: _removed, ...rest } = creds;
+  void _removed;
+  saveAssistantCredentials(rest);
+}
 function ensureKeysDir() {
   const dir = (0, import_node_path10.join)(ensureConfigDir(), KEYS_SUBDIR);
   if (!(0, import_node_fs9.existsSync)(dir)) {
@@ -4205,7 +4405,7 @@ function deleteToken(label) {
   const path2 = (0, import_node_path10.join)(ensureKeysDir(), label + TOKEN_EXT);
   if ((0, import_node_fs9.existsSync)(path2)) (0, import_node_fs9.unlinkSync)(path2);
 }
-var import_node_crypto5, import_node_fs9, import_node_os3, import_node_path10, import_yaml2, MASTER_KEY_FILENAME, IDENTITY_FILENAME, EMPTY_IDENTITY, PREFERENCES_FILENAME, DEFAULT_PREFERENCES, DB_CREDENTIALS_FILENAME, CRED_LOCK_FILENAME, LOCK_STALE_MS, LOCK_TIMEOUT_MS, lockDepthInProcess, S3_CONFIG_FILENAME, ASSISTANT_CREDENTIALS_FILENAME, KEYS_SUBDIR, TOKEN_EXT;
+var import_node_crypto5, import_node_fs9, import_node_os3, import_node_path10, import_yaml2, MASTER_KEY_FILENAME, IDENTITY_FILENAME, EMPTY_IDENTITY, PREFERENCES_FILENAME, DEFAULT_PREFERENCES, DB_CREDENTIALS_FILENAME, CRED_LOCK_FILENAME, LOCK_STALE_MS, LOCK_TIMEOUT_MS, lockDepthInProcess, S3_CONFIG_FILENAME, ASSISTANT_CREDENTIALS_FILENAME, CLEARED_SENTINEL_PREFIX, KEYS_SUBDIR, TOKEN_EXT;
 var init_user_config = __esm({
   "src/framework/user-config.ts"() {
     "use strict";
@@ -4233,6 +4433,7 @@ var init_user_config = __esm({
     lockDepthInProcess = 0;
     S3_CONFIG_FILENAME = "s3-config.enc";
     ASSISTANT_CREDENTIALS_FILENAME = "assistant-credentials.enc";
+    CLEARED_SENTINEL_PREFIX = "__cleared__:";
     KEYS_SUBDIR = "keys";
     TOKEN_EXT = ".token";
   }
@@ -5243,6 +5444,7 @@ var init_lattice = __esm({
     init_shred();
     init_encryption();
     init_manifest();
+    init_render_cursor();
     import_node_fs12 = require("fs");
     init_adapter();
     init_sqlite();
@@ -5314,6 +5516,14 @@ var init_lattice = __esm({
       _changelogTables = /* @__PURE__ */ new Set();
       /** Current task context string for relevance filtering. */
       _taskContext = "";
+      /**
+       * True when this connection opened against an already-provisioned cloud as a
+       * SCOPED MEMBER (no role-management privilege → no CREATE/ALTER on the schema).
+       * Set during init() by the same probe that decides introspect-only. Drives
+       * {@link addColumn} to route DDL through the owner-side `lattice_member_add_column`
+       * SECURITY DEFINER helper instead of issuing a raw ALTER the member can't run.
+       */
+      _cloudMemberOpen = false;
       _auditHandlers = [];
       _renderHandlers = [];
       _writebackHandlers = [];
@@ -5560,7 +5770,7 @@ var init_lattice = __esm({
       /** Async tail of init(). See {@link init} for the sync-validation phase. */
       async _initAsync(options) {
         let introspectOnly = options.introspectOnly === true;
-        if (!introspectOnly && this.getDialect() === "postgres") {
+        if (this.getDialect() === "postgres") {
           try {
             const [marker, role] = await Promise.all([
               getAsyncOrSync(this._adapter, `SELECT to_regclass('__lattice_owners') AS reg`),
@@ -5571,7 +5781,9 @@ var init_lattice = __esm({
             ]);
             const provisioned = !!marker && marker.reg != null;
             const canCreateRoles = !!role && role.rolcreaterole === true;
-            introspectOnly = provisioned && !canCreateRoles;
+            const memberOpen = provisioned && !canCreateRoles;
+            introspectOnly = introspectOnly || memberOpen;
+            this._cloudMemberOpen = memberOpen;
           } catch {
           }
         }
@@ -5659,6 +5871,26 @@ var init_lattice = __esm({
       getDialect() {
         return this._adapter.dialect;
       }
+      /**
+       * True when a table opts into the observation/changelog substrate
+       * (`def.changelog`). Callers that want to bypass the high-level {@link delete}
+       * with a transaction-scoped raw delete use this to know whether the table also
+       * needs the changelog / write-hook / embedding side effects that only
+       * `delete()` performs — so they can keep the high-level path for such tables.
+       */
+      isChangelogTracked(table) {
+        return this._changelogTables.has(table);
+      }
+      /**
+       * True when this connection opened as a scoped cloud MEMBER (see
+       * {@link _cloudMemberOpen}). Callers use it to route DDL-bearing work through
+       * the owner-side SECURITY DEFINER helpers rather than issuing DDL the member's
+       * role can't run (e.g. {@link addColumn} regenerates the masking view inside
+       * `lattice_member_add_column`, so the caller must not also try to regenerate it).
+       */
+      isCloudMemberOpen() {
+        return this._cloudMemberOpen;
+      }
       /**
        * Return the normalised primary-key column list for a registered
        * table. Falls back to `['id']` for tables registered via raw DDL
@@ -5735,7 +5967,15 @@ var init_lattice = __esm({
         assertSafeIdentifier(column, "column");
         const existing = await introspectColumnsAsyncOrSync(this._adapter, table);
         if (!existing.includes(column)) {
-          await addColumnAsyncOrSync(this._adapter, table, column, typeSpec);
+          if (this._cloudMemberOpen) {
+            await runAsyncOrSync(this._adapter, `SELECT lattice_member_add_column(?, ?, ?)`, [
+              table,
+              column,
+              typeSpec
+            ]);
+          } else {
+            await addColumnAsyncOrSync(this._adapter, table, column, typeSpec);
+          }
         }
         const cols = await introspectColumnsAsyncOrSync(this._adapter, table);
         this._columnCache.set(table, new Set(cols));
@@ -6667,12 +6907,39 @@ var init_lattice = __esm({
       async renderInBackground(outputDir, opts = {}) {
         const notInit = this._notInitError();
         if (notInit) return notInit;
+        if (opts.gateOnOpen && !opts.changedTables) {
+          const start = Date.now();
+          const recorded = readManifest(outputDir);
+          if (recorded != null) {
+            const live = await computeRenderCursor(this._adapter);
+            if (cursorIsFresh(recorded, live)) {
+              opts.onProgress?.({
+                kind: "done",
+                table: null,
+                entitiesRendered: 0,
+                entitiesTotal: 0,
+                tableIndex: 0,
+                tableCount: 0,
+                pct: 100,
+                durationMs: Date.now() - start
+              });
+              const skipped = {
+                filesWritten: [],
+                filesSkipped: 0,
+                durationMs: Date.now() - start
+              };
+              for (const h6 of this._renderHandlers) h6(skipped);
+              return skipped;
+            }
+          }
+        }
         if (!opts.changedTables) {
           this._pendingRenderAll = false;
           this._pendingRenderTables = /* @__PURE__ */ new Set();
           this._autoRenderPending = false;
         }
-        return this._renderGuarded(outputDir, opts);
+        const { gateOnOpen: _gateOnOpen, ...engineOpts } = opts;
+        return this._renderGuarded(outputDir, engineOpts);
       }
       /**
        * Install a per-viewer read-relation resolver for ALL renders (initial,
@@ -47870,6 +48137,111 @@ LANGUAGE sql STABLE SECURITY DEFINER AS $fn$
      AND g."pk" = ANY(p_pks)
      AND o."owner_role" = session_user;
 $fn$;
+
+-- Add a column to a user table AS THE OWNER, on behalf of a scoped member. A
+-- member's role has no CREATE/ALTER on the schema (the bootstrap REVOKEs CREATE
+-- from PUBLIC), so a member's GUI "add a field" write (createRow/updateRow with a
+-- field the table lacks) cannot run ALTER TABLE itself. This SECURITY DEFINER
+-- helper performs that ALTER \u2014 and the masking-view regen \u2014 with the owner's
+-- rights, so member-added columns behave identically to owner-added ones.
+--
+-- Injection-safe + minimal: p_table must be an existing BASE table in the current
+-- schema (rejected otherwise); p_type is whitelisted against the exact set the
+-- library's addColumn emits for an auto-added column (TEXT / INTEGER / REAL, plus
+-- BOOLEAN) \u2014 never interpolated raw; both identifiers go through %I (quote_ident).
+-- Member-callable (granted EXECUTE to the member group), but it can only widen the
+-- schema, never read or alter another member's data.
+CREATE OR REPLACE FUNCTION lattice_member_add_column(p_table text, p_column text, p_type text)
+RETURNS void LANGUAGE plpgsql SECURITY DEFINER AS $fn$
+DECLARE
+  v_type      text;
+  v_view      text := p_table || '_v';
+  v_has_view  boolean;
+  v_pk_expr   text;
+  v_select    text;
+BEGIN
+  -- Never alter internal bookkeeping tables (names start with "_"). The GUI only
+  -- ever calls this for a user entity table; rejecting the rest is defense-in-depth
+  -- against a member invoking the function directly against ownership/audit/policy
+  -- tables.
+  IF left(p_table, 1) = '_' THEN
+    RAISE EXCEPTION 'lattice: cannot add a column to internal table "%"', p_table;
+  END IF;
+
+  -- p_table must be a real base table in THIS schema (search_path is pinned to the
+  -- cloud schema by pinDefinerSearchPath, so to_regclass resolves there).
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_class c
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+     WHERE n.nspname = current_schema() AND c.relname = p_table AND c.relkind = 'r'
+  ) THEN
+    RAISE EXCEPTION 'lattice: no such table "%"', p_table;
+  END IF;
+
+  -- Whitelist the column type. These are exactly the specs addColumn's
+  -- inferColumnType produces (TEXT / INTEGER / REAL); BOOLEAN is allowed too.
+  -- Anything else is rejected \u2014 the type is spliced as %s (NOT %I), so it must be
+  -- a known-safe literal and never caller-controlled SQL.
+  v_type := upper(btrim(p_type));
+  IF v_type NOT IN ('TEXT', 'INTEGER', 'REAL', 'BOOLEAN') THEN
+    RAISE EXCEPTION 'lattice: unsupported column type "%"', p_type;
+  END IF;
+
+  EXECUTE format('ALTER TABLE %I ADD COLUMN IF NOT EXISTS %I %s', p_table, p_column, v_type);
+
+  -- If the table is cell-masked (a "<table>_v" view exists, because some column has
+  -- an audience), the view selects an explicit column list \u2014 so a new column is
+  -- invisible to members until the view is regenerated. Rebuild it the same way the
+  -- owner path (audienceViewSql / regenerateAudienceViewFromDb) does: pass every
+  -- column through except those with an 'owner' audience in __lattice_column_policy
+  -- (CASE WHEN lattice_is_owner(...) THEN col END), re-apply row visibility with
+  -- WHERE lattice_row_visible(table, pk), and keep the member SELECT grant on the
+  -- view. Unmasked tables need no regen \u2014 the member group's table-level base grant
+  -- already covers the new column.
+  SELECT EXISTS (
+    SELECT 1 FROM pg_class c
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+     WHERE n.nspname = current_schema() AND c.relname = v_view AND c.relkind = 'v'
+  ) INTO v_has_view;
+
+  IF v_has_view THEN
+    -- Canonical pk expression: CAST("col" AS TEXT) joined by TAB (chr(9)) \u2014 the
+    -- same serialization the RLS policies + audienceViewSql use.
+    SELECT string_agg(format('CAST(%I AS TEXT)', a.attname), ' || chr(9) || '
+                      ORDER BY array_position(i.indkey, a.attnum))
+      INTO v_pk_expr
+      FROM pg_index i
+      JOIN pg_class c ON c.oid = i.indrelid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+      JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum = ANY(i.indkey)
+     WHERE n.nspname = current_schema() AND c.relname = p_table AND i.indisprimary;
+    IF v_pk_expr IS NULL THEN
+      RAISE EXCEPTION 'lattice: cannot regenerate mask view for "%": no primary key', p_table;
+    END IF;
+
+    -- Build the masked SELECT list in column order, applying the per-column policy.
+    SELECT string_agg(
+             CASE
+               WHEN cp."audience" = 'owner'
+                 THEN format('CASE WHEN lattice_is_owner(%L, %s) THEN %I END AS %I',
+                             p_table, v_pk_expr, cols.column_name, cols.column_name)
+               ELSE format('%I', cols.column_name)
+             END,
+             ', ' ORDER BY cols.ordinal_position)
+      INTO v_select
+      FROM information_schema.columns cols
+      LEFT JOIN "__lattice_column_policy" cp
+        ON cp."table_name" = p_table AND cp."column_name" = cols.column_name
+       AND cp."audience" NOT IN ('', 'everyone', 'row-audience')
+     WHERE cols.table_schema = current_schema() AND cols.table_name = p_table;
+
+    EXECUTE format(
+      'CREATE OR REPLACE VIEW %I AS SELECT %s FROM %I WHERE lattice_row_visible(%L, %s)',
+      v_view, v_select, p_table, p_table, v_pk_expr);
+    EXECUTE format('GRANT SELECT ON %I TO ${MEMBER_GROUP}', v_view);
+  END IF;
+END $fn$;
+GRANT EXECUTE ON FUNCTION lattice_member_add_column(text, text, text) TO ${MEMBER_GROUP};
 `;
   }
 });
@@ -47979,6 +48351,11 @@ async function revokeRow(db, table, pk, grantee) {
   assertPg(db);
   await runAsyncOrSync(db.adapter, `SELECT lattice_revoke_row(?, ?, ?)`, [table, pk, grantee]);
 }
+async function batchRowGrants(db, table, pk, grant, revoke) {
+  assertPg(db);
+  for (const grantee of grant) await grantRow(db, table, pk, grantee);
+  for (const grantee of revoke) await revokeRow(db, table, pk, grantee);
+}
 async function revokeMemberRole(db, role) {
   assertPg(db);
   if (!ROLE_RE.test(role)) throw new Error(`lattice: invalid member role name "${role}"`);
@@ -49082,18 +49459,9 @@ function sessionUndoneFilters(undone, sessionId) {
   if (sessionId) filters.push({ col: "session_id", op: "eq", val: sessionId });
   return filters;
 }
-async function appendAudit(db, feed, table, rowId, op, before, after, source = "gui", sessionId, editTs) {
-  const undone = await db.query("_lattice_gui_audit", {
-    filters: sessionUndoneFilters(1, sessionId)
-  });
-  for (const r6 of undone) await db.delete("_lattice_gui_audit", r6.id);
-  await db.insert("_lattice_gui_audit", {
+function buildAuditRow(table, rowId, op, before, after, sessionId, editTs) {
+  return {
     id: crypto.randomUUID(),
-    // Set ts explicitly (don't rely on the column DEFAULT — it uses the
-    // SQLite-only `strftime(...)`, which doesn't yield a parseable ISO string
-    // on Postgres, so cloud history rendered "Invalid Date"). #4.6 — honor the
-    // originating client's validated edit time when present (an offline edit
-    // replayed later records when it was MADE, not when it synced), else now().
     ts: sanitizeEditTs(editTs) ?? (/* @__PURE__ */ new Date()).toISOString(),
     table_name: table,
     row_id: rowId,
@@ -49102,7 +49470,9 @@ async function appendAudit(db, feed, table, rowId, op, before, after, source = "
     after_json: after ? JSON.stringify(after) : null,
     undone: 0,
     session_id: sessionId ?? null
-  });
+  };
+}
+function publishMutationFeed(feed, table, rowId, op, before, after, source) {
   const labelRow = op === "delete" ? before : after;
   feed.publish({
     table,
@@ -49112,17 +49482,28 @@ async function appendAudit(db, feed, table, rowId, op, before, after, source = "
     summary: feedSummary(op, table, labelRow)
   });
 }
-function isSchemaOp(operation2) {
-  return operation2.startsWith(SCHEMA_OP_PREFIX);
-}
-async function recordSchemaAudit(db, feed, table, operation2, before, after, summary, source = "gui", sessionId) {
+async function purgeRedoStack(db, sessionId) {
   const undone = await db.query("_lattice_gui_audit", {
     filters: sessionUndoneFilters(1, sessionId)
   });
   for (const r6 of undone) await db.delete("_lattice_gui_audit", r6.id);
+}
+async function appendAudit(db, feed, table, rowId, op, before, after, source = "gui", sessionId, editTs) {
+  await purgeRedoStack(db, sessionId);
+  await db.insert(
+    "_lattice_gui_audit",
+    buildAuditRow(table, rowId, op, before, after, sessionId, editTs)
+  );
+  publishMutationFeed(feed, table, rowId, op, before, after, source);
+}
+function isSchemaOp(operation2) {
+  return operation2.startsWith(SCHEMA_OP_PREFIX);
+}
+async function recordSchemaAudit(db, feed, table, operation2, before, after, summary, source = "gui", sessionId) {
+  await purgeRedoStack(db, sessionId);
   await db.insert("_lattice_gui_audit", {
     id: crypto.randomUUID(),
-    // Explicit ISO ts — see appendAudit (the SQLite-only strftime DEFAULT
+    // Explicit ISO ts — see buildAuditRow (the SQLite-only strftime DEFAULT
     // rendered "Invalid Date" on the Postgres/cloud path).
     ts: (/* @__PURE__ */ new Date()).toISOString(),
     table_name: table,
@@ -49157,7 +49538,7 @@ async function ensureColumns(db, table, values) {
   const added = Object.keys(values).filter((k6) => !(k6 in existing));
   if (added.length === 0) return [];
   for (const col of added) await db.addColumn(table, col, inferColumnType(values[col]));
-  if (db.getDialect() === "postgres" && await cloudRlsInstalled(db)) {
+  if (!db.isCloudMemberOpen() && db.getDialect() === "postgres" && await cloudRlsInstalled(db)) {
     const cols = db.getRegisteredColumns(table);
     const pk = db.getPrimaryKey(table);
     if (cols && pk.length > 0) await regenerateAudienceViewFromDb(db, table, Object.keys(cols), pk);
@@ -49279,7 +49660,14 @@ async function deleteRow(ctx, table, id, hard) {
       ctx.clientTs
     );
   } else {
-    await ctx.db.delete(table, id);
+    await hardDelete(ctx, table, id, before);
+  }
+}
+async function hardDelete(ctx, table, id, before) {
+  const withClient = ctx.db.adapter.withClient?.bind(ctx.db.adapter);
+  const pkCols = ctx.db.getPrimaryKey(table);
+  const pkCol = pkCols.length === 1 ? pkCols[0] : void 0;
+  if (!withClient || ctx.db.isChangelogTracked(table) || pkCol === void 0) {
     await appendAudit(
       ctx.db,
       ctx.feed,
@@ -49292,10 +49680,30 @@ async function deleteRow(ctx, table, id, hard) {
       ctx.sessionId,
       ctx.clientTs
     );
+    await ctx.db.delete(table, id);
+    return;
   }
+  const auditRow = buildAuditRow(table, id, "delete", before, null, ctx.sessionId, ctx.clientTs);
+  await purgeRedoStack(ctx.db, ctx.sessionId);
+  const auditCols = AUDIT_COLUMNS.map((c6) => `"${c6}"`).join(", ");
+  const auditPlaceholders = AUDIT_COLUMNS.map(() => "?").join(", ");
+  const auditValues = AUDIT_COLUMNS.map((c6) => auditRow[c6]);
+  const pkColQuoted = pkCol.replace(/"/g, '""');
+  await withClient(async (tx) => {
+    await tx.run(
+      `INSERT INTO "_lattice_gui_audit" (${auditCols}) VALUES (${auditPlaceholders})`,
+      auditValues
+    );
+    await tx.run(`DELETE FROM "${table.replace(/"/g, '""')}" WHERE "${pkColQuoted}" = ?`, [id]);
+  });
+  publishMutationFeed(ctx.feed, table, id, "delete", before, null, ctx.source);
 }
-async function linkRows(ctx, table, body) {
-  await ctx.db.link(table, body);
+async function linkRows(ctx, table, body, forceVisibility) {
+  if (forceVisibility !== void 0) {
+    await ctx.db.insertForcingVisibility(table, body, forceVisibility);
+  } else {
+    await ctx.db.link(table, body);
+  }
   await appendAudit(ctx.db, ctx.feed, table, null, "link", null, body, ctx.source, ctx.sessionId);
 }
 async function unlinkRows(ctx, table, body) {
@@ -49433,13 +49841,24 @@ async function revertEntry(ctx, id) {
   });
   return { ok: true, entry };
 }
-var import_node_crypto15, SCHEMA_OP_PREFIX;
+var import_node_crypto15, AUDIT_COLUMNS, SCHEMA_OP_PREFIX;
 var init_mutations = __esm({
   "src/gui/mutations.ts"() {
     "use strict";
     import_node_crypto15 = require("crypto");
     init_cloud_connect();
     init_audience();
+    AUDIT_COLUMNS = [
+      "id",
+      "ts",
+      "table_name",
+      "row_id",
+      "operation",
+      "before_json",
+      "after_json",
+      "undone",
+      "session_id"
+    ];
     SCHEMA_OP_PREFIX = "schema.";
   }
 });
@@ -49727,6 +50146,10 @@ async function readMachineCredential(db, kind) {
   }
   return null;
 }
+async function resolveAnthropicKey(db) {
+  if (isAssistantCredentialCleared(CREDENTIALS.anthropic.kind)) return null;
+  return await readMachineCredential(db, CREDENTIALS.anthropic.kind) ?? process.env.ANTHROPIC_API_KEY ?? null;
+}
 function getAggressiveness() {
   const n3 = readPreferences().aggressiveness;
   if (!Number.isFinite(n3)) return DEFAULT_AGGRESSIVENESS;
@@ -49757,6 +50180,7 @@ async function getVoiceCredential(db) {
   return null;
 }
 async function hasCredential(db, name, envVar) {
+  if (isAssistantCredentialCleared(CREDENTIALS[name].kind)) return false;
   return Boolean(await readMachineCredential(db, CREDENTIALS[name].kind)) || Boolean(process.env[envVar]);
 }
 async function resolveClaudeAuth(db) {
@@ -49779,7 +50203,7 @@ async function resolveClaudeAuth(db) {
     } catch {
     }
   }
-  const apiKey = await readMachineCredential(db, CREDENTIALS.anthropic.kind) ?? process.env.ANTHROPIC_API_KEY ?? null;
+  const apiKey = await resolveAnthropicKey(db);
   return apiKey ? { apiKey } : null;
 }
 async function hasClaudeAuth(db) {
@@ -49876,6 +50300,7 @@ async function dispatchAssistantRoute(req, res, ctx) {
     }
     const cred = CREDENTIALS[name];
     setAssistantCredential(cred.kind, key);
+    clearAssistantCredentialCleared(cred.kind);
     if (db) {
       for (const row of await liveSecretsOfKind(db, cred.kind)) {
         await db.update("secrets", row.id, { deleted_at: (/* @__PURE__ */ new Date()).toISOString() });
@@ -49892,6 +50317,7 @@ async function dispatchAssistantRoute(req, res, ctx) {
       return true;
     }
     deleteAssistantCredential(CREDENTIALS[name].kind);
+    setAssistantCredentialCleared(CREDENTIALS[name].kind);
     if (db) {
       for (const row of await liveSecretsOfKind(db, CREDENTIALS[name].kind)) {
         await db.update("secrets", row.id, { deleted_at: (/* @__PURE__ */ new Date()).toISOString() });
@@ -52082,7 +52508,7 @@ function buildSchema(db) {
   }
   return out;
 }
-async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptions, createJunction, aggressiveness = DEFAULT_AGGRESSIVENESS, createEntity, untrusted = false) {
+async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptions, createJunction, aggressiveness = DEFAULT_AGGRESSIVENESS, createEntity, untrusted = false, privateMode = false) {
   if (!text.trim()) return [];
   const auth = await resolveClaudeAuth(db);
   if (!auth) {
@@ -52104,6 +52530,7 @@ async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptio
     });
     return [];
   }
+  const forceVis = privateMode ? "private" : void 0;
   const temperature = aggressivenessToTemperature(aggressiveness);
   let description = "";
   try {
@@ -52146,11 +52573,16 @@ async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptio
       }
       if (jx) {
         try {
-          await linkRows(mctx, jx.junction, {
-            id: crypto.randomUUID(),
-            [jx.fileFk]: fileId,
-            [jx.otherFk]: m4.id
-          });
+          await linkRows(
+            mctx,
+            jx.junction,
+            {
+              id: crypto.randomUUID(),
+              [jx.fileFk]: fileId,
+              [jx.otherFk]: m4.id
+            },
+            forceVis
+          );
           linkedCount++;
           if (created) {
             mctx.feed.publish({
@@ -52209,16 +52641,21 @@ async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptio
           if ("name" in cols && row.name == null) row.name = obj2.label;
           if ("title" in cols && row.title == null) row.title = obj2.label;
           try {
-            const { id: rowId } = await createRow(mctx, entity, row);
+            const { id: rowId } = await createRow(mctx, entity, row, forceVis);
             createdCount++;
             const ent = entity;
             const jx = junctions.find((j6) => j6.otherTable === ent) ?? (createJunction ? await createJunction(ent) : null);
             if (jx) {
-              await linkRows(mctx, jx.junction, {
-                id: crypto.randomUUID(),
-                [jx.fileFk]: fileId,
-                [jx.otherFk]: rowId
-              });
+              await linkRows(
+                mctx,
+                jx.junction,
+                {
+                  id: crypto.randomUUID(),
+                  [jx.fileFk]: fileId,
+                  [jx.otherFk]: rowId
+                },
+                forceVis
+              );
             }
           } catch (e6) {
             console.warn(`[ingest] create ${entity} from document failed:`, e6.message);
@@ -52232,12 +52669,17 @@ async function enrichWithLlm(mctx, db, fileId, text, name, junctions, descriptio
       try {
         const title = name.replace(/\.[^./\\]+$/, "").trim() || "Note";
         const body = description.length > 0 ? description : text.slice(0, 2e3);
-        const { id: noteId } = await createRow(mctx, "notes", {
-          id: crypto.randomUUID(),
-          title,
-          body,
-          source_file_id: fileId
-        });
+        const { id: noteId } = await createRow(
+          mctx,
+          "notes",
+          {
+            id: crypto.randomUUID(),
+            title,
+            body,
+            source_file_id: fileId
+          },
+          forceVis
+        );
         mctx.feed.publish({
           table: "notes",
           op: "insert",
@@ -52351,7 +52793,8 @@ async function ingestUrlAsFile(ctx, rawUrl, opts = {}) {
       ctx.enrich.createJunction,
       ctx.enrich.aggressiveness,
       ctx.enrich.createEntity,
-      true
+      true,
+      ctx.privateMode === true
     );
   }
   return {
@@ -53229,13 +53672,22 @@ function loadSdk() {
     throw new Error("Could not resolve the Anthropic constructor from '@anthropic-ai/sdk'");
   return ctor;
 }
-function createAnthropicClient(auth) {
-  const Anthropic = loadSdk();
+function buildAnthropicConfig(auth) {
   const config = {};
-  if (auth.authToken) config.authToken = auth.authToken;
-  else if (auth.apiKey) config.apiKey = auth.apiKey;
+  if (auth.authToken) {
+    config.authToken = auth.authToken;
+    config.apiKey = null;
+  } else if (auth.apiKey) {
+    config.apiKey = auth.apiKey;
+  } else {
+    config.apiKey = null;
+  }
   if (auth.betaHeader) config.defaultHeaders = { "anthropic-beta": auth.betaHeader };
-  const sdk = new Anthropic(config);
+  return config;
+}
+function createAnthropicClient(auth) {
+  const Anthropic = loadSdk();
+  const sdk = new Anthropic(buildAnthropicConfig(auth));
   return {
     async runTurn(params) {
       const stream = sdk.messages.stream({
@@ -54670,8 +55122,14 @@ var MEMBER_READABLE_BOOKKEEPING = [
   },
   {
     name: "_lattice_gui_audit",
-    privs: "SELECT, INSERT",
-    why: "GUI undo/redo + version history; RLS (enableGuiAuditRls) scopes reads to entries whose underlying row the member can see"
+    // UPDATE + DELETE are needed by undo/redo/revert (flips an entry's `undone`)
+    // and the redo-stack purge on a new mutation (deletes the session's undone
+    // entries). Safe because enableGuiAuditRls installs per-op UPDATE and DELETE
+    // policies whose USING is `row_id IS NULL OR lattice_row_visible(table_name,
+    // row_id)` — so a member can only update/delete audit rows for entities it can
+    // already see (or schema-level entries that carry no row data).
+    privs: "SELECT, INSERT, UPDATE, DELETE",
+    why: "GUI undo/redo/revert + redo-stack purge + version history; RLS (enableGuiAuditRls) scopes every op to entries whose underlying row the member can see"
   },
   {
     name: "__lattice_user_identity",
@@ -55073,6 +55531,19 @@ async function normalizeImage(path2, maxBytes) {
 function renderJpeg(sharp, path2, quality) {
   return sharp(path2).rotate().resize({ width: MAX_DIM, height: MAX_DIM, fit: "inside", withoutEnlargement: true }).jpeg({ quality }).toBuffer();
 }
+function buildVisionAnthropicConfig(auth) {
+  const config = {};
+  if (auth.authToken) {
+    config.authToken = auth.authToken;
+    config.apiKey = null;
+  } else if (auth.apiKey) {
+    config.apiKey = auth.apiKey;
+  } else {
+    config.apiKey = null;
+  }
+  if (auth.betaHeader) config.defaultHeaders = { "anthropic-beta": auth.betaHeader };
+  return config;
+}
 function defaultSender(auth) {
   return async (input) => {
     const importMetaUrl = import_meta3.url;
@@ -55080,11 +55551,7 @@ function defaultSender(auth) {
     const sdk = req("@anthropic-ai/sdk");
     const Anthropic = sdk.Anthropic ?? sdk.default;
     if (!Anthropic) throw new Error("Could not resolve Anthropic from '@anthropic-ai/sdk'");
-    const config = {};
-    if (auth.authToken) config.authToken = auth.authToken;
-    else if (auth.apiKey) config.apiKey = auth.apiKey;
-    if (auth.betaHeader) config.defaultHeaders = { "anthropic-beta": auth.betaHeader };
-    const client = new Anthropic(config);
+    const client = new Anthropic(buildVisionAnthropicConfig(auth));
     const res = await client.messages.create({
       model: input.model,
       max_tokens: 1024,
@@ -55111,11 +55578,7 @@ function defaultPdfSender(auth) {
     const sdk = req("@anthropic-ai/sdk");
     const Anthropic = sdk.Anthropic ?? sdk.default;
     if (!Anthropic) throw new Error("Could not resolve Anthropic from '@anthropic-ai/sdk'");
-    const config = {};
-    if (auth.authToken) config.authToken = auth.authToken;
-    else if (auth.apiKey) config.apiKey = auth.apiKey;
-    if (auth.betaHeader) config.defaultHeaders = { "anthropic-beta": auth.betaHeader };
-    const client = new Anthropic(config);
+    const client = new Anthropic(buildVisionAnthropicConfig(auth));
     const res = await client.messages.create({
       model: input.model,
       max_tokens: 4096,
@@ -56055,6 +56518,8 @@ var css = `
     .grants-panel .grants-title { font-weight: 600; margin-bottom: 6px; }
     .grants-panel .grants-row { display: flex; align-items: center; gap: 8px; padding: 3px 0; cursor: pointer; }
     .grants-panel .grants-row input { accent-color: var(--accent); }
+    .grants-panel .grants-actions { display: flex; align-items: center; gap: 8px; margin-top: 10px; padding-top: 8px; border-top: 1px solid var(--border); }
+    .grants-panel .grants-dirty { font-size: 12px; }
 
     /* Inline create-row at the bottom of every table */
     tr.create-row td { background: var(--surface-2); }
@@ -58521,6 +58986,15 @@ var appJs = `
     // Per-table view state: 'live' (default) or 'trash' (soft-deleted rows).
     var tableViewMode = {};
 
+    // The (table, pk) of the per-row "Manage access" grants panel that is
+    // currently open, or null when none is. A soft re-render (a concurrent edit
+    // by another client fires pg_notify \u2192 realtime refresh \u2192 renderRoute({soft})
+    // \u2192 renderDetail/renderFsItem repaint) would otherwise re-create the detail
+    // view with the panel collapsed, dropping a staged multi-select mid-edit.
+    // wireRowSharing reads this after each repaint and re-opens + re-populates the
+    // panel WITHOUT any network call, so the staged selection survives.
+    var openGrantsPanel = null;
+
     function renderTable(content, tableName) {
       var myGen = renderGen;
       clearUnseen(tableName);
@@ -58999,70 +59473,151 @@ var appJs = `
           }).catch(function (e) { showToast('Visibility update failed: ' + e.message, {}); });
         });
       });
-      var detailVisManage = content.querySelector('#detail-vis-manage');
-      if (detailVisManage) detailVisManage.addEventListener('click', function () {
+      var access = row._access || {};
+
+      // Render the staged member checklist + a single "Save sharing" / "Cancel"
+      // into the panel. Checkbox toggles mutate ONLY the local desired map \u2014
+      // NO network call per toggle (the old design auto-saved live, one POST per
+      // checkbox, and each grant's pg_notify collapsed the panel). A single batch
+      // request fires on Save. members is the already-fetched list; desired
+      // seeds from the row's current grantees (or a caller-supplied staged map
+      // when re-opening after a soft re-render).
+      function populateGrantsPanel(panel, members, desired) {
+        // Snapshot the CURRENT (committed) grantees so Save can diff desired-vs-
+        // current into adds/removes. effectiveVisibility decides whether we're
+        // actually switching INTO specific-people mode (custom-0 reads as private).
+        var current = {};
+        (access.grantees || []).forEach(function (g) { current[g] = true; });
+        if (members.length === 0) {
+          panel.innerHTML = '<div class="muted">No other members in this workspace yet.</div>';
+          panel.hidden = false;
+          return;
+        }
+        function dirtyCount() {
+          var n = 0;
+          members.forEach(function (m) {
+            if (!!desired[m.role] !== !!current[m.role]) n++;
+          });
+          return n;
+        }
+        function render() {
+          var changed = dirtyCount();
+          panel.innerHTML = '<div class="grants-title">Who can see this</div>' +
+            members.map(function (m) {
+              var label = m.name || m.email || m.role;
+              return '<label class="grants-row"><input type="checkbox" data-grant-role="' + escapeHtml(m.role) + '"' +
+                (desired[m.role] ? ' checked' : '') + '> ' + escapeHtml(label) + '</label>';
+            }).join('') +
+            '<div class="grants-actions">' +
+              '<button class="btn primary" id="grants-save"' + (changed ? '' : ' disabled') + '>Save sharing</button>' +
+              '<button class="btn" id="grants-cancel">Cancel</button>' +
+              '<span class="grants-dirty muted">' + (changed ? (changed === 1 ? '1 change' : changed + ' changes') : 'No changes') + '</span>' +
+            '</div>';
+          panel.querySelectorAll('[data-grant-role]').forEach(function (cb) {
+            cb.addEventListener('change', function () {
+              var role = cb.getAttribute('data-grant-role');
+              if (cb.checked) desired[role] = true; else delete desired[role];
+              render(); // re-render to refresh the dirty indicator + Save state
+            });
+          });
+          var cancelBtn = panel.querySelector('#grants-cancel');
+          if (cancelBtn) cancelBtn.addEventListener('click', function () { closeGrantsPanel(panel); });
+          var saveBtn = panel.querySelector('#grants-save');
+          if (saveBtn) saveBtn.addEventListener('click', function () {
+            var toAdd = [];
+            var toRemove = [];
+            members.forEach(function (m) {
+              var want = !!desired[m.role];
+              var have = !!current[m.role];
+              if (want && !have) toAdd.push(m.role);
+              if (!want && have) toRemove.push(m.role);
+            });
+            if (toAdd.length === 0 && toRemove.length === 0) { closeGrantsPanel(panel); return; }
+            // Confirm the mode change ONCE, here \u2014 only when actually switching
+            // INTO specific-people mode (effective vis isn't already custom AND we
+            // are adding at least one grantee). Never per checkbox.
+            if (effectiveVisibility(access) !== 'custom' && toAdd.length > 0) {
+              if (!confirm('Sharing this with specific people switches it off "everyone"/"private". The chosen people will be able to see it. Continue?')) return;
+            }
+            withBusy(saveBtn, function () {
+              return fetchJson('/api/cloud/row-grants', {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ table: tableName, pk: id, grant: toAdd, revoke: toRemove }),
+              }).then(function () {
+                // Mirror the committed state locally so the re-render's indicator
+                // is correct. The first grant flips the row to custom server-side;
+                // revoking the last leaves custom-0, which effectiveVisibility
+                // renders as private.
+                var list = [];
+                members.forEach(function (m) { if (desired[m.role]) list.push(m.role); });
+                access.grantees = list;
+                if (list.length > 0) access.visibility = 'custom';
+                openGrantsPanel = null; // a successful save closes the staging session
+                invalidate(tableName);
+                showToast('Sharing updated', {});
+                reRender();
+              }).catch(function (e) {
+                // Surface loudly + leave the staged selection intact so the user
+                // can retry; no silent partial-success.
+                showToast('Sharing update failed: ' + e.message, {});
+              });
+            });
+          });
+          panel.hidden = false;
+        }
+        render();
+      }
+
+      function closeGrantsPanel(panel) {
+        if (panel) panel.hidden = true;
+        openGrantsPanel = null;
+      }
+
+      // Open (or toggle shut) the manage-access panel. Fetches the member list,
+      // then stages from the row's current grantees. Opening must NOT pre-flip
+      // the row to 'custom' \u2014 that left a never-shared row stuck at "custom (0)".
+      function openManagePanel(triggerBtn) {
         var panel = content.querySelector('#grants-panel');
         if (!panel) return;
-        if (!panel.hidden) { panel.hidden = true; return; }
-        var access = row._access || {};
-        // Opening the panel must NOT pre-flip the row to 'custom' \u2014 that left a
-        // row the user never actually shared stuck at "custom (0)". The first
-        // grant flips it to custom server-side (lattice_grant_row); revoking the
-        // last leaves it custom-with-0-grantees, which now reads as private. So
-        // just load the member checklist.
-        var ensure = Promise.resolve();
-        withBusy(detailVisManage, function () {
-          return ensure.then(function () {
-            return fetchJson('/api/cloud/members');
-          }).then(function (d) {
+        if (!panel.hidden) { closeGrantsPanel(panel); return; }
+        withBusy(triggerBtn, function () {
+          return fetchJson('/api/cloud/members').then(function (d) {
             // The grant target is a member ROLE: lattice_grant_row keys on the
             // role, and _access.grantees holds role names. List every member
             // except the owner (you don't grant the owner their own row).
             var members = ((d && d.members) || []).filter(function (m) { return !m.isYou && m.status !== 'owner'; });
-            var granted = {};
-            (access.grantees || []).forEach(function (g) { granted[g] = true; });
-            if (members.length === 0) {
-              panel.innerHTML = '<div class="muted">No other members in this workspace yet.</div>';
-            } else {
-              panel.innerHTML = '<div class="grants-title">Who can see this</div>' + members.map(function (m) {
-                var label = m.name || m.email || m.role;
-                return '<label class="grants-row"><input type="checkbox" data-grant-role="' + escapeHtml(m.role) + '"' +
-                  (granted[m.role] ? ' checked' : '') + '> ' + escapeHtml(label) + '</label>';
-              }).join('');
-            }
-            panel.hidden = false;
-            panel.querySelectorAll('[data-grant-role]').forEach(function (cb) {
-              cb.addEventListener('change', function () {
-                var role = cb.getAttribute('data-grant-role');
-                cb.disabled = true;
-                fetchJson('/api/cloud/row-grant', {
-                  method: 'POST',
-                  headers: { 'content-type': 'application/json' },
-                  body: JSON.stringify({ table: tableName, pk: id, grantee: role, revoke: !cb.checked }),
-                }).then(function () {
-                  var list = access.grantees || (access.grantees = []);
-                  var at = list.indexOf(role);
-                  if (cb.checked && at === -1) list.push(role);
-                  if (!cb.checked && at !== -1) list.splice(at, 1);
-                  // The first grant flips the row to custom server-side; mirror
-                  // that locally so the indicator updates. Revoking the last leaves
-                  // visibility 'custom' but effectiveVisibility renders custom-0 as
-                  // private, so the label flips back to "Private to you".
-                  if (list.length > 0) access.visibility = 'custom';
-                  var infoEl = content.querySelector('#detail-vis-info');
-                  if (infoEl) infoEl.textContent = visInfoLabel(access);
-                  invalidate(tableName);
-                }).catch(function (e) {
-                  cb.checked = !cb.checked; // revert the failed change
-                  showToast('Access update failed: ' + e.message, {});
-                }).then(function () { cb.disabled = false; });
-              });
-            });
-            var infoEl = content.querySelector('#detail-vis-info');
-            if (infoEl) infoEl.textContent = visInfoLabel(access);
+            var desired = {};
+            (access.grantees || []).forEach(function (g) { desired[g] = true; });
+            openGrantsPanel = { table: tableName, pk: id };
+            populateGrantsPanel(panel, members, desired);
           }).catch(function (e) { showToast('Could not load members: ' + e.message, {}); });
         });
+      }
+
+      var detailVisManage = content.querySelector('#detail-vis-manage');
+      if (detailVisManage) detailVisManage.addEventListener('click', function () {
+        openManagePanel(detailVisManage);
       });
+
+      // Preserve an open panel across a soft re-render: if the tracked panel
+      // matches the row this view just repainted, re-open it and re-populate the
+      // checklist from the freshly-fetched row._access WITHOUT any network call,
+      // so a concurrent edit by another client doesn't lose a staged selection.
+      if (openGrantsPanel && openGrantsPanel.table === tableName && openGrantsPanel.pk === id) {
+        var rpanel = content.querySelector('#grants-panel');
+        if (rpanel) {
+          fetchJson('/api/cloud/members').then(function (d) {
+            // Only re-populate if THIS panel is still the tracked-open one (a
+            // newer navigation/save may have cleared it while members loaded).
+            if (!openGrantsPanel || openGrantsPanel.table !== tableName || openGrantsPanel.pk !== id) return;
+            var members = ((d && d.members) || []).filter(function (m) { return !m.isYou && m.status !== 'owner'; });
+            var desired = {};
+            (access.grantees || []).forEach(function (g) { desired[g] = true; });
+            populateGrantsPanel(rpanel, members, desired);
+          }).catch(function () { /* best-effort restore; a click reopens it */ });
+        }
+      }
     }
     function renderDetail(content, tableName, id) {
       var myGen = renderGen;
@@ -63846,13 +64401,21 @@ var appJs = `
     }
     function uploadFile(file) {
       var done = pendingIngestItem(file.name || 'file');
+      // Carry the composer's "Private mode" intent so an upload made while the
+      // box is checked is stamped private at insert, instead of inheriting the
+      // files-table default (which can be shared-to-everyone on a cloud). Read
+      // the checkbox defensively \u2014 it may not be rendered. On a local workspace
+      // the box is checked+disabled, so this is '1' there too; forced visibility
+      // is a harmless no-op on the single-user SQLite path.
+      var pv = document.getElementById('chat-private');
+      var priv = pv && pv.checked ? '1' : '0';
       return fetch('/api/ingest/upload', {
         method: 'POST',
         // Percent-encode the filename: HTTP header values must be ISO-8859-1,
         // so a Unicode filename (emoji, smart quote, accent, em-dash) would
         // otherwise make fetch() throw "String contains non ISO-8859-1 code
         // point". The server decodeURIComponent()s it back.
-        headers: { 'content-type': file.type || 'application/octet-stream', 'x-filename': encodeURIComponent(file.name || 'file') },
+        headers: { 'content-type': file.type || 'application/octet-stream', 'x-filename': encodeURIComponent(file.name || 'file'), 'x-lattice-private': priv },
         body: file,
       })
         .then(function (r) { return r.json().then(function (j) { if (!r.ok) throw new Error(j.error || ('HTTP ' + r.status)); return j; }); })
@@ -64719,10 +65282,19 @@ function isUnderGlobalPrefix(packageRoot, execPath) {
 }
 function detectInstallContext(opts = {}) {
   const pkgName = opts.pkgName ?? "latticesql";
-  const cwd = opts.cwd ?? process.cwd();
   const env2 = opts.env ?? process.env;
   const execPath = opts.execPath ?? process.execPath;
-  const modulePath = opts.modulePath ?? process.argv[1] ?? cwd;
+  const rawCwd = opts.cwd ?? process.cwd();
+  const rawModulePath = opts.modulePath ?? process.argv[1] ?? rawCwd;
+  const resolveReal = (p3) => {
+    try {
+      return (0, import_node_fs27.realpathSync)(p3);
+    } catch {
+      return p3;
+    }
+  };
+  const modulePath = resolveReal(rawModulePath);
+  const cwd = resolveReal(rawCwd);
   const packageRoot = findPackageRoot((0, import_node_path30.dirname)(modulePath), pkgName);
   if (packageRoot && (0, import_node_fs27.existsSync)((0, import_node_path30.join)(packageRoot, ".git"))) {
     return {
@@ -66508,6 +67080,27 @@ async function dispatchDbConfigRoute(req, res, ctx) {
     });
     return true;
   }
+  if (pathname === "/api/cloud/row-grants" && method === "POST") {
+    await tryHandler(res, async () => {
+      const body = await readJson(req);
+      const table = typeof body.table === "string" ? body.table : "";
+      const pk = typeof body.pk === "string" ? body.pk : "";
+      const strList = (v2) => Array.isArray(v2) ? v2.filter((x2) => typeof x2 === "string") : [];
+      const grant = strList(body.grant);
+      const revoke = strList(body.revoke);
+      if (!table || !pk) {
+        sendJson(res, { error: "table and pk are required" }, 400);
+        return;
+      }
+      if (ctx.db.getDialect() !== "postgres") {
+        sendJson(res, { error: "Per-row sharing requires a cloud (Postgres) database" }, 400);
+        return;
+      }
+      await batchRowGrants(ctx.db, table, pk, grant, revoke);
+      sendJson(res, { ok: true, table, pk, granted: grant, revoked: revoke });
+    });
+    return true;
+  }
   if (pathname === "/api/cloud/s3-config" && method === "GET") {
     await tryHandler(res, () => {
       const label = activeWorkspaceLabel(ctx.configPath);
@@ -67304,7 +67897,7 @@ function enrichContext(ctx) {
     ...ctx.createEntity ? { createEntity: ctx.createEntity } : {}
   };
 }
-async function enrichOrFail(mctx, db, fileId, text, name, ctx, res) {
+async function enrichOrFail(mctx, db, fileId, text, name, ctx, res, privateMode) {
   try {
     return await enrichWithLlm(
       mctx,
@@ -67316,7 +67909,9 @@ async function enrichOrFail(mctx, db, fileId, text, name, ctx, res) {
       ctx.entityDescriptions,
       ctx.createJunction,
       ctx.aggressiveness,
-      ctx.createEntity
+      ctx.createEntity,
+      false,
+      privateMode
     );
   } catch (e6) {
     const err = e6;
@@ -67395,7 +67990,9 @@ async function dispatchIngestRoute(req, res, ctx) {
     source: "ingest",
     onColumnsAdded: columnDescriptionHook(ctx.db)
   };
+  const headerPrivate = req.headers["x-lattice-private"] === "1";
   if (ctx.pathname === "/api/ingest/upload") {
+    const forcePrivate2 = headerPrivate;
     const rawName = typeof req.headers["x-filename"] === "string" && req.headers["x-filename"] || "";
     let name2 = "upload";
     if (rawName) {
@@ -67493,10 +68090,15 @@ async function dispatchIngestRoute(req, res, ctx) {
         ...blob ? { blob_path: blob.blob_path } : {}
       } : blob ? { ref_kind: "blob", blob_path: blob.blob_path } : {}
     };
-    const { id: id2 } = await createRow(mctx, "files", {
-      ...await requiredFileDefaults(ctx.db, name2, fileId, uploadRow),
-      ...uploadRow
-    });
+    const { id: id2 } = await createRow(
+      mctx,
+      "files",
+      {
+        ...await requiredFileDefaults(ctx.db, name2, fileId, uploadRow),
+        ...uploadRow
+      },
+      forcePrivate2 ? "private" : void 0
+    );
     try {
       const dedupCtx = {
         db: ctx.db,
@@ -67522,7 +68124,7 @@ async function dispatchIngestRoute(req, res, ctx) {
     }
     let suggestedLinks = [];
     if (!result.skip) {
-      const links = await enrichOrFail(mctx, ctx.db, id2, result.text, name2, ctx, res);
+      const links = await enrichOrFail(mctx, ctx.db, id2, result.text, name2, ctx, res, forcePrivate2);
       if (links === null) return true;
       suggestedLinks = links;
     }
@@ -67549,6 +68151,7 @@ async function dispatchIngestRoute(req, res, ctx) {
     sendJson4(res, { error: e6.message }, 400);
     return true;
   }
+  const forcePrivate = headerPrivate || body.private === true;
   if (ctx.pathname === "/api/ingest/text") {
     const rawText = typeof body.text === "string" ? body.text : "";
     if (!rawText.trim()) {
@@ -67559,7 +68162,7 @@ async function dispatchIngestRoute(req, res, ctx) {
     if (sourceUrl) {
       try {
         const result = await ingestUrlAsFile(
-          { db: ctx.db, mctx, enrich: enrichContext(ctx) },
+          { db: ctx.db, mctx, enrich: enrichContext(ctx), privateMode: forcePrivate },
           sourceUrl
         );
         sendJson4(
@@ -67588,11 +68191,25 @@ async function dispatchIngestRoute(req, res, ctx) {
       description: describe(content, mime2, title),
       extraction_status: "extracted"
     };
-    const { id: id2 } = await createRow(mctx, "files", {
-      ...await requiredFileDefaults(ctx.db, title, textFileId, textRow),
-      ...textRow
-    });
-    const suggestedLinks = await enrichOrFail(mctx, ctx.db, id2, content, title, ctx, res);
+    const { id: id2 } = await createRow(
+      mctx,
+      "files",
+      {
+        ...await requiredFileDefaults(ctx.db, title, textFileId, textRow),
+        ...textRow
+      },
+      forcePrivate ? "private" : void 0
+    );
+    const suggestedLinks = await enrichOrFail(
+      mctx,
+      ctx.db,
+      id2,
+      content,
+      title,
+      ctx,
+      res,
+      forcePrivate
+    );
     if (suggestedLinks === null) return true;
     sendJson4(res, { id: id2, extraction_status: "extracted", suggestedLinks }, 201);
     return true;
@@ -67631,10 +68248,15 @@ async function dispatchIngestRoute(req, res, ctx) {
     size_bytes: size,
     extraction_status: "pending"
   };
-  const { id } = await createRow(mctx, "files", {
-    ...await requiredFileDefaults(ctx.db, name, localFileId, localRow),
-    ...localRow
-  });
+  const { id } = await createRow(
+    mctx,
+    "files",
+    {
+      ...await requiredFileDefaults(ctx.db, name, localFileId, localRow),
+      ...localRow
+    },
+    forcePrivate ? "private" : void 0
+  );
   try {
     const result = await extractSource(ctx.db, abs, mime, name);
     await updateRow(mctx, "files", id, {
@@ -67652,7 +68274,9 @@ async function dispatchIngestRoute(req, res, ctx) {
       ctx.entityDescriptions,
       ctx.createJunction,
       ctx.aggressiveness,
-      ctx.createEntity
+      ctx.createEntity,
+      false,
+      forcePrivate
     );
     sendJson4(
       res,
@@ -68339,7 +68963,7 @@ function startBackgroundRender(active) {
     }
     bus.publish(e6);
   };
-  void db.renderInBackground(active.outputDir, { signal, onProgress }).then(
+  void db.renderInBackground(active.outputDir, { signal, onProgress, gateOnOpen: true }).then(
     () => {
     },
     (err) => {