@promptowl/contextnest-community 1.13.0 → 1.15.0

package/dist/{chunk-Q5NRCDD4.js → chunk-7BOG3S5H.js}

@@ -4,208 +4,27 @@ import {
   NotFoundError,
   ValidationError
 } from "./chunk-GUNJTORH.js";
-import {
-  normalizeEmail
-} from "./chunk-FRQJWGN3.js";
-import {
-  insertOrReplace,
-  nowExpr
-} from "./chunk-XQ46F76G.js";
 import {
   config,
   getDb,
   isEmailish
-} from "./chunk-5QQ7WKAI.js";
+} from "./chunk-BCFKLY4H.js";
 import {
   ANON_USER_ID
 } from "./chunk-SLTQACJW.js";
-
-// src/governance/stewardship-service.ts
-import { v4 as uuid3 } from "uuid";
-
-// src/governance/access-service.ts
-import { readFileSync, existsSync } from "fs";
-import { join } from "path";
-var accessConfig = null;
-var grantedSuperAdmins = /* @__PURE__ */ new Set();
-async function loadGrantedSuperAdmins() {
-  const rows = await getDb().all(
-    "SELECT email FROM super_admins"
-  );
-  grantedSuperAdmins = new Set(rows.map((r) => r.email.toLowerCase()));
-}
-function loadAccessConfig() {
-  const candidates = [
-    join(config.DATA_ROOT, "access.yaml"),
-    join(config.DATA_ROOT, "access.yml")
-  ];
-  for (const path of candidates) {
-    if (existsSync(path)) {
-      const content = readFileSync(path, "utf-8");
-      accessConfig = parseAccessYaml(content);
-      return accessConfig;
-    }
-  }
-  accessConfig = null;
-  return null;
-}
-function getAccessConfig() {
-  return accessConfig;
-}
-function isSuperAdmin(email) {
-  const lower = email.toLowerCase();
-  if (grantedSuperAdmins.has(lower)) return true;
-  return isConfigSuperAdmin(lower);
-}
-function isConfigSuperAdmin(email) {
-  if (!accessConfig?.super_admins) return false;
-  return accessConfig.super_admins.map((e) => e.toLowerCase()).includes(email.toLowerCase());
-}
-function parseAccessYaml(content) {
-  const result = {};
-  const lines = content.split("\n");
-  let currentSection = null;
-  let currentGroup = null;
-  let inMembers = false;
-  for (const rawLine of lines) {
-    const line = rawLine.trimEnd();
-    if (!line || line.startsWith("#")) continue;
-    if (!line.startsWith(" ") && !line.startsWith("	")) {
-      const match = line.match(/^(\w+):\s*(.*)?$/);
-      if (!match) continue;
-      const key = match[1];
-      const value = match[2]?.trim();
-      if (key === "mode") {
-        result.mode = value;
-        currentSection = null;
-      } else if (key === "allowed_users") {
-        currentSection = "allowed_users";
-        result.allowed_users = [];
-      } else if (key === "groups") {
-        currentSection = "groups";
-        result.groups = {};
-      } else if (key === "super_admins") {
-        currentSection = "super_admins";
-        result.super_admins = [];
-      }
-      currentGroup = null;
-      inMembers = false;
-      continue;
-    }
-    const listMatch = line.match(/^\s+-\s+["']?([^"'\n]+?)["']?\s*$/);
-    if (currentSection === "allowed_users" && listMatch) {
-      result.allowed_users.push(listMatch[1].trim());
-      continue;
-    }
-    if (currentSection === "super_admins" && listMatch) {
-      result.super_admins.push(listMatch[1].trim());
-      continue;
-    }
-    if (currentSection === "groups") {
-      const groupMatch = line.match(/^  (\w+):$/);
-      if (groupMatch) {
-        currentGroup = groupMatch[1];
-        result.groups[currentGroup] = { members: [], default_permission: "read" };
-        inMembers = false;
-        continue;
-      }
-      if (currentGroup) {
-        const propMatch = line.match(/^\s{4}(\w+):\s*(.*)?$/);
-        if (propMatch) {
-          const prop = propMatch[1];
-          const val = propMatch[2]?.trim();
-          if (prop === "default_permission" && val) {
-            result.groups[currentGroup].default_permission = val;
-          }
-          if (prop === "members") {
-            inMembers = true;
-          }
-          continue;
-        }
-        if (inMembers && listMatch) {
-          result.groups[currentGroup].members.push(listMatch[1].trim());
-        }
-      }
-    }
-  }
-  return result;
-}
-
-// src/nodes/engine.ts
 import {
-  NestStorage as NestStorage3,
-  GraphQueryEngine,
-  VersionManager
-} from "@promptowl/contextnest-engine";
-
-// src/nests/service.ts
-import { rmSync as rmSync2, mkdirSync } from "fs";
-import { v4 as uuid2 } from "uuid";
-import { NestStorage } from "@promptowl/contextnest-engine";
+  normalizeEmail
+} from "./chunk-FRQJWGN3.js";
 
-// src/fs/vault-import.ts
-import { rmSync } from "fs";
-import { writeFile, mkdir } from "fs/promises";
-import { join as join2, dirname, isAbsolute } from "path";
-function isSkippedSegment(segment) {
-  return segment.startsWith(".") || segment === "node_modules" || segment === "_suggestions";
-}
-function safeSegments(rel) {
-  if (!rel || isAbsolute(rel)) return null;
-  const segs = rel.split(/[\\/]/).filter(Boolean);
-  if (!segs.length) return null;
-  for (const s of segs) {
-    if (s === "..") return null;
-    if (s !== ".versions" && isSkippedSegment(s)) return null;
-  }
-  return segs;
-}
-var WRITE_CONCURRENCY = 32;
-async function writeImportedFiles(dest, files) {
-  const targets = [];
-  const skipped = [];
-  for (const f of files) {
-    const segs = safeSegments(f?.path || "");
-    if (!segs) {
-      skipped.push(f?.path || "(empty)");
-      continue;
-    }
-    targets.push({ full: join2(dest, ...segs), content: f.content ?? "" });
-  }
-  const dirs = new Set(targets.map((t) => dirname(t.full)));
-  await Promise.all([...dirs].map((d) => mkdir(d, { recursive: true })));
-  let written = 0;
-  for (let i = 0; i < targets.length; i += WRITE_CONCURRENCY) {
-    const batch = targets.slice(i, i + WRITE_CONCURRENCY);
-    await Promise.all(
-      batch.map(async (t) => {
-        await writeFile(t.full, t.content, "utf-8");
-        written++;
-      })
-    );
-  }
-  console.log(
-    `[import] writeImportedFiles: received=${files.length} written=${written} skipped=${skipped.length}`
-  );
-  if (skipped.length) {
-    console.log("[import] skipped (unsafe/hidden path):", skipped.join(", "));
-  }
-  return written;
-}
-function discardImportDir(dest) {
-  try {
-    rmSync(dest, { recursive: true, force: true });
-  } catch {
-  }
+// src/db/sql.ts
+function nowExpr(db) {
+  return db.dialect === "sqlite" ? "datetime('now')" : "to_char((now() AT TIME ZONE 'utc'), 'YYYY-MM-DD HH24:MI:SS')";
 }
-
-// src/shared/paths.ts
-import { join as join3 } from "path";
-function nestStorageRoot() {
-  return config.NEST_STORAGE_ROOT;
+function insertOrIgnore(db, insertSql) {
+  return db.dialect === "sqlite" ? insertSql.replace(/^\s*INSERT\s+INTO/i, "INSERT OR IGNORE INTO") : `${insertSql} ON CONFLICT DO NOTHING`;
 }
-function resolveNestPath(nestId) {
-  return join3(nestStorageRoot(), nestId);
+function insertOrReplace(db, insertSql, conflictCols, set) {
+  return db.dialect === "sqlite" ? insertSql.replace(/^\s*INSERT\s+INTO/i, "INSERT OR REPLACE INTO") : `${insertSql} ON CONFLICT (${conflictCols.join(", ")}) DO UPDATE SET ${set}`;
 }
 
 // src/telemetry/tracker.ts
@@ -639,1527 +458,1697 @@ async function _validateLicenseImpl(forceFresh) {
   }
 }
 
-// src/governance/teams-service.ts
-import { v4 as uuid } from "uuid";
-var VALID_TEAM_ROLES = ["admin", "editor", "viewer"];
-function parseMembers(json) {
-  if (!json) return [];
-  try {
-    const parsed = JSON.parse(json);
-    return Array.isArray(parsed) ? parsed : [];
-  } catch {
-    return [];
-  }
-}
-function rowToTeam(row) {
-  return {
-    id: row.id,
-    name: row.name,
-    owner_id: row.owner_id,
-    members: parseMembers(row.members),
-    source: row.source ?? null,
-    external_id: row.external_id ?? null,
-    created_at: row.created_at,
-    updated_at: row.updated_at
-  };
+// src/governance/access-service.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+var accessConfig = null;
+var grantedSuperAdmins = /* @__PURE__ */ new Set();
+async function loadGrantedSuperAdmins() {
+  const rows = await getDb().all(
+    "SELECT email FROM super_admins"
+  );
+  grantedSuperAdmins = new Set(rows.map((r) => r.email.toLowerCase()));
 }
-async function enrichTeam(team) {
-  const db = getDb();
-  const ids = team.members.map((m) => m.userId);
-  const invited = /* @__PURE__ */ new Map();
-  if (ids.length) {
-    const rows = await db.all(
-      `SELECT id, is_invited FROM users WHERE id IN (${ids.map(() => "?").join(",")})`,
-      ids
-    );
-    for (const r of rows) invited.set(r.id, r.is_invited);
+function loadAccessConfig() {
+  const candidates = [
+    join(config.DATA_ROOT, "access.yaml"),
+    join(config.DATA_ROOT, "access.yml")
+  ];
+  for (const path of candidates) {
+    if (existsSync(path)) {
+      const content = readFileSync(path, "utf-8");
+      accessConfig = parseAccessYaml(content);
+      return accessConfig;
+    }
   }
-  const owner = await db.get("SELECT email FROM users WHERE id = ?", [
-    team.owner_id
-  ]);
-  return {
-    ...team,
-    owner_email: owner?.email,
-    // Unknown id (deleted user) → treat as not registered.
-    members: team.members.map((m) => ({
-      ...m,
-      registered: (invited.get(m.userId) ?? 1) === 0
-    }))
-  };
+  accessConfig = null;
+  return null;
 }
-function assertValidRole(role) {
-  if (!VALID_TEAM_ROLES.includes(role)) {
-    throw new ValidationError(
-      "role must be admin, editor, or viewer"
-    );
-  }
-}
-async function loadTeamRow(teamId) {
-  const db = getDb();
-  const row = await db.get("SELECT * FROM teams WHERE id = ?", [
-    teamId
-  ]);
-  if (!row) throw new NotFoundError("Team not found");
-  return row;
-}
-var ROLE_RANK = {
-  viewer: 1,
-  editor: 2,
-  admin: 3
-};
-var OWNER_RANK = 4;
-function managementRank(row, callerUserId, allowAdmin) {
-  if (row.owner_id === callerUserId || allowAdmin) return OWNER_RANK;
-  const m = parseMembers(row.members).find((x) => x.userId === callerUserId);
-  return m ? ROLE_RANK[m.role] ?? 0 : 0;
-}
-async function createTeam(params) {
-  const name = params.name?.trim();
-  if (!name) throw new ValidationError("Team name is required");
-  const db = getDb();
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const id = uuid();
-  await db.run(
-    "INSERT INTO teams (id, name, owner_id, members, source, external_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
-    [
-      id,
-      name,
-      params.ownerId,
-      "[]",
-      params.source ?? null,
-      params.externalId ?? null,
-      now,
-      now
-    ]
-  );
-  return enrichTeam(rowToTeam(await loadTeamRow(id)));
+function getAccessConfig() {
+  return accessConfig;
 }
-async function findTeamByExternalId(params) {
-  const db = getDb();
-  const row = await db.get(
-    "SELECT * FROM teams WHERE owner_id = ? AND source = ? AND external_id = ?",
-    [params.ownerId, params.source, params.externalId]
-  );
-  return row ? enrichTeam(rowToTeam(row)) : null;
+function isSuperAdmin(email) {
+  const lower = email.toLowerCase();
+  if (grantedSuperAdmins.has(lower)) return true;
+  return isConfigSuperAdmin(lower);
 }
-async function listTeamsForUser(userId) {
-  const db = getDb();
-  const rows = await db.all(
-    "SELECT * FROM teams WHERE owner_id = ? OR members LIKE ? ORDER BY created_at",
-    [userId, `%${userId}%`]
-  );
-  const mine = rows.filter(
-    (r) => r.owner_id === userId || parseMembers(r.members).some((m) => m.userId === userId)
-  );
-  return Promise.all(mine.map((r) => enrichTeam(rowToTeam(r))));
+function isConfigSuperAdmin(email) {
+  if (!accessConfig?.super_admins) return false;
+  return accessConfig.super_admins.map((e) => e.toLowerCase()).includes(email.toLowerCase());
 }
-async function getTeam(teamId) {
-  return enrichTeam(rowToTeam(await loadTeamRow(teamId)));
+function parseAccessYaml(content) {
+  const result = {};
+  const lines = content.split("\n");
+  let currentSection = null;
+  let currentGroup = null;
+  let inMembers = false;
+  for (const rawLine of lines) {
+    const line = rawLine.trimEnd();
+    if (!line || line.startsWith("#")) continue;
+    if (!line.startsWith(" ") && !line.startsWith("	")) {
+      const match = line.match(/^(\w+):\s*(.*)?$/);
+      if (!match) continue;
+      const key = match[1];
+      const value = match[2]?.trim();
+      if (key === "mode") {
+        result.mode = value;
+        currentSection = null;
+      } else if (key === "allowed_users") {
+        currentSection = "allowed_users";
+        result.allowed_users = [];
+      } else if (key === "groups") {
+        currentSection = "groups";
+        result.groups = {};
+      } else if (key === "super_admins") {
+        currentSection = "super_admins";
+        result.super_admins = [];
+      }
+      currentGroup = null;
+      inMembers = false;
+      continue;
+    }
+    const listMatch = line.match(/^\s+-\s+["']?([^"'\n]+?)["']?\s*$/);
+    if (currentSection === "allowed_users" && listMatch) {
+      result.allowed_users.push(listMatch[1].trim());
+      continue;
+    }
+    if (currentSection === "super_admins" && listMatch) {
+      result.super_admins.push(listMatch[1].trim());
+      continue;
+    }
+    if (currentSection === "groups") {
+      const groupMatch = line.match(/^  (\w+):$/);
+      if (groupMatch) {
+        currentGroup = groupMatch[1];
+        result.groups[currentGroup] = { members: [], default_permission: "read" };
+        inMembers = false;
+        continue;
+      }
+      if (currentGroup) {
+        const propMatch = line.match(/^\s{4}(\w+):\s*(.*)?$/);
+        if (propMatch) {
+          const prop = propMatch[1];
+          const val = propMatch[2]?.trim();
+          if (prop === "default_permission" && val) {
+            result.groups[currentGroup].default_permission = val;
+          }
+          if (prop === "members") {
+            inMembers = true;
+          }
+          continue;
+        }
+        if (inMembers && listMatch) {
+          result.groups[currentGroup].members.push(listMatch[1].trim());
+        }
+      }
+    }
+  }
+  return result;
 }
-async function renameTeam(params) {
-  const name = params.name?.trim();
-  if (!name) throw new ValidationError("Team name is required");
-  const row = await loadTeamRow(params.teamId);
-  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
-    throw new ForbiddenError("Only a team admin or the owner can rename this team.");
+
+// src/notify/email-render.ts
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+var EVENT = {
+  ":white_check_mark:": { icon: "\u2705", color: "#16a34a" },
+  ":x:": { icon: "\u274C", color: "#dc2626" },
+  ":memo:": { icon: "\u{1F4DD}", color: "#d97706" },
+  ":key:": { icon: "\u{1F511}", color: "#2563eb" }
+};
+var ALL_EMOJI = Object.fromEntries(
+  Object.entries(EVENT).map(([code, m]) => [code, m.icon])
+);
+function renderText(message) {
+  return message.replace(/:[a-z_]+:/g, (m) => ALL_EMOJI[m] ?? "").replace(/\*/g, "").replace(/[ \t]{2,}/g, " ").trim();
+}
+var STATUS_META = {
+  approved: { subjectWord: "approved", label: "Approved", color: "#16a34a" },
+  rejected: { subjectWord: "rejected", label: "Rejected", color: "#dc2626" },
+  pending_review: {
+    subjectWord: "awaiting review",
+    label: "Pending review",
+    color: "#d97706"
+  },
+  shared: { subjectWord: "shared with you", label: "Shared", color: "#2563eb" },
+  invited: { subjectWord: "invited you", label: "Invitation", color: "#2563eb" },
+  steward: { subjectWord: "steward", label: "Steward", color: "#7c3aed" },
+  deletion_requested: {
+    subjectWord: "flagged for deletion",
+    label: "Deletion requested",
+    color: "#d97706"
+  },
+  deletion_declined: {
+    subjectWord: "kept",
+    label: "Deletion declined",
+    color: "#d97706"
+  },
+  deletion_deleted: {
+    subjectWord: "deleted",
+    label: "Deleted",
+    color: "#dc2626"
   }
-  const db = getDb();
-  await db.transaction(async (tx) => {
-    await tx.run("UPDATE teams SET name = ?, updated_at = ? WHERE id = ?", [
-      name,
-      (/* @__PURE__ */ new Date()).toISOString(),
-      params.teamId
-    ]);
-    await refreshTeamNameRefs(tx, params.teamId, name);
-  });
-  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
+};
+var cap = (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+var detailRow = (label, valueHtml) => `<tr>
+      <td style="padding:5px 0;font-size:13px;color:#6b7280;width:90px;vertical-align:top;">${label}</td>
+      <td style="padding:5px 0;font-size:13px;color:#111827;vertical-align:top;">${valueHtml}</td>
+    </tr>`;
+var plainRow = (label, value) => ({
+  label,
+  text: value,
+  html: escapeHtml(value)
+});
+var governanceRows = (x) => [
+  plainRow("Path", x.d.path),
+  { label: "Status", text: x.meta.label, html: x.statusBadge },
+  ...x.d.version != null ? [plainRow("Version", `v${x.d.version}`)] : []
+];
+var TEMPLATES = {
+  approved: {
+    heading: (x) => `${x.title} is ${x.meta.subjectWord}`,
+    detailsHeader: "Document details",
+    linkLabel: "Open document",
+    lineT: (x) => `${x.title}${x.vT} has been approved${x.byT}${x.noteT}.`,
+    lineH: (x) => `${x.doc}${x.vH} has been approved${x.byH}${x.noteH}.`,
+    rows: governanceRows
+  },
+  rejected: {
+    heading: (x) => `${x.title} is ${x.meta.subjectWord}`,
+    detailsHeader: "Document details",
+    linkLabel: "Open document",
+    lineT: (x) => `${x.title}${x.vT} has been rejected${x.byT}${x.noteT}.`,
+    lineH: (x) => `${x.doc}${x.vH} has been rejected${x.byH}${x.noteH}.`,
+    rows: governanceRows
+  },
+  pending_review: {
+    heading: (x) => `${x.title} is ${x.meta.subjectWord}`,
+    detailsHeader: "Document details",
+    linkLabel: "Open document",
+    lineT: (x) => `A review has been requested for ${x.title}${x.vT}${x.byT}${x.noteT}.`,
+    lineH: (x) => `A review has been requested for ${x.doc}${x.vH}${x.byH}${x.noteH}.`,
+    rows: governanceRows
+  },
+  shared: {
+    heading: (x) => `You've been added to ${x.title}`,
+    detailsHeader: "Details",
+    linkLabel: "Open nest",
+    lineT: (x) => `You've been given ${x.d.permission || "collaborator"} access to ${x.title}${x.d.by ? ` by ${x.d.by}` : ""}. Open it below to start collaborating.`,
+    lineH: (x) => `You've been given <strong>${escapeHtml(x.d.permission || "collaborator")}</strong> access to ${x.doc}${x.d.by ? ` by ${escapeHtml(x.d.by)}` : ""}. Open it below to start collaborating.`,
+    rows: (x) => [
+      plainRow("Nest", x.d.path),
+      ...x.d.permission ? [plainRow("Role", cap(x.d.permission))] : []
+    ]
+  },
+  invited: {
+    heading: (x) => `You've been invited to ${x.title}`,
+    detailsHeader: "Sign-in details",
+    linkLabel: "Sign in",
+    lineT: (x) => `You've been invited to ${x.title}${x.d.by ? ` by ${x.d.by}` : ""}. Sign in with your email and the temporary password below, then choose your own password.`,
+    lineH: (x) => `You've been invited to ${x.doc}${x.d.by ? ` by ${escapeHtml(x.d.by)}` : ""}. Sign in with your email and the temporary password below, then choose your own password.`,
+    rows: (x) => [
+      plainRow("Email", x.d.actor || ""),
+      ...x.d.tempPassword ? [
+        {
+          label: "Temporary password",
+          text: x.d.tempPassword,
+          html: x.codeValue(x.d.tempPassword)
+        }
+      ] : []
+    ]
+  },
+  // Deletion requests reuse the governance details block — same "what/where/
+  // status" shape, and the reason/note rides in `note` like a review note.
+  deletion_requested: {
+    heading: (x) => `${x.title} is ${x.meta.subjectWord}`,
+    detailsHeader: "Document details",
+    linkLabel: "Review the request",
+    lineT: (x) => `${x.title} has been flagged for deletion${x.byT}${x.noteT}. Delete it or decline the request from the nest.`,
+    lineH: (x) => `${x.doc} has been flagged for deletion${x.byH}${x.noteH}. Delete it or decline the request from the nest.`,
+    rows: governanceRows
+  },
+  deletion_declined: {
+    heading: (x) => `Your deletion request for ${x.title} was declined`,
+    detailsHeader: "Document details",
+    linkLabel: "Open document",
+    lineT: (x) => `Your request to delete ${x.title} was declined${x.byT}${x.noteT}. The document stays.`,
+    lineH: (x) => `Your request to delete ${x.doc} was declined${x.byH}${x.noteH}. The document stays.`,
+    rows: governanceRows
+  },
+  deletion_deleted: {
+    heading: (x) => `${x.title} was ${x.meta.subjectWord}`,
+    detailsHeader: "Document details",
+    linkLabel: "Open nest",
+    lineT: (x) => `${x.title} has been deleted${x.byT}${x.noteT} \u2014 your deletion request was accepted.`,
+    lineH: (x) => `${x.doc} has been deleted${x.byH}${x.noteH} \u2014 your deletion request was accepted.`,
+    rows: governanceRows
+  },
+  steward: {
+    heading: (x) => `You're now a steward of ${x.title}`,
+    detailsHeader: "Details",
+    linkLabel: "Open nest",
+    lineT: (x) => `You've been assigned as a ${x.d.permission || "reviewer"} steward of ${x.d.scopeLabel || x.title}${x.d.by ? ` by ${x.d.by}` : ""}. Open the nest below to start reviewing.`,
+    lineH: (x) => `You've been assigned as a <strong>${escapeHtml(x.d.permission || "reviewer")}</strong> steward of ${x.d.scopeLabel ? escapeHtml(x.d.scopeLabel) : x.doc}${x.d.by ? ` by ${escapeHtml(x.d.by)}` : ""}. Open the nest below to start reviewing.`,
+    rows: (x) => [
+      plainRow("Nest", x.d.path),
+      ...x.d.permission ? [plainRow("Role", cap(x.d.permission))] : [],
+      ...x.d.scopeLabel ? [plainRow("Scope", cap(x.d.scopeLabel))] : []
+    ]
+  }
+};
+function renderEmail(d) {
+  const meta = STATUS_META[d.status];
+  const t = TEMPLATES[d.status];
+  const title = d.docTitle.replace(/[\r\n]+/g, " ").trim();
+  const vLabel = d.version != null ? `v${d.version}` : "";
+  const ctx = {
+    d,
+    title,
+    doc: `<strong>${escapeHtml(title)}</strong>`,
+    byT: d.actor ? ` by ${d.actor}` : "",
+    byH: d.actor ? ` by ${escapeHtml(d.actor)}` : "",
+    noteT: d.note ? ` with the note: "${d.note}"` : "",
+    noteH: d.note ? ` with the note: &ldquo;${escapeHtml(d.note)}&rdquo;` : "",
+    vT: vLabel ? ` ${vLabel}` : "",
+    vH: vLabel ? ` ${vLabel}` : "",
+    meta,
+    statusBadge: `<span style="display:inline-block;padding:2px 9px;border-radius:9999px;background:#f3f4f6;color:${meta.color};font-size:12px;font-weight:600;">${meta.label}</span>`,
+    codeValue: (v) => `<span style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:13px;font-weight:600;color:#111827;background:#f3f4f6;padding:2px 8px;border-radius:6px;">${escapeHtml(v)}</span>`
+  };
+  const heading = t.heading(ctx).replace(/[\r\n]+/g, " ").trim();
+  const subject = heading;
+  const detailsHeader = t.detailsHeader;
+  const linkLabel = t.linkLabel;
+  const lineH = t.lineH(ctx);
+  const rows = t.rows(ctx);
+  const detailLines = [
+    `${detailsHeader}:`,
+    ...rows.map((r) => `  ${r.label}: ${r.text}`),
+    ...d.link ? [`  ${linkLabel}: ${d.link}`] : []
+  ];
+  const text = ["Hi,", "", t.lineT(ctx), "", ...detailLines, "", "Regards,", "Community Nest"].join("\n");
+  const detailRows = rows.map((r) => detailRow(r.label, r.html)).join("");
+  const buttonRow = d.link ? `<tr><td style="padding:20px 24px 0;">
+        <table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr>
+          <td bgcolor="${meta.color}" style="border-radius:6px;">
+            <a href="${escapeHtml(d.link)}" target="_blank" style="display:inline-block;padding:10px 20px;font-size:14px;font-weight:600;color:#ffffff;text-decoration:none;">${linkLabel}</a>
+          </td>
+        </tr></table>
+      </td></tr>` : "";
+  const html = `<div style="margin:0;padding:24px;background:#f6f8fa;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;color:#111827;">
+  <table role="presentation" width="480" cellpadding="0" cellspacing="0" border="0" align="center" style="width:100%;max-width:480px;margin:0 auto;background:#ffffff;border:1px solid #e5e7eb;border-radius:12px;">
+    <tr><td style="padding:20px 24px 0;">
+      <div style="font-size:12px;font-weight:700;color:#6b7280;letter-spacing:0.06em;text-transform:uppercase;">ContextNest</div>
+    </td></tr>
+    <tr><td style="padding:10px 24px 0;">
+      <h1 style="margin:0;font-size:19px;line-height:1.35;font-weight:700;color:#111827;">${escapeHtml(heading)}</h1>
+    </td></tr>
+    <tr><td style="padding:16px 24px 0;font-size:14px;line-height:1.6;color:#374151;">
+      Hi,<br><br>${lineH}
+    </td></tr>
+    <tr><td style="padding:20px 24px 0;">
+      <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border:1px solid #eef0f2;border-radius:8px;">
+        <tr><td style="padding:12px 16px;">
+          <div style="font-size:11px;font-weight:600;color:#9ca3af;letter-spacing:0.04em;text-transform:uppercase;padding-bottom:4px;">${detailsHeader}</div>
+          <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">${detailRows}</table>
+        </td></tr>
+      </table>
+    </td></tr>
+    ${buttonRow}
+    <tr><td style="padding:22px 24px 24px;font-size:14px;line-height:1.6;color:#374151;">
+      Regards,<br>Community Nest
+    </td></tr>
+  </table>
+</div>`;
+  return { subject, text, html };
+}
+function renderHtml(message, nestName2) {
+  const lead = message.match(/^(:[a-z_]+:)\s*/);
+  const meta = lead && EVENT[lead[1]] || { icon: "\u{1F514}", color: "#475569" };
+  const rest = lead ? message.slice(lead[0].length) : message;
+  const body = escapeHtml(rest).replace(/\*([^*]+)\*/g, "<strong>$1</strong>").replace(/\n/g, "<br>");
+  const safeNest = escapeHtml(nestName2);
+  return `<div style="background:#f6f8fa;padding:24px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;">
+  <table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="max-width:480px;margin:0 auto;background:#ffffff;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden;">
+    <tr><td style="padding:20px 24px 16px;border-bottom:1px solid #f0f0f0;">
+      <div style="font-size:15px;font-weight:700;color:#111827;letter-spacing:-0.01em;">ContextNest</div>
+      <div style="font-size:13px;color:#6b7280;margin-top:2px;">${safeNest}</div>
+    </td></tr>
+    <tr><td style="padding:24px;">
+      <table role="presentation" cellpadding="0" cellspacing="0"><tr>
+        <td valign="top" style="font-size:22px;line-height:1;padding-right:14px;">${meta.icon}</td>
+        <td valign="top" style="font-size:15px;line-height:1.55;color:#111827;border-left:3px solid ${meta.color};padding-left:14px;">${body}</td>
+      </tr></table>
+    </td></tr>
+  </table>
+</div>`;
 }
-async function deleteTeam(params) {
-  const row = await loadTeamRow(params.teamId);
-  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < OWNER_RANK) {
-    throw new ForbiddenError("Only the team owner can delete this team.");
+
+// src/notify/email.ts
+var transporterPromise = null;
+var configuredUrl = null;
+var warnedOnce = false;
+var SMTP_TIMEOUT_DEFAULTS = [
+  ["connectionTimeout", 5e3],
+  ["greetingTimeout", 5e3],
+  ["socketTimeout", 1e4]
+];
+function withTimeouts(url) {
+  const query = url.includes("?") ? url.slice(url.indexOf("?") + 1) : "";
+  const missing = SMTP_TIMEOUT_DEFAULTS.filter(
+    ([name]) => !new RegExp(`(^|&)${name}=`, "i").test(query)
+  ).map(([name, ms]) => `${name}=${ms}`);
+  if (missing.length === 0) return url;
+  return url + (url.includes("?") ? "&" : "?") + missing.join("&");
+}
+var POOL_DEFAULTS = [
+  ["pool", "true"],
+  ["maxConnections", "1"],
+  ["rateDelta", "1000"],
+  ["rateLimit", "8"]
+  // messages per second
+];
+function withPool(url) {
+  const query = url.includes("?") ? url.slice(url.indexOf("?") + 1) : "";
+  const missing = POOL_DEFAULTS.filter(
+    ([name]) => !new RegExp(`(^|&)${name}=`, "i").test(query)
+  ).map(([name, val]) => `${name}=${val}`);
+  if (missing.length === 0) return url;
+  return url + (url.includes("?") ? "&" : "?") + missing.join("&");
+}
+async function verifySmtp(url) {
+  let transporter = null;
+  try {
+    const nodemailer = await import("nodemailer");
+    transporter = nodemailer.default.createTransport(withTimeouts(url), {
+      disableFileAccess: true,
+      disableUrlAccess: true
+    });
+    await transporter.verify();
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  } finally {
+    try {
+      transporter?.close?.();
+    } catch {
+    }
   }
-  const db = getDb();
-  await db.transaction(async (tx) => {
-    await tx.run("DELETE FROM teams WHERE id = ?", [params.teamId]);
-    await removeTeamRefs(tx, params.teamId);
-  });
 }
-async function addMember(params) {
-  assertValidRole(params.role);
-  const row = await loadTeamRow(params.teamId);
-  const rank = managementRank(row, params.callerUserId, !!params.allowAdmin);
-  if (rank < ROLE_RANK.editor) {
-    throw new ForbiddenError(
-      "Only an editor or admin member (or the owner) can add people to this team."
+async function getTransporter() {
+  const url = config.SMTP_URL;
+  if (!url) return null;
+  if (!transporterPromise || configuredUrl !== url) {
+    configuredUrl = url;
+    transporterPromise = import("nodemailer").then(
+      (nodemailer) => (
+        // withPool → connection pool + per-second rate limit, so a burst queues
+        // instead of tripping the provider's "too many emails" 550.
+        nodemailer.default.createTransport(withPool(withTimeouts(url)), {
+          // Per-message defaults (belt-and-braces; also set on each sendMail).
+          disableFileAccess: true,
+          disableUrlAccess: true
+        })
+      )
     );
+    transporterPromise.catch(() => {
+      transporterPromise = null;
+      configuredUrl = null;
+    });
   }
-  if (rank < OWNER_RANK && ROLE_RANK[params.role] > rank) {
-    throw new ForbiddenError("You can't give a member a higher role than your own.");
-  }
-  if (!params.userId && params.email && !isEmailish(params.email)) {
-    throw new ValidationError("Enter a valid email address.");
-  }
-  const { userId: resolvedId, email: resolvedEmail } = await resolveMemberIdentity(params);
-  await mutateMembers(params.teamId, (members) => {
-    if (members.some((m) => m.userId === resolvedId)) {
-      throw new ConflictError(
-        `${resolvedEmail || "This user"} is already a member of this team. Change their role instead of adding them again.`
+  return transporterPromise;
+}
+async function notifyEmailForNest(nestId, message, details) {
+  const from = config.NOTIFY_EMAIL_FROM;
+  const to = config.NOTIFY_EMAIL_TO;
+  if (!config.SMTP_URL || !from || !to) return;
+  try {
+    const transporter = await getTransporter();
+    if (!transporter) return;
+    let subject;
+    let text;
+    let html;
+    if (details) {
+      ({ subject, text, html } = renderEmail(details));
+    } else {
+      let name = nestId;
+      try {
+        const row = await getDb().get("SELECT name FROM nests WHERE id = ?", [
+          nestId
+        ]);
+        if (row?.name) name = row.name;
+      } catch {
+      }
+      const safeName = name.replace(/[\r\n]+/g, " ").trim();
+      subject = `ContextNest \xB7 ${safeName}`;
+      text = renderText(message);
+      html = renderHtml(message, safeName);
+    }
+    await transporter.sendMail({
+      from,
+      to,
+      subject,
+      text,
+      html,
+      disableFileAccess: true,
+      disableUrlAccess: true
+    });
+  } catch (err) {
+    if (!warnedOnce) {
+      warnedOnce = true;
+      console.warn(
+        "[email] notification failed (suppressing further warnings):",
+        err instanceof Error ? err.message : err
       );
     }
-    return [
-      ...members,
-      { userId: resolvedId, email: resolvedEmail, role: params.role }
-    ];
-  });
-  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
-}
-async function resolveMemberIdentity(params) {
-  const db = getDb();
-  if (params.userId) {
-    const u = await db.get("SELECT email FROM users WHERE id = ?", [
-      params.userId
-    ]);
-    if (!u) throw new ValidationError("User not found");
-    return { userId: params.userId, email: normalizeEmail(u.email ?? "") };
   }
-  const requested = params.email ? normalizeEmail(params.email) : void 0;
-  if (!requested) {
-    throw new ValidationError("user_id or email is required");
+}
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function recipientEnvelope(to, from) {
+  const recipients = Array.isArray(to) ? to : [to];
+  return recipients.length > 1 ? { to: from, bcc: recipients } : { to: recipients[0] };
+}
+function isRateLimited(err) {
+  const msg = String(err?.message ?? err);
+  const code = Number(err?.responseCode);
+  return /too many|rate limit|throttl|try again|4\.7\.\d|too many emails/i.test(msg) || code === 421 || code === 429 || code === 450 || code === 451 || code === 550 && /too many|rate/i.test(msg);
+}
+async function sendMailWithRetry(transporter, msg, attempts = 5) {
+  for (let i = 0; ; i++) {
+    try {
+      return await transporter.sendMail(msg);
+    } catch (err) {
+      if (i >= attempts - 1 || !isRateLimited(err)) throw err;
+      const wait = 1e3 * 2 ** i;
+      await sleep(wait);
+    }
   }
-  const existing = await db.get(
-    "SELECT id, email FROM users WHERE LOWER(email) = ?",
-    [requested]
-  );
-  if (existing) {
-    return {
-      userId: existing.id,
-      email: normalizeEmail(existing.email ?? requested)
-    };
+}
+async function sendEmailToRecipient(to, details) {
+  const from = config.NOTIFY_EMAIL_FROM;
+  const hasRecipient = Array.isArray(to) ? to.length > 0 : !!to;
+  if (!config.SMTP_URL || !from || !hasRecipient) return;
+  try {
+    const transporter = await getTransporter();
+    if (!transporter) return;
+    const { subject, text, html } = renderEmail(details);
+    await sendMailWithRetry(transporter, {
+      from,
+      ...recipientEnvelope(to, from),
+      subject,
+      text,
+      html,
+      disableFileAccess: true,
+      disableUrlAccess: true
+    });
+  } catch (err) {
+    if (!warnedOnce) {
+      warnedOnce = true;
+      console.warn(
+        "[email] notification failed (suppressing further warnings):",
+        err instanceof Error ? err.message : err
+      );
+    }
   }
-  const { hashPassword } = await import("./keys-73STFJJB.js");
-  const userId = uuid();
-  await db.run(
-    "INSERT INTO users (id, email, name, password_hash, is_invited) VALUES (?, ?, ?, ?, 1)",
-    [userId, requested, null, await hashPassword(uuid())]
-  );
-  return { userId, email: requested };
 }
-async function replaceTeamRoster(params) {
-  for (const m of params.members) assertValidRole(m.role);
-  const row = await loadTeamRow(params.teamId);
-  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
-    throw new ForbiddenError(
-      "Only a team admin or the owner can replace this team's roster."
-    );
+
+// src/nests/service.ts
+import { rmSync as rmSync2, mkdirSync } from "fs";
+import { v4 as uuid2 } from "uuid";
+import { NestStorage as NestStorage3 } from "@promptowl/contextnest-engine";
+
+// src/fs/vault-import.ts
+import { rmSync } from "fs";
+import { writeFile, mkdir } from "fs/promises";
+import { join as join2, dirname, isAbsolute } from "path";
+function isSkippedSegment(segment) {
+  return segment.startsWith(".") || segment === "node_modules" || segment === "_suggestions";
+}
+var ALLOWED_DOT_DIRS = /* @__PURE__ */ new Set([".versions", ".context"]);
+function safeSegments(rel) {
+  if (!rel || isAbsolute(rel)) return null;
+  const segs = rel.split(/[\\/]/).filter(Boolean);
+  if (!segs.length) return null;
+  for (const s of segs) {
+    if (s === "..") return null;
+    if (!ALLOWED_DOT_DIRS.has(s) && isSkippedSegment(s)) return null;
   }
-  await mutateMembers(
-    params.teamId,
-    () => params.members.map((m) => ({
-      userId: m.userId,
-      email: m.email,
-      role: m.role
-    }))
-  );
-  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
+  return segs;
 }
-async function updateMemberRole(params) {
-  assertValidRole(params.role);
-  const row = await loadTeamRow(params.teamId);
-  const rank = managementRank(row, params.callerUserId, !!params.allowAdmin);
-  if (rank < ROLE_RANK.admin) {
-    throw new ForbiddenError("Only a team admin or the owner can change roles.");
+var WRITE_CONCURRENCY = 32;
+async function writeImportedFiles(dest, files) {
+  const targets = [];
+  const skipped = [];
+  for (const f of files) {
+    const segs = safeSegments(f?.path || "");
+    if (!segs) {
+      skipped.push(f?.path || "(empty)");
+      continue;
+    }
+    targets.push({ full: join2(dest, ...segs), content: f.content ?? "" });
   }
-  if (rank < OWNER_RANK && ROLE_RANK[params.role] > rank) {
-    throw new ForbiddenError("You can't set a role higher than your own.");
+  const dirs = new Set(targets.map((t) => dirname(t.full)));
+  await Promise.all([...dirs].map((d) => mkdir(d, { recursive: true })));
+  let written = 0;
+  for (let i = 0; i < targets.length; i += WRITE_CONCURRENCY) {
+    const batch = targets.slice(i, i + WRITE_CONCURRENCY);
+    await Promise.all(
+      batch.map(async (t) => {
+        await writeFile(t.full, t.content, "utf-8");
+        written++;
+      })
+    );
   }
-  await mutateMembers(params.teamId, (members) => {
-    const member = members.find((m) => m.userId === params.userId);
-    if (!member) throw new NotFoundError("Team member not found");
-    member.role = params.role;
-    return members;
-  });
-  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
-}
-async function removeMember(params) {
-  const row = await loadTeamRow(params.teamId);
-  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
-    throw new ForbiddenError("Only a team admin or the owner can remove members.");
+  console.log(
+    `[import] writeImportedFiles: received=${files.length} written=${written} skipped=${skipped.length}`
+  );
+  if (skipped.length) {
+    console.log("[import] skipped (unsafe/hidden path):", skipped.join(", "));
   }
-  await mutateMembers(params.teamId, (members) => {
-    const next = members.filter((m) => m.userId !== params.userId);
-    if (next.length === members.length) {
-      throw new NotFoundError("Team member not found");
-    }
-    return next;
-  });
-  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
-}
-async function mutateMembers(teamId, mutate) {
-  const db = getDb();
-  await db.transaction(async (tx) => {
-    const row = await tx.get("SELECT members FROM teams WHERE id = ?", [
-      teamId
-    ]);
-    if (!row) throw new NotFoundError("Team not found");
-    const next = mutate(parseMembers(row.members));
-    await tx.run("UPDATE teams SET members = ?, updated_at = ? WHERE id = ?", [
-      JSON.stringify(next),
-      (/* @__PURE__ */ new Date()).toISOString(),
-      teamId
-    ]);
-  });
+  return written;
 }
-function parseSharedTeams(json) {
-  if (!json) return [];
+function discardImportDir(dest) {
   try {
-    const parsed = JSON.parse(json);
-    return Array.isArray(parsed) ? parsed : [];
+    rmSync(dest, { recursive: true, force: true });
   } catch {
-    return [];
   }
 }
-async function listNestTeams(nestId) {
-  const db = getDb();
-  const row = await db.get("SELECT shared_teams FROM nests WHERE id = ?", [
-    nestId
-  ]);
-  if (!row) throw new NotFoundError("Nest not found");
-  return parseSharedTeams(row.shared_teams);
+
+// src/shared/paths.ts
+import { join as join3 } from "path";
+function nestStorageRoot() {
+  return config.NEST_STORAGE_ROOT;
 }
-async function shareTeamWithNest(params) {
-  const db = getDb();
-  return db.transaction(async (tx) => {
-    const team = await tx.get(
-      "SELECT id, name, owner_id, members FROM teams WHERE id = ?",
-      [params.teamId]
-    );
-    if (!team) throw new NotFoundError("Team not found");
-    if (managementRank(team, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.editor) {
-      throw new ForbiddenError(
-        "You need to be an editor, admin, or owner of a team to share it. View-only members can't."
-      );
-    }
-    const nest = await tx.get("SELECT shared_teams FROM nests WHERE id = ?", [
-      params.nestId
-    ]);
-    if (!nest) throw new NotFoundError("Nest not found");
-    const refs = parseSharedTeams(nest.shared_teams);
-    if (refs.some((r) => r.teamId === params.teamId)) {
-      throw new ConflictError("This team is already shared with the nest.");
-    }
-    refs.push({ teamId: team.id, teamName: team.name });
-    await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
-      JSON.stringify(refs),
-      params.nestId
-    ]);
-    const hasGovernanceRole = parseMembers(team.members).some(
-      (m) => m.role === "viewer" || m.role === "editor"
-    );
-    if (hasGovernanceRole) {
-      await tx.run("UPDATE nests SET stewardship_enabled = 1 WHERE id = ?", [
-        params.nestId
-      ]);
-    }
-    return refs;
-  });
+function resolveNestPath(nestId) {
+  return join3(nestStorageRoot(), nestId);
 }
-async function unshareTeamFromNest(params) {
-  const db = getDb();
-  return db.transaction(async (tx) => {
-    const nest = await tx.get("SELECT shared_teams FROM nests WHERE id = ?", [
-      params.nestId
-    ]);
-    if (!nest) throw new NotFoundError("Nest not found");
-    const refs = parseSharedTeams(nest.shared_teams);
-    const next = refs.filter((r) => r.teamId !== params.teamId);
-    if (next.length === refs.length) {
-      throw new NotFoundError("Team is not shared with this nest.");
+
+// src/governance/teams-service.ts
+import { v4 as uuid } from "uuid";
+
+// src/nodes/engine.ts
+import {
+  NestStorage as NestStorage2,
+  GraphQueryEngine,
+  VersionManager
+} from "@promptowl/contextnest-engine";
+
+// src/nodes/flat-storage.ts
+import { readdirSync } from "fs";
+import { join as join4, relative, sep } from "path";
+import { NestStorage } from "@promptowl/contextnest-engine";
+var META_FILES = /* @__PURE__ */ new Set([
+  "INDEX.md",
+  "CONTEXT.md",
+  "CLAUDE.md",
+  "GEMINI.md",
+  "AGENTS.md",
+  "QWEN.md"
+]);
+var FlatNestStorage = class extends NestStorage {
+  async discoverDocuments() {
+    const root = this.root;
+    let entries;
+    try {
+      entries = readdirSync(root, { recursive: true, withFileTypes: true });
+    } catch (err) {
+      console.error("[FlatNestStorage] cannot read folder", root, err);
+      return [];
     }
-    await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
-      JSON.stringify(next),
-      params.nestId
-    ]);
-    return next;
-  });
-}
-async function refreshTeamNameRefs(tx, teamId, newName) {
-  const nests = await tx.all(
-    "SELECT id, shared_teams FROM nests WHERE shared_teams LIKE ?",
-    [`%${teamId}%`]
-  );
-  for (const n of nests) {
-    const refs = parseSharedTeams(n.shared_teams);
-    let changed = false;
-    for (const r of refs) {
-      if (r.teamId === teamId && r.teamName !== newName) {
-        r.teamName = newName;
-        changed = true;
-      }
+    const ids = [];
+    for (const e of entries) {
+      if (!e.isFile() || !e.name.endsWith(".md")) continue;
+      if (META_FILES.has(e.name)) continue;
+      const dir = e.parentPath ?? e.path ?? root;
+      const rel = relative(root, join4(dir, e.name)).split(sep).join("/");
+      if (rel.split("/").some(isSkippedSegment)) continue;
+      ids.push(rel.replace(/\.md$/, ""));
     }
-    if (changed) {
-      await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
-        JSON.stringify(refs),
-        n.id
-      ]);
+    const nodes = [];
+    for (const id of ids.sort()) {
+      try {
+        nodes.push(await this.readDocument(id));
+      } catch (err) {
+        console.error("[FlatNestStorage] skipped unreadable doc", id, err);
+      }
     }
+    return nodes;
   }
-}
-async function removeTeamRefs(tx, teamId) {
-  const nests = await tx.all(
-    "SELECT id, shared_teams FROM nests WHERE shared_teams LIKE ?",
-    [`%${teamId}%`]
-  );
-  for (const n of nests) {
-    const refs = parseSharedTeams(n.shared_teams);
-    const next = refs.filter((r) => r.teamId !== teamId);
-    if (next.length !== refs.length) {
-      await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
-        JSON.stringify(next),
-        n.id
-      ]);
+};
+
+// src/nodes/engine.ts
+var NestEngineCache = class {
+  cache = /* @__PURE__ */ new Map();
+  async get(nestId) {
+    let engine = this.cache.get(nestId);
+    if (!engine) {
+      const nestPath = resolveNestPath(nestId);
+      const storage = await isImportedNest(nestId) ? new FlatNestStorage(nestPath) : new NestStorage2(nestPath);
+      const query = new GraphQueryEngine(storage);
+      const versions = new VersionManager(storage);
+      engine = { storage, query, versions };
+      this.cache.set(nestId, engine);
     }
+    return engine;
   }
-}
-async function resolveTeamRolesForUser(nestId, userId) {
-  const refs = await listNestTeams(nestId).catch(() => []);
-  if (refs.length === 0) return [];
-  const db = getDb();
-  const roles = /* @__PURE__ */ new Set();
-  for (const ref of refs) {
-    const row = await db.get("SELECT members FROM teams WHERE id = ?", [
-      ref.teamId
-    ]);
-    if (!row) continue;
-    const member = parseMembers(row.members).find((m) => m.userId === userId);
-    if (member) roles.add(member.role);
+  evict(nestId) {
+    this.cache.delete(nestId);
   }
-  return [...roles];
-}
+};
+var engineCache = new NestEngineCache();
 
-// src/governance/roles.ts
-function collabPermToRole(permission) {
-  switch (permission) {
-    case "owner":
-      return "owner";
-    case "admin":
-      return "admin";
-    case "write":
-      return "editor";
-    case "read":
-      return "viewer";
-    default:
-      return null;
+// src/governance/title-resolver.ts
+async function buildTitleMap(nestId) {
+  try {
+    const { storage } = await engineCache.get(nestId);
+    const docs = await storage.discoverDocuments();
+    return new Map(docs.map((d) => [d.id, d.frontmatter.title]));
+  } catch {
+    return /* @__PURE__ */ new Map();
   }
 }
-function teamRoleToPermission(role) {
-  switch (role) {
-    case "admin":
-      return "admin";
-    case "editor":
-      return "write";
-    case "viewer":
-      return "read";
-    default:
-      return null;
-  }
+function folderForNode(nodeId) {
+  const segments = nodeId.split("/");
+  const root = segments.indexOf("nodes");
+  return segments.slice(root + 1, -1).join("/");
 }
-var includesAny = (roles, wanted) => roles.some((r) => wanted.includes(r));
-var canViewWith = (roles) => roles.length > 0;
-var canEditWith = (roles) => includesAny(roles, ["owner", "admin", "editor"]);
-var PRECEDENCE = [
-  "owner",
-  "admin",
-  "editor",
-  "reviewer",
-  "viewer"
-];
-function primaryRole(roles) {
-  for (const r of PRECEDENCE) if (roles.includes(r)) return r;
-  return null;
+async function describeNode(nestId, nodeId) {
+  const title = await titleForNode(nestId, nodeId);
+  const folder = folderForNode(nodeId);
+  return folder ? `${title} (in ${folder})` : title;
 }
-
-// src/shared/access.ts
-async function isServerAdminUserId(userId) {
-  if (await isLicenseAdminUserId(userId)) return true;
-  const row = await getDb().get(
-    "SELECT email FROM users WHERE id = ?",
-    [userId]
-  );
-  return !!row?.email && isSuperAdmin(row.email);
+async function titleForNode(nestId, nodeId) {
+  const titles = await buildTitleMap(nestId);
+  return titles.get(nodeId) || titleFallback(titles, nodeId);
 }
-var PERMISSION_LEVELS = {
-  none: 0,
-  read: 1,
-  write: 2,
-  admin: 3,
-  owner: 4
-};
-async function resolveNestPermission(nestId, userId) {
-  const db = getDb();
-  const nest = await db.get("SELECT user_id, visibility FROM nests WHERE id = ?", [nestId]);
-  if (!nest) return "none";
-  if (nest.user_id === userId) return "owner";
-  if (nest.user_id === ANON_USER_ID && await isLicenseAdminUserId(userId)) {
-    return "owner";
-  }
-  if (await isLicenseAdminUserId(userId)) return "admin";
-  const caller = await db.get("SELECT email FROM users WHERE id = ?", [userId]);
-  if (caller?.email && isSuperAdmin(caller.email)) {
-    return "admin";
+function titleFallback(titles, nodeId) {
+  const at = nodeId.indexOf("nodes/");
+  if (at > 0) {
+    const normalized = nodeId.slice(at);
+    const hit = titles.get(normalized);
+    if (hit) return hit;
   }
-  const higher = (a, b) => b && PERMISSION_LEVELS[b] > PERMISSION_LEVELS[a] ? b : a;
-  let best = "none";
-  const directGrant = await db.get(
-    "SELECT permission FROM nest_collaborators WHERE nest_id = ? AND user_id = ?",
-    [nestId, userId]
-  );
-  if (directGrant) best = higher(best, directGrant.permission);
-  if (best === "admin") return best;
-  for (const role of await resolveTeamRolesForUser(nestId, userId)) {
-    best = higher(best, teamRoleToPermission(role));
+  return nodeId.split("/").pop() || nodeId;
+}
+function prettyFolderPath(path) {
+  return path.replace(/^nodes\//, "").split("/").filter(Boolean).map(
+    (seg) => seg.split(/[-_]/).map((s) => s ? s[0].toUpperCase() + s.slice(1) : s).join(" ")
+  ).join(" / ");
+}
+async function nestName(nestId) {
+  try {
+    const row = await getDb().get("SELECT name FROM nests WHERE id = ?", [
+      nestId
+    ]);
+    return row?.name || nestId;
+  } catch {
+    return nestId;
   }
-  if (best === "admin") return best;
-  const stewardGrant = await db.get(
-    `SELECT 1 FROM stewards s
-         JOIN users u ON u.id = ?
-        WHERE s.nest_id = ? AND s.is_active = 1
-          AND LOWER(s.user_email) = LOWER(u.email)
-        LIMIT 1`,
-    [userId, nestId]
-  );
-  if (stewardGrant) best = higher(best, "read");
-  if (nest.visibility === "public") best = higher(best, "read");
-  return best;
 }
-function permissionLevel(p) {
-  return PERMISSION_LEVELS[p] ?? 0;
+function docLink(nestId, nodeId, baseUrl) {
+  const base = baseUrl || config.PUBLIC_BASE_URL;
+  if (!base) return "";
+  const q = new URLSearchParams({ nest: nestId });
+  if (nodeId) q.set("doc", nodeId);
+  return `${base.replace(/\/$/, "")}/?${q.toString()}`;
 }
-async function isPublicReader(nestId, userId) {
-  const db = getDb();
-  const nest = await db.get("SELECT user_id, visibility FROM nests WHERE id = ?", [nestId]);
-  if (!nest) return false;
-  if (nest.visibility !== "public") return false;
-  if (nest.user_id === userId) return false;
-  const directGrant = await db.get(
-    "SELECT 1 FROM nest_collaborators WHERE nest_id = ? AND user_id = ?",
-    [nestId, userId]
-  );
-  if (directGrant) return false;
-  if (await isLicenseAdminUserId(userId)) return false;
-  const caller = await db.get("SELECT email FROM users WHERE id = ?", [userId]);
-  if (caller?.email && isSuperAdmin(caller.email)) return false;
-  const stewardGrant = await db.get(
-    `SELECT 1 FROM stewards s
-         JOIN users u ON u.id = ?
-        WHERE s.nest_id = ? AND s.is_active = 1
-          AND LOWER(s.user_email) = LOWER(u.email)
-        LIMIT 1`,
-    [userId, nestId]
-  );
-  if (stewardGrant) return false;
-  if ((await resolveTeamRolesForUser(nestId, userId)).length > 0) return false;
-  return true;
+async function buildDocContext(nestId, nodeId, baseUrl) {
+  const titles = await buildTitleMap(nestId);
+  const docTitle = titles.get(nodeId) || nodeId;
+  const folder = folderForNode(nodeId);
+  const name = await nestName(nestId);
+  return {
+    docTitle,
+    // Slack one-liner label ("Title (in Folder)"), same as describeNode().
+    label: folder ? `${docTitle} (in ${folder})` : docTitle,
+    path: folder ? `${name} / ${folder}` : name,
+    link: docLink(nestId, nodeId, baseUrl)
+  };
 }
-
-// src/nests/service.ts
-async function isImportedNest(nestId) {
-  const row = await getDb().get(
-    "SELECT is_imported FROM nests WHERE id = ?",
-    [nestId]
-  );
-  return !!row?.is_imported;
+
+// src/governance/teams-service.ts
+var VALID_TEAM_ROLES = ["admin", "editor", "viewer"];
+function parseMembers(json) {
+  if (!json) return [];
+  try {
+    const parsed = JSON.parse(json);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
 }
-function toSlug(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+function rowToTeam(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    owner_id: row.owner_id,
+    members: parseMembers(row.members),
+    source: row.source ?? null,
+    external_id: row.external_id ?? null,
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
 }
-async function uniqueNestName(userId, baseName) {
+async function enrichTeam(team) {
   const db = getDb();
-  let candidate = baseName;
-  let n = 0;
-  while (n < 1e3) {
-    const slug = toSlug(candidate);
-    const hit = await db.get(
-      "SELECT 1 FROM nests WHERE user_id = ? AND slug = ? LIMIT 1",
-      [userId, slug]
+  const ids = team.members.map((m) => m.userId);
+  const invited = /* @__PURE__ */ new Map();
+  if (ids.length) {
+    const rows = await db.all(
+      `SELECT id, is_invited FROM users WHERE id IN (${ids.map(() => "?").join(",")})`,
+      ids
     );
-    if (!hit) return candidate;
-    n++;
-    candidate = `${baseName} (${n})`;
+    for (const r of rows) invited.set(r.id, r.is_invited);
   }
-  return candidate;
+  const owner = await db.get("SELECT email FROM users WHERE id = ?", [
+    team.owner_id
+  ]);
+  return {
+    ...team,
+    owner_email: owner?.email,
+    // Unknown id (deleted user) → treat as not registered.
+    members: team.members.map((m) => ({
+      ...m,
+      registered: (invited.get(m.userId) ?? 1) === 0
+    }))
+  };
 }
-async function isStewardshipEnabled(nestId) {
-  const db = getDb();
-  const row = await db.get(
-    "SELECT stewardship_enabled FROM nests WHERE id = ?",
-    [nestId]
-  );
-  return !!row?.stewardship_enabled;
+function assertValidRole(role) {
+  if (!VALID_TEAM_ROLES.includes(role)) {
+    throw new ValidationError(
+      "role must be admin, editor, or viewer"
+    );
+  }
 }
-async function setStewardshipEnabled(nestId, enabled) {
+async function loadTeamRow(teamId) {
   const db = getDb();
-  await db.run("UPDATE nests SET stewardship_enabled = ? WHERE id = ?", [
-    enabled ? 1 : 0,
-    nestId
+  const row = await db.get("SELECT * FROM teams WHERE id = ?", [
+    teamId
   ]);
+  if (!row) throw new NotFoundError("Team not found");
+  return row;
 }
-async function nestAllowsSelfApprove(nestId) {
+var ROLE_RANK = {
+  viewer: 1,
+  editor: 2,
+  admin: 3
+};
+var OWNER_RANK = 4;
+function managementRank(row, callerUserId, allowAdmin) {
+  if (row.owner_id === callerUserId || allowAdmin) return OWNER_RANK;
+  const m = parseMembers(row.members).find((x) => x.userId === callerUserId);
+  return m ? ROLE_RANK[m.role] ?? 0 : 0;
+}
+async function createTeam(params) {
+  const name = params.name?.trim();
+  if (!name) throw new ValidationError("Team name is required");
+  const db = getDb();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const id = uuid();
+  await db.run(
+    "INSERT INTO teams (id, name, owner_id, members, source, external_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+    [
+      id,
+      name,
+      params.ownerId,
+      "[]",
+      params.source ?? null,
+      params.externalId ?? null,
+      now,
+      now
+    ]
+  );
+  return enrichTeam(rowToTeam(await loadTeamRow(id)));
+}
+async function findTeamByExternalId(params) {
   const db = getDb();
   const row = await db.get(
-    "SELECT allow_self_approve FROM nests WHERE id = ?",
-    [nestId]
+    "SELECT * FROM teams WHERE owner_id = ? AND source = ? AND external_id = ?",
+    [params.ownerId, params.source, params.externalId]
   );
-  return !!row?.allow_self_approve;
+  return row ? enrichTeam(rowToTeam(row)) : null;
 }
-async function setAllowSelfApprove(nestId, allow) {
+async function listTeamsForUser(userId) {
   const db = getDb();
-  await db.run("UPDATE nests SET allow_self_approve = ? WHERE id = ?", [
-    allow ? 1 : 0,
-    nestId
-  ]);
+  const rows = await db.all(
+    "SELECT * FROM teams WHERE owner_id = ? OR members LIKE ? ORDER BY created_at",
+    [userId, `%${userId}%`]
+  );
+  const mine = rows.filter(
+    (r) => r.owner_id === userId || parseMembers(r.members).some((m) => m.userId === userId)
+  );
+  return Promise.all(mine.map((r) => enrichTeam(rowToTeam(r))));
 }
-async function disableStewardshipAndWipeGovernance(nestId) {
+async function getTeam(teamId) {
+  return enrichTeam(rowToTeam(await loadTeamRow(teamId)));
+}
+async function renameTeam(params) {
+  const name = params.name?.trim();
+  if (!name) throw new ValidationError("Team name is required");
+  const row = await loadTeamRow(params.teamId);
+  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
+    throw new ForbiddenError("Only a team admin or the owner can rename this team.");
+  }
   const db = getDb();
-  return db.transaction(async (tx) => {
-    const id = nestId;
-    const stewards = (await tx.run("DELETE FROM stewards WHERE nest_id = ?", [id])).changes;
-    const pendingReviews = (await tx.run(
-      "DELETE FROM review_requests WHERE nest_id = ? AND status = 'pending'",
-      [id]
-    )).changes;
-    await tx.run("UPDATE nests SET stewardship_enabled = 0 WHERE id = ?", [id]);
-    return { stewards, pendingReviews };
+  await db.transaction(async (tx) => {
+    await tx.run("UPDATE teams SET name = ?, updated_at = ? WHERE id = ?", [
+      name,
+      (/* @__PURE__ */ new Date()).toISOString(),
+      params.teamId
+    ]);
+    await refreshTeamNameRefs(tx, params.teamId, name);
   });
+  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
 }
-async function renameNest(nestId, patch) {
-  const db = getDb();
-  const existing = await db.get("SELECT * FROM nests WHERE id = ?", [
-    nestId
-  ]);
-  if (!existing) {
-    throw new ValidationError("Nest not found");
-  }
-  const updates = [];
-  const params = [];
-  if (patch.name !== void 0) {
-    const trimmed = patch.name.trim();
-    if (!trimmed) throw new ValidationError("Name cannot be empty");
-    const slug = toSlug(trimmed);
-    if (!slug) throw new ValidationError("Name must contain at least one alphanumeric character");
-    const conflict = await db.get(
-      "SELECT id FROM nests WHERE user_id = ? AND slug = ? AND id != ? LIMIT 1",
-      [existing.user_id, slug, nestId]
-    );
-    if (conflict) {
-      throw new ValidationError(
-        `Another nest already uses this name. Pick a different one.`
-      );
-    }
-    updates.push("name = ?", "slug = ?");
-    params.push(trimmed, slug);
-  }
-  if (patch.description !== void 0) {
-    updates.push("description = ?");
-    params.push(patch.description || null);
-  }
-  if (updates.length === 0) {
-    return existing;
+async function deleteTeam(params) {
+  const row = await loadTeamRow(params.teamId);
+  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < OWNER_RANK) {
+    throw new ForbiddenError("Only the team owner can delete this team.");
   }
-  params.push(nestId);
-  await db.run(
-    `UPDATE nests SET ${updates.join(", ")} WHERE id = ?`,
-    params
-  );
-  return await db.get("SELECT * FROM nests WHERE id = ?", [nestId]);
-}
-async function createNest(userId, name, description) {
-  const id = uuid2();
   const db = getDb();
-  const trimmed = name.trim();
-  if (!trimmed) throw new ValidationError("Name cannot be empty");
-  const slug = toSlug(trimmed);
-  if (!slug) {
-    throw new ValidationError(
-      "Name must contain at least one alphanumeric character"
+  await db.transaction(async (tx) => {
+    await tx.run("DELETE FROM teams WHERE id = ?", [params.teamId]);
+    await removeTeamRefs(tx, params.teamId);
+  });
+}
+async function addMember(params) {
+  assertValidRole(params.role);
+  const row = await loadTeamRow(params.teamId);
+  const rank = managementRank(row, params.callerUserId, !!params.allowAdmin);
+  if (rank < ROLE_RANK.editor) {
+    throw new ForbiddenError(
+      "Only an editor or admin member (or the owner) can add people to this team."
     );
   }
-  const conflict = await db.get(
-    "SELECT id FROM nests WHERE user_id = ? AND slug = ? LIMIT 1",
-    [userId, slug]
-  );
-  if (conflict) {
-    throw new ValidationError(
-      "You already have a nest with this name. Pick a different one."
-    );
+  if (rank < OWNER_RANK && ROLE_RANK[params.role] > rank) {
+    throw new ForbiddenError("You can't give a member a higher role than your own.");
   }
-  const visibility = userId === ANON_USER_ID ? "public" : "private";
-  await db.run(
-    "INSERT INTO nests (id, user_id, name, slug, description, visibility) VALUES (?, ?, ?, ?, ?, ?)",
-    [id, userId, trimmed, slug, description || null, visibility]
-  );
-  const path = resolveNestPath(id);
-  mkdirSync(path, { recursive: true });
-  const storage = new NestStorage(path);
-  await storage.init(trimmed);
-  trackEvent("nest.create", { nestId: id, userId });
-  return await db.get("SELECT * FROM nests WHERE id = ?", [id]);
+  if (!params.userId && params.email && !isEmailish(params.email)) {
+    throw new ValidationError("Enter a valid email address.");
+  }
+  const { userId: resolvedId, email: resolvedEmail } = await resolveMemberIdentity(params);
+  await mutateMembers(params.teamId, (members) => {
+    if (members.some((m) => m.userId === resolvedId)) {
+      throw new ConflictError(
+        `${resolvedEmail || "This user"} is already a member of this team. Change their role instead of adding them again.`
+      );
+    }
+    return [
+      ...members,
+      { userId: resolvedId, email: resolvedEmail, role: params.role }
+    ];
+  });
+  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
 }
-async function importNest(userId, name, files) {
-  const nm = (name || "").trim();
-  if (!nm) {
-    throw new ValidationError("name is required");
+async function resolveMemberIdentity(params) {
+  const db = getDb();
+  if (params.userId) {
+    const u = await db.get("SELECT email FROM users WHERE id = ?", [
+      params.userId
+    ]);
+    if (!u) throw new ValidationError("User not found");
+    return { userId: params.userId, email: normalizeEmail(u.email ?? "") };
   }
-  if (!Array.isArray(files)) {
-    throw new ValidationError("files are required");
+  const requested = params.email ? normalizeEmail(params.email) : void 0;
+  if (!requested) {
+    throw new ValidationError("user_id or email is required");
   }
-  const db = getDb();
-  const id = uuid2();
-  const slug = toSlug(nm);
-  const visibility = userId === ANON_USER_ID ? "public" : "private";
-  const dest = resolveNestPath(id);
-  mkdirSync(dest, { recursive: true });
-  try {
-    await writeImportedFiles(dest, files);
-  } catch (err) {
-    console.error("[nests] import write failed", dest, err);
-    discardImportDir(dest);
-    throw new ValidationError("Failed to import folder");
+  const existing = await db.get(
+    "SELECT id, email FROM users WHERE LOWER(email) = ?",
+    [requested]
+  );
+  if (existing) {
+    return {
+      userId: existing.id,
+      email: normalizeEmail(existing.email ?? requested)
+    };
   }
+  const { hashPassword } = await import("./keys-73STFJJB.js");
+  const userId = uuid();
   await db.run(
-    "INSERT INTO nests (id, user_id, name, slug, description, visibility, is_imported) VALUES (?, ?, ?, ?, ?, ?, 1)",
-    [id, userId, nm, slug, null, visibility]
+    "INSERT INTO users (id, email, name, password_hash, is_invited) VALUES (?, ?, ?, ?, 1)",
+    [userId, requested, null, await hashPassword(uuid())]
   );
-  trackEvent("nest.import", { nestId: id, userId });
-  return await db.get("SELECT * FROM nests WHERE id = ?", [id]);
+  return { userId, email: requested };
 }
-async function listNests(userId) {
-  const db = getDb();
-  if (userId === ANON_USER_ID) {
-    return await db.all(
-      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
-      [ANON_USER_ID]
-    );
-  }
-  const includeAnon = config.AUTH_MODE === "open" || await isLicenseAdminUserId(userId);
-  if (!includeAnon) {
-    return await db.all(
-      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
-      [userId]
+async function replaceTeamRoster(params) {
+  for (const m of params.members) assertValidRole(m.role);
+  const row = await loadTeamRow(params.teamId);
+  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
+    throw new ForbiddenError(
+      "Only a team admin or the owner can replace this team's roster."
     );
   }
-  return await db.all(
-    "SELECT * FROM nests WHERE user_id = ? OR user_id = ? ORDER BY created_at DESC",
-    [userId, ANON_USER_ID]
+  await mutateMembers(
+    params.teamId,
+    () => params.members.map((m) => ({
+      userId: m.userId,
+      email: m.email,
+      role: m.role
+    }))
   );
+  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
 }
-async function nestsSharedViaTeams(userId) {
-  const db = getDb();
-  const teams = await db.all(
-    "SELECT id, members FROM teams WHERE members LIKE ?",
-    [`%${userId}%`]
-  );
-  const myTeamIds = /* @__PURE__ */ new Set();
-  for (const t of teams) {
-    try {
-      const members = JSON.parse(t.members || "[]");
-      if (Array.isArray(members) && members.some((m) => m?.userId === userId)) {
-        myTeamIds.add(t.id);
-      }
-    } catch {
-    }
+async function updateMemberRole(params) {
+  assertValidRole(params.role);
+  const row = await loadTeamRow(params.teamId);
+  const rank = managementRank(row, params.callerUserId, !!params.allowAdmin);
+  if (rank < ROLE_RANK.admin) {
+    throw new ForbiddenError("Only a team admin or the owner can change roles.");
   }
-  if (myTeamIds.size === 0) return [];
-  const ids = [...myTeamIds];
-  const candidates = await db.all(
-    `SELECT * FROM nests
-       WHERE user_id != ?
-         AND (${ids.map(() => "shared_teams LIKE ?").join(" OR ")})`,
-    [userId, ...ids.map((id) => `%${id}%`)]
-  );
-  return candidates.filter((n) => {
-    try {
-      const refs = JSON.parse(n.shared_teams || "[]");
-      return Array.isArray(refs) && refs.some((r) => myTeamIds.has(r?.teamId));
-    } catch {
-      return false;
-    }
+  if (rank < OWNER_RANK && ROLE_RANK[params.role] > rank) {
+    throw new ForbiddenError("You can't set a role higher than your own.");
+  }
+  await mutateMembers(params.teamId, (members) => {
+    const member = members.find((m) => m.userId === params.userId);
+    if (!member) throw new NotFoundError("Team member not found");
+    member.role = params.role;
+    return members;
   });
+  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
 }
-async function listSharedNests(userId) {
-  const db = getDb();
-  const direct = await db.all(
-    `SELECT DISTINCT n.* FROM nests n
-       LEFT JOIN nest_collaborators nc
-         ON nc.nest_id = n.id AND nc.user_id = ?
-       LEFT JOIN users u ON u.id = ?
-       LEFT JOIN stewards s
-         ON s.nest_id = n.id AND s.is_active = 1
-        AND LOWER(s.user_email) = LOWER(u.email)
-       WHERE n.user_id != ?
-         AND (nc.user_id IS NOT NULL OR s.id IS NOT NULL)
-       ORDER BY n.created_at DESC`,
-    [userId, userId, userId]
-  );
-  const seen = new Set(direct.map((n) => n.id));
-  for (const n of await nestsSharedViaTeams(userId)) {
-    if (!seen.has(n.id)) {
-      direct.push(n);
-      seen.add(n.id);
-    }
+async function removeMember(params) {
+  const row = await loadTeamRow(params.teamId);
+  if (managementRank(row, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.admin) {
+    throw new ForbiddenError("Only a team admin or the owner can remove members.");
   }
-  if (await isServerAdminUserId(userId)) {
-    const anon = await db.all(
-      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
-      [ANON_USER_ID]
-    );
-    for (const n of anon) {
-      if (!seen.has(n.id)) {
-        direct.push(n);
-        seen.add(n.id);
-      }
+  await mutateMembers(params.teamId, (members) => {
+    const next = members.filter((m) => m.userId !== params.userId);
+    if (next.length === members.length) {
+      throw new NotFoundError("Team member not found");
     }
-  }
-  direct.sort(
-    (a, b) => a.created_at === b.created_at ? 0 : a.created_at < b.created_at ? 1 : -1
-  );
-  return direct;
+    return next;
+  });
+  return enrichTeam(rowToTeam(await loadTeamRow(params.teamId)));
 }
-async function listVisibleNests(userId) {
+async function mutateMembers(teamId, mutate) {
   const db = getDb();
-  const includeAnon = config.AUTH_MODE === "open" || await isServerAdminUserId(userId);
-  const params = includeAnon ? [userId, userId, userId, ANON_USER_ID] : [userId, userId, userId];
-  const rows = await db.all(
-    `SELECT DISTINCT n.* FROM nests n
-       LEFT JOIN nest_collaborators nc
-         ON nc.nest_id = n.id AND nc.user_id = ?
-       LEFT JOIN users u ON u.id = ?
-       LEFT JOIN stewards s
-         ON s.nest_id = n.id AND s.is_active = 1
-        AND LOWER(s.user_email) = LOWER(u.email)
-      WHERE n.user_id = ?
-         OR nc.user_id IS NOT NULL
-         OR s.id IS NOT NULL
-         ${includeAnon ? "OR n.user_id = ?" : ""}
-      ORDER BY n.created_at DESC`,
-    params
-  );
-  const seen = new Set(rows.map((n) => n.id));
-  for (const n of await nestsSharedViaTeams(userId)) {
-    if (!seen.has(n.id)) {
-      rows.push(n);
-      seen.add(n.id);
-    }
-  }
-  return rows;
+  await db.transaction(async (tx) => {
+    const row = await tx.get("SELECT members FROM teams WHERE id = ?", [
+      teamId
+    ]);
+    if (!row) throw new NotFoundError("Team not found");
+    const next = mutate(parseMembers(row.members));
+    await tx.run("UPDATE teams SET members = ?, updated_at = ? WHERE id = ?", [
+      JSON.stringify(next),
+      (/* @__PURE__ */ new Date()).toISOString(),
+      teamId
+    ]);
+  });
 }
-async function listPublicNests(userId) {
-  const db = getDb();
-  return await db.all(
-    `SELECT n.* FROM nests n
-       WHERE n.visibility = 'public'
-         AND n.user_id != ?
-         AND NOT EXISTS (
-           SELECT 1 FROM nest_collaborators nc
-           WHERE nc.nest_id = n.id AND nc.user_id = ?
-         )
-       ORDER BY n.created_at DESC`,
-    [userId, userId]
-  );
+function parseSharedTeams(json) {
+  if (!json) return [];
+  try {
+    const parsed = JSON.parse(json);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
 }
-async function getNest(nestId) {
+async function listNestTeams(nestId) {
   const db = getDb();
-  return await db.get("SELECT * FROM nests WHERE id = ?", [nestId]) || null;
+  const row = await db.get("SELECT shared_teams FROM nests WHERE id = ?", [
+    nestId
+  ]);
+  if (!row) throw new NotFoundError("Nest not found");
+  return parseSharedTeams(row.shared_teams);
 }
-async function deleteNest(nestId) {
+async function shareTeamWithNest(params) {
   const db = getDb();
-  await db.transaction(async (tx) => {
-    const id = nestId;
-    await tx.run("DELETE FROM approved_versions WHERE nest_id = ?", [id]);
-    await tx.run("DELETE FROM node_versions WHERE nest_id = ?", [id]);
-    await tx.run("DELETE FROM review_requests WHERE nest_id = ?", [id]);
-    await tx.run("DELETE FROM stewards WHERE nest_id = ?", [id]);
-    await tx.run("DELETE FROM nest_collaborators WHERE nest_id = ?", [id]);
-    try {
-      await tx.run("DELETE FROM node_tag_index WHERE nest_id = ?", [id]);
-    } catch {
+  let sharedMembers = [];
+  const refs = await db.transaction(async (tx) => {
+    const team = await tx.get(
+      "SELECT id, name, owner_id, members FROM teams WHERE id = ?",
+      [params.teamId]
+    );
+    if (!team) throw new NotFoundError("Team not found");
+    if (managementRank(team, params.callerUserId, !!params.allowAdmin) < ROLE_RANK.editor) {
+      throw new ForbiddenError(
+        "You need to be an editor, admin, or owner of a team to share it. View-only members can't."
+      );
     }
-    await tx.run("DELETE FROM api_keys WHERE nest_id = ?", [id]);
-    await tx.run("DELETE FROM nests WHERE id = ?", [id]);
+    const nest = await tx.get("SELECT shared_teams FROM nests WHERE id = ?", [
+      params.nestId
+    ]);
+    if (!nest) throw new NotFoundError("Nest not found");
+    const refs2 = parseSharedTeams(nest.shared_teams);
+    if (refs2.some((r) => r.teamId === params.teamId)) {
+      throw new ConflictError("This team is already shared with the nest.");
+    }
+    refs2.push({ teamId: team.id, teamName: team.name });
+    await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
+      JSON.stringify(refs2),
+      params.nestId
+    ]);
+    const members = parseMembers(team.members);
+    sharedMembers = members;
+    const hasGovernanceRole = members.some(
+      (m) => m.role === "viewer" || m.role === "editor"
+    );
+    if (hasGovernanceRole) {
+      await tx.run("UPDATE nests SET stewardship_enabled = 1 WHERE id = ?", [
+        params.nestId
+      ]);
+    }
+    return refs2;
   });
-  const path = resolveNestPath(nestId);
   try {
-    rmSync2(path, { recursive: true, force: true });
+    const caller = await db.get("SELECT email FROM users WHERE id = ?", [
+      params.callerUserId
+    ]);
+    const callerEmail = caller?.email?.toLowerCase();
+    const shareNestName = await nestName(params.nestId);
+    const link = docLink(params.nestId, void 0, params.baseUrl);
+    const byRole = /* @__PURE__ */ new Map();
+    for (const m of sharedMembers) {
+      if (!m.email || m.email.toLowerCase() === callerEmail) continue;
+      const arr = byRole.get(m.role) ?? [];
+      arr.push(m.email);
+      byRole.set(m.role, arr);
+    }
+    for (const [role, emails] of byRole) {
+      if (emails.length === 0) continue;
+      void sendEmailToRecipient(emails, {
+        status: "shared",
+        docTitle: shareNestName,
+        path: shareNestName,
+        link,
+        permission: role,
+        by: caller?.email || void 0
+      });
+    }
   } catch (err) {
-    console.warn(`[nests] failed to remove nest directory ${path}:`, err);
+    console.error("[notify] team-share email fan-out failed", params.nestId, err);
   }
-  trackEvent("nest.delete", { nestId });
+  return refs;
 }
-
-// src/nodes/flat-storage.ts
-import { readdirSync } from "fs";
-import { join as join4, relative, sep } from "path";
-import { NestStorage as NestStorage2 } from "@promptowl/contextnest-engine";
-var META_FILES = /* @__PURE__ */ new Set([
-  "INDEX.md",
-  "CONTEXT.md",
-  "CLAUDE.md",
-  "GEMINI.md",
-  "AGENTS.md",
-  "QWEN.md"
-]);
-var FlatNestStorage = class extends NestStorage2 {
-  async discoverDocuments() {
-    const root = this.root;
-    let entries;
-    try {
-      entries = readdirSync(root, { recursive: true, withFileTypes: true });
-    } catch (err) {
-      console.error("[FlatNestStorage] cannot read folder", root, err);
-      return [];
-    }
-    const ids = [];
-    for (const e of entries) {
-      if (!e.isFile() || !e.name.endsWith(".md")) continue;
-      if (META_FILES.has(e.name)) continue;
-      const dir = e.parentPath ?? e.path ?? root;
-      const rel = relative(root, join4(dir, e.name)).split(sep).join("/");
-      if (rel.split("/").some(isSkippedSegment)) continue;
-      ids.push(rel.replace(/\.md$/, ""));
+async function unshareTeamFromNest(params) {
+  const db = getDb();
+  return db.transaction(async (tx) => {
+    const nest = await tx.get("SELECT shared_teams FROM nests WHERE id = ?", [
+      params.nestId
+    ]);
+    if (!nest) throw new NotFoundError("Nest not found");
+    const refs = parseSharedTeams(nest.shared_teams);
+    const next = refs.filter((r) => r.teamId !== params.teamId);
+    if (next.length === refs.length) {
+      throw new NotFoundError("Team is not shared with this nest.");
     }
-    const nodes = [];
-    for (const id of ids.sort()) {
-      try {
-        nodes.push(await this.readDocument(id));
-      } catch (err) {
-        console.error("[FlatNestStorage] skipped unreadable doc", id, err);
+    await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
+      JSON.stringify(next),
+      params.nestId
+    ]);
+    return next;
+  });
+}
+async function refreshTeamNameRefs(tx, teamId, newName) {
+  const nests = await tx.all(
+    "SELECT id, shared_teams FROM nests WHERE shared_teams LIKE ?",
+    [`%${teamId}%`]
+  );
+  for (const n of nests) {
+    const refs = parseSharedTeams(n.shared_teams);
+    let changed = false;
+    for (const r of refs) {
+      if (r.teamId === teamId && r.teamName !== newName) {
+        r.teamName = newName;
+        changed = true;
       }
     }
-    return nodes;
+    if (changed) {
+      await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
+        JSON.stringify(refs),
+        n.id
+      ]);
+    }
   }
-};
-
-// src/nodes/engine.ts
-var NestEngineCache = class {
-  cache = /* @__PURE__ */ new Map();
-  async get(nestId) {
-    let engine = this.cache.get(nestId);
-    if (!engine) {
-      const nestPath = resolveNestPath(nestId);
-      const storage = await isImportedNest(nestId) ? new FlatNestStorage(nestPath) : new NestStorage3(nestPath);
-      const query = new GraphQueryEngine(storage);
-      const versions = new VersionManager(storage);
-      engine = { storage, query, versions };
-      this.cache.set(nestId, engine);
+}
+async function removeTeamRefs(tx, teamId) {
+  const nests = await tx.all(
+    "SELECT id, shared_teams FROM nests WHERE shared_teams LIKE ?",
+    [`%${teamId}%`]
+  );
+  for (const n of nests) {
+    const refs = parseSharedTeams(n.shared_teams);
+    const next = refs.filter((r) => r.teamId !== teamId);
+    if (next.length !== refs.length) {
+      await tx.run("UPDATE nests SET shared_teams = ? WHERE id = ?", [
+        JSON.stringify(next),
+        n.id
+      ]);
     }
-    return engine;
   }
-  evict(nestId) {
-    this.cache.delete(nestId);
+}
+async function resolveTeamRolesForUser(nestId, userId) {
+  const refs = await listNestTeams(nestId).catch(() => []);
+  if (refs.length === 0) return [];
+  const db = getDb();
+  const roles = /* @__PURE__ */ new Set();
+  for (const ref of refs) {
+    const row = await db.get("SELECT members FROM teams WHERE id = ?", [
+      ref.teamId
+    ]);
+    if (!row) continue;
+    const member = parseMembers(row.members).find((m) => m.userId === userId);
+    if (member) roles.add(member.role);
   }
-};
-var engineCache = new NestEngineCache();
+  return [...roles];
+}
 
-// src/governance/title-resolver.ts
-async function buildTitleMap(nestId) {
-  try {
-    const { storage } = await engineCache.get(nestId);
-    const docs = await storage.discoverDocuments();
-    return new Map(docs.map((d) => [d.id, d.frontmatter.title]));
-  } catch {
-    return /* @__PURE__ */ new Map();
+// src/governance/roles.ts
+function collabPermToRole(permission) {
+  switch (permission) {
+    case "owner":
+      return "owner";
+    case "admin":
+      return "admin";
+    case "write":
+      return "editor";
+    case "read":
+      return "viewer";
+    default:
+      return null;
   }
 }
-function folderForNode(nodeId) {
-  return nodeId.replace(/^nodes\//, "").split("/").slice(0, -1).join("/");
+function teamRoleToPermission(role) {
+  switch (role) {
+    case "admin":
+      return "admin";
+    case "editor":
+      return "write";
+    case "viewer":
+      return "read";
+    default:
+      return null;
+  }
 }
-async function describeNode(nestId, nodeId) {
-  const titles = await buildTitleMap(nestId);
-  const title = titles.get(nodeId) || nodeId;
-  const folder = folderForNode(nodeId);
-  return folder ? `${title} (in ${folder})` : title;
+var includesAny = (roles, wanted) => roles.some((r) => wanted.includes(r));
+var canViewWith = (roles) => roles.length > 0;
+var canEditWith = (roles) => includesAny(roles, ["owner", "admin", "editor"]);
+var canApproveWith = (roles) => includesAny(roles, ["owner", "admin", "reviewer"]);
+var PRECEDENCE = [
+  "owner",
+  "admin",
+  "editor",
+  "reviewer",
+  "viewer"
+];
+function primaryRole(roles) {
+  for (const r of PRECEDENCE) if (roles.includes(r)) return r;
+  return null;
 }
-async function nestName(nestId) {
-  try {
-    const row = await getDb().get("SELECT name FROM nests WHERE id = ?", [
-      nestId
-    ]);
-    return row?.name || nestId;
-  } catch {
-    return nestId;
-  }
+
+// src/shared/access.ts
+async function isServerAdminUserId(userId) {
+  if (await isLicenseAdminUserId(userId)) return true;
+  const row = await getDb().get(
+    "SELECT email FROM users WHERE id = ?",
+    [userId]
+  );
+  return !!row?.email && isSuperAdmin(row.email);
 }
-function docLink(nestId, nodeId, baseUrl) {
-  const base = baseUrl || config.PUBLIC_BASE_URL;
-  if (!base) return "";
-  const q = new URLSearchParams({ nest: nestId });
-  if (nodeId) q.set("doc", nodeId);
-  return `${base.replace(/\/$/, "")}/?${q.toString()}`;
+var PERMISSION_LEVELS = {
+  none: 0,
+  read: 1,
+  write: 2,
+  admin: 3,
+  owner: 4
+};
+async function resolveNestPermission(nestId, userId) {
+  const db = getDb();
+  const nest = await db.get("SELECT user_id, visibility FROM nests WHERE id = ?", [nestId]);
+  if (!nest) return "none";
+  if (nest.user_id === userId) return "owner";
+  if (nest.user_id === ANON_USER_ID && await isLicenseAdminUserId(userId)) {
+    return "owner";
+  }
+  if (await isLicenseAdminUserId(userId)) return "admin";
+  const caller = await db.get("SELECT email FROM users WHERE id = ?", [userId]);
+  if (caller?.email && isSuperAdmin(caller.email)) {
+    return "admin";
+  }
+  const higher = (a, b) => b && PERMISSION_LEVELS[b] > PERMISSION_LEVELS[a] ? b : a;
+  let best = "none";
+  const directGrant = await db.get(
+    "SELECT permission FROM nest_collaborators WHERE nest_id = ? AND user_id = ?",
+    [nestId, userId]
+  );
+  if (directGrant) best = higher(best, directGrant.permission);
+  if (best === "admin") return best;
+  for (const role of await resolveTeamRolesForUser(nestId, userId)) {
+    best = higher(best, teamRoleToPermission(role));
+  }
+  if (best === "admin") return best;
+  const stewardGrant = await db.get(
+    `SELECT 1 FROM stewards s
+         JOIN users u ON u.id = ?
+        WHERE s.nest_id = ? AND s.is_active = 1
+          AND LOWER(s.user_email) = LOWER(u.email)
+        LIMIT 1`,
+    [userId, nestId]
+  );
+  if (stewardGrant) best = higher(best, "read");
+  if (nest.visibility === "public") best = higher(best, "read");
+  return best;
 }
-async function buildDocContext(nestId, nodeId, baseUrl) {
-  const titles = await buildTitleMap(nestId);
-  const docTitle = titles.get(nodeId) || nodeId;
-  const folder = folderForNode(nodeId);
-  const name = await nestName(nestId);
-  return {
-    docTitle,
-    // Slack one-liner label ("Title (in Folder)"), same as describeNode().
-    label: folder ? `${docTitle} (in ${folder})` : docTitle,
-    path: folder ? `${name} / ${folder}` : name,
-    link: docLink(nestId, nodeId, baseUrl)
-  };
+function permissionLevel(p) {
+  return PERMISSION_LEVELS[p] ?? 0;
 }
-
-// src/governance/stewardship-service.ts
-async function assignSteward(data) {
+async function isPublicReader(nestId, userId) {
   const db = getDb();
-  const id = uuid3();
-  await db.run(
-    `INSERT INTO stewards
-     (id, nest_id, scope, node_pattern, tag_name, user_email, user_id, role, assigned_by, is_active)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [
-      id,
-      data.nestId,
-      data.scope,
-      data.nodePattern || null,
-      data.tagName || null,
-      data.userEmail,
-      data.userId || null,
-      data.role,
-      data.assignedBy,
-      data.isActive ? 1 : 0
-    ]
+  const nest = await db.get("SELECT user_id, visibility FROM nests WHERE id = ?", [nestId]);
+  if (!nest) return false;
+  if (nest.visibility !== "public") return false;
+  if (nest.user_id === userId) return false;
+  const directGrant = await db.get(
+    "SELECT 1 FROM nest_collaborators WHERE nest_id = ? AND user_id = ?",
+    [nestId, userId]
+  );
+  if (directGrant) return false;
+  if (await isLicenseAdminUserId(userId)) return false;
+  const caller = await db.get("SELECT email FROM users WHERE id = ?", [userId]);
+  if (caller?.email && isSuperAdmin(caller.email)) return false;
+  const stewardGrant = await db.get(
+    `SELECT 1 FROM stewards s
+         JOIN users u ON u.id = ?
+        WHERE s.nest_id = ? AND s.is_active = 1
+          AND LOWER(s.user_email) = LOWER(u.email)
+        LIMIT 1`,
+    [userId, nestId]
   );
-  return { ...data, id };
+  if (stewardGrant) return false;
+  if ((await resolveTeamRolesForUser(nestId, userId)).length > 0) return false;
+  return true;
 }
-async function removeSteward(id) {
-  const db = getDb();
-  await db.run("DELETE FROM stewards WHERE id = ?", [id]);
+
+// src/governance/tag-index-service.ts
+function normalizeTag(raw) {
+  return raw.trim().replace(/^#+/, "").toLowerCase();
 }
-var VALID_STEWARD_ROLES = ["editor", "reviewer", "viewer"];
-async function updateSteward(id, update) {
+async function syncNodeTags(nestId, nodeId, tags) {
   const db = getDb();
-  const current = await db.get(
-    "SELECT * FROM stewards WHERE id = ? AND is_active = 1",
-    [id]
+  const normalized = Array.from(
+    new Set(
+      tags.filter((t) => typeof t === "string").map(normalizeTag).filter(Boolean)
+    )
   );
-  if (!current) {
-    throw new ValidationError("Steward not found");
-  }
-  const role = update.role ?? current.role;
-  if (!VALID_STEWARD_ROLES.includes(role)) {
-    throw new ValidationError(
-      `Invalid role "${role}" \u2014 must be editor, reviewer, or viewer.`
+  const insertSql = insertOrIgnore(
+    db,
+    "INSERT INTO node_tag_index (nest_id, node_id, tag_name) VALUES (?, ?, ?)"
+  );
+  await db.transaction(async (tx) => {
+    await tx.run(
+      "DELETE FROM node_tag_index WHERE nest_id = ? AND node_id = ?",
+      [nestId, nodeId]
     );
-  }
-  let scope = current.scope;
-  let nodePattern = current.node_pattern ?? null;
-  let tagName = current.tag_name ?? null;
-  if (update.scope) {
-    scope = update.scope;
-    nodePattern = null;
-    tagName = null;
-    switch (scope) {
-      case "document":
-        if (!update.documentId)
-          throw new ValidationError("documentId required for document scope");
-        nodePattern = update.documentId;
-        break;
-      case "tag":
-        if (!update.tagName)
-          throw new ValidationError("tagName required for tag scope");
-        tagName = update.tagName.trim().replace(/^#+/, "").toLowerCase();
-        break;
-      case "nest":
-        break;
+    for (const tag of normalized) {
+      await tx.run(insertSql, [nestId, nodeId, tag]);
     }
-    const dup = await db.get(
-      `SELECT role FROM stewards
-         WHERE nest_id = ? AND is_active = 1 AND id != ? AND scope = ?
-           AND user_email = ?
-           AND COALESCE(node_pattern, '') = COALESCE(?, '')
-           AND COALESCE(tag_name, '') = COALESCE(?, '')`,
-      [current.nest_id, id, scope, current.user_email, nodePattern, tagName]
+  });
+}
+async function removeNodeFromTagIndex(nestId, nodeId) {
+  const db = getDb();
+  await db.run(
+    "DELETE FROM node_tag_index WHERE nest_id = ? AND node_id = ?",
+    [nestId, nodeId]
+  );
+}
+
+// src/nests/service.ts
+async function isImportedNest(nestId) {
+  const row = await getDb().get(
+    "SELECT is_imported FROM nests WHERE id = ?",
+    [nestId]
+  );
+  return !!row?.is_imported;
+}
+function toSlug(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+async function uniqueNestName(userId, baseName) {
+  const db = getDb();
+  let candidate = baseName;
+  let n = 0;
+  while (n < 1e3) {
+    const slug = toSlug(candidate);
+    const hit = await db.get(
+      "SELECT 1 FROM nests WHERE user_id = ? AND slug = ? LIMIT 1",
+      [userId, slug]
     );
-    if (dup) {
-      const scopeLabel = scope === "document" ? `document "${nodePattern}"` : scope === "tag" ? `tag "#${tagName}"` : "this nest";
-      throw new ConflictError(
-        `"${current.user_email}" is already a steward of ${scopeLabel} with the "${dup.role}" role.`
-      );
-    }
+    if (!hit) return candidate;
+    n++;
+    candidate = `${baseName} (${n})`;
   }
-  await db.run(
-    "UPDATE stewards SET role = ?, scope = ?, node_pattern = ?, tag_name = ? WHERE id = ?",
-    [role, scope, nodePattern, tagName, id]
+  return candidate;
+}
+async function isStewardshipEnabled(nestId) {
+  const db = getDb();
+  const row = await db.get(
+    "SELECT stewardship_enabled FROM nests WHERE id = ?",
+    [nestId]
   );
-  const row = await db.get("SELECT * FROM stewards WHERE id = ?", [id]);
-  return rowToSteward(row);
+  return !!row?.stewardship_enabled;
+}
+async function setStewardshipEnabled(nestId, enabled) {
+  const db = getDb();
+  await db.run("UPDATE nests SET stewardship_enabled = ? WHERE id = ?", [
+    enabled ? 1 : 0,
+    nestId
+  ]);
 }
-async function updateStewardRole(id, role) {
-  return updateSteward(id, { role });
+async function nestAllowsSelfApprove(nestId) {
+  const db = getDb();
+  const row = await db.get(
+    "SELECT allow_self_approve FROM nests WHERE id = ?",
+    [nestId]
+  );
+  return !!row?.allow_self_approve;
 }
-async function getSteward(id) {
+async function setAllowSelfApprove(nestId, allow) {
   const db = getDb();
-  const row = await db.get("SELECT * FROM stewards WHERE id = ?", [id]);
-  return row ? rowToSteward(row) : null;
+  await db.run("UPDATE nests SET allow_self_approve = ? WHERE id = ?", [
+    allow ? 1 : 0,
+    nestId
+  ]);
 }
-async function getStewardsForNest(nestId) {
+async function nestReviewsPrimeOnly(nestId) {
   const db = getDb();
-  const rows = await db.all(
-    "SELECT * FROM stewards WHERE nest_id = ? AND is_active = 1",
+  const row = await db.get(
+    "SELECT prime_only_review FROM nests WHERE id = ?",
     [nestId]
   );
-  return enrichWithTitles(nestId, rows.map(rowToSteward));
+  return !!row?.prime_only_review;
 }
-async function getStewardsForScope(params) {
+async function setPrimeOnlyReview(nestId, enabled) {
   const db = getDb();
-  let sql = "SELECT * FROM stewards WHERE nest_id = ? AND is_active = 1";
-  const args = [params.nestId];
-  if (params.scope) {
-    sql += " AND scope = ?";
-    args.push(params.scope);
-  }
-  if (params.scopeTarget) {
-    sql += " AND (node_pattern = ? OR tag_name = ?)";
-    args.push(params.scopeTarget, params.scopeTarget);
-  }
-  return (await db.all(sql, args)).map(rowToSteward);
+  await db.run("UPDATE nests SET prime_only_review = ? WHERE id = ?", [
+    enabled ? 1 : 0,
+    nestId
+  ]);
 }
-async function listStewards(params) {
+async function nestPrimeTags(nestId) {
   const db = getDb();
-  let sql = "SELECT * FROM stewards WHERE nest_id = ? AND is_active = 1";
-  const args = [params.nestId];
-  if (params.scope) {
-    sql += " AND scope = ?";
-    args.push(params.scope);
-  }
-  if (params.search) {
-    sql += " AND (user_email LIKE ? OR tag_name LIKE ? OR node_pattern LIKE ?)";
-    const like = `%${params.search.toLowerCase()}%`;
-    args.push(like, like, like);
-  }
-  sql += " ORDER BY scope, COALESCE(node_pattern, tag_name, ''), user_email";
-  const stewards = (await db.all(sql, args)).map(rowToSteward);
-  return enrichWithTitles(params.nestId, stewards);
-}
-async function enrichWithTitles(nestId, stewards) {
-  if (!stewards.some((s) => s.scope === "document")) return stewards;
-  const titleByNodeId = await buildTitleMap(nestId);
-  for (const s of stewards) {
-    if (s.scope === "document" && s.nodePattern) {
-      s.nodeTitle = titleByNodeId.get(s.nodePattern);
-    }
-  }
-  return stewards;
-}
-async function createStewardRecord(params) {
-  if (params.users.length === 0) {
-    throw new Error("At least one user is required");
-  }
-  let nodePattern;
-  let tagName;
-  switch (params.scope) {
-    case "document":
-      if (!params.documentId) throw new Error("documentId required for document scope");
-      nodePattern = params.documentId;
-      break;
-    case "tag":
-      if (!params.tagName) throw new Error("tagName required for tag scope");
-      tagName = params.tagName.trim().replace(/^#+/, "").toLowerCase();
-      break;
-    case "nest":
-      break;
-  }
+  const row = await db.get("SELECT prime_tags FROM nests WHERE id = ?", [
+    nestId
+  ]);
+  return parsePrimeTags(row?.prime_tags);
+}
+async function setPrimeTags(nestId, tags) {
   const db = getDb();
-  const results = [];
-  const actor = (params.assignedBy || "").trim().toLowerCase();
-  const ownerEmail = (await getNestOwnerEmail(params.nestId) || "").toLowerCase();
-  for (const user of params.users) {
-    const email = user.email.trim().toLowerCase();
-    if (!email) continue;
-    if (!isEmailish(email)) {
-      throw new ValidationError(`"${user.email}" is not a valid email address.`);
-    }
-    if (email === actor) {
-      throw new ValidationError(
-        "You already manage this nest, so you can't add yourself as a steward."
-      );
-    }
-    if (ownerEmail && email === ownerEmail) {
+  await db.run("UPDATE nests SET prime_tags = ? WHERE id = ?", [
+    parsePrimeTags(tags.join(",")).join(","),
+    nestId
+  ]);
+}
+function parsePrimeTags(raw) {
+  if (!raw) return [];
+  return [
+    ...new Set(
+      raw.split(",").map((t) => normalizeTag(t)).filter(Boolean)
+    )
+  ];
+}
+async function disableStewardshipAndWipeGovernance(nestId) {
+  const db = getDb();
+  return db.transaction(async (tx) => {
+    const id = nestId;
+    const stewards = (await tx.run("DELETE FROM stewards WHERE nest_id = ?", [id])).changes;
+    const pendingReviews = (await tx.run(
+      "DELETE FROM review_requests WHERE nest_id = ? AND status = 'pending'",
+      [id]
+    )).changes;
+    await tx.run("UPDATE nests SET stewardship_enabled = 0 WHERE id = ?", [id]);
+    return { stewards, pendingReviews };
+  });
+}
+async function renameNest(nestId, patch) {
+  const db = getDb();
+  const existing = await db.get("SELECT * FROM nests WHERE id = ?", [
+    nestId
+  ]);
+  if (!existing) {
+    throw new ValidationError("Nest not found");
+  }
+  const updates = [];
+  const params = [];
+  if (patch.name !== void 0) {
+    const trimmed = patch.name.trim();
+    if (!trimmed) throw new ValidationError("Name cannot be empty");
+    const slug = toSlug(trimmed);
+    if (!slug) throw new ValidationError("Name must contain at least one alphanumeric character");
+    const conflict = await db.get(
+      "SELECT id FROM nests WHERE user_id = ? AND slug = ? AND id != ? LIMIT 1",
+      [existing.user_id, slug, nestId]
+    );
+    if (conflict) {
       throw new ValidationError(
-        "The nest owner already has full access and doesn't need a steward role."
+        `Another nest already uses this name. Pick a different one.`
       );
     }
-    const existing = await db.get(
-      `SELECT * FROM stewards
-         WHERE nest_id = ? AND is_active = 1 AND scope = ? AND user_email = ?
-           AND COALESCE(node_pattern, '') = COALESCE(?, '')
-           AND COALESCE(tag_name, '') = COALESCE(?, '')`,
-      [
-        params.nestId,
-        params.scope,
-        email,
-        nodePattern ?? null,
-        tagName ?? null
-      ]
+    updates.push("name = ?", "slug = ?");
+    params.push(trimmed, slug);
+  }
+  if (patch.description !== void 0) {
+    updates.push("description = ?");
+    params.push(patch.description || null);
+  }
+  if (updates.length === 0) {
+    return existing;
+  }
+  params.push(nestId);
+  await db.run(
+    `UPDATE nests SET ${updates.join(", ")} WHERE id = ?`,
+    params
+  );
+  return await db.get("SELECT * FROM nests WHERE id = ?", [nestId]);
+}
+async function createNest(userId, name, description) {
+  const id = uuid2();
+  const db = getDb();
+  const trimmed = name.trim();
+  if (!trimmed) throw new ValidationError("Name cannot be empty");
+  const slug = toSlug(trimmed);
+  if (!slug) {
+    throw new ValidationError(
+      "Name must contain at least one alphanumeric character"
     );
-    if (existing) {
-      const scopeLabel = params.scope === "document" ? `document "${nodePattern}"` : params.scope === "tag" ? `tag "#${tagName}"` : "this nest";
-      throw new ConflictError(
-        `"${email}" is already a steward of ${scopeLabel} with the "${existing.role}" role. Remove the existing assignment first to change the role.`
-      );
-    }
-    const userRow = await db.get(
-      "SELECT id FROM users WHERE email = ?",
-      [email]
+  }
+  const conflict = await db.get(
+    "SELECT id FROM nests WHERE user_id = ? AND slug = ? LIMIT 1",
+    [userId, slug]
+  );
+  if (conflict) {
+    throw new ValidationError(
+      "You already have a nest with this name. Pick a different one."
     );
-    let userId = userRow?.id;
-    if (!userId) {
-      const { hashPassword } = await import("./keys-73STFJJB.js");
-      userId = uuid3();
-      await db.run(
-        "INSERT INTO users (id, email, name, password_hash, is_invited) VALUES (?, ?, ?, ?, 1)",
-        [userId, email, null, await hashPassword(uuid3())]
-      );
-    }
-    const created = await assignSteward({
-      nestId: params.nestId,
-      scope: params.scope,
-      nodePattern,
-      tagName,
-      userEmail: email,
-      userId,
-      role: user.role ?? "reviewer",
-      assignedBy: params.assignedBy,
-      assignedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      isActive: true
-    });
-    results.push(created);
+  }
+  const visibility = userId === ANON_USER_ID ? "public" : "private";
+  await db.run(
+    "INSERT INTO nests (id, user_id, name, slug, description, visibility) VALUES (?, ?, ?, ?, ?, ?)",
+    [id, userId, trimmed, slug, description || null, visibility]
+  );
+  const path = resolveNestPath(id);
+  mkdirSync(path, { recursive: true });
+  const storage = new NestStorage3(path);
+  await storage.init(trimmed);
+  trackEvent("nest.create", { nestId: id, userId });
+  return await db.get("SELECT * FROM nests WHERE id = ?", [id]);
+}
+async function importNest(userId, name, files) {
+  const nm = (name || "").trim();
+  if (!nm) {
+    throw new ValidationError("name is required");
+  }
+  if (!Array.isArray(files)) {
+    throw new ValidationError("files are required");
+  }
+  const db = getDb();
+  const id = uuid2();
+  const slug = toSlug(nm);
+  const visibility = userId === ANON_USER_ID ? "public" : "private";
+  const dest = resolveNestPath(id);
+  mkdirSync(dest, { recursive: true });
+  try {
+    await writeImportedFiles(dest, files);
+  } catch (err) {
+    console.error("[nests] import write failed", dest, err);
+    discardImportDir(dest);
+    throw new ValidationError("Failed to import folder");
   }
   await db.run(
-    "UPDATE nests SET stewardship_enabled = 1 WHERE id = ? AND stewardship_enabled = 0",
-    [params.nestId]
-  );
-  return results;
-}
-async function resolveStewardsForNode(nestId, nodeId) {
-  return (await resolve(nestId, nodeId)).stewards;
-}
-async function resolveStewardsWithFallback(nestId, nodeId) {
-  return resolve(nestId, nodeId);
-}
-async function resolve(nestId, nodeId) {
-  const db = getDb();
-  const rows = await db.all(
-    `
-      SELECT s.*, 1 AS priority, ('document: ' || s.node_pattern) AS match_source
-        FROM stewards s
-        WHERE s.nest_id = ? AND s.is_active = 1 AND s.scope = 'document'
-          AND s.node_pattern = ?
-      UNION ALL
-      SELECT s.*, 2 AS priority, ('tag: ' || s.tag_name) AS match_source
-        FROM stewards s
-        JOIN node_tag_index nt
-          ON nt.nest_id = s.nest_id
-         AND nt.tag_name = s.tag_name
-        WHERE s.nest_id = ? AND s.is_active = 1 AND s.scope = 'tag'
-          AND nt.node_id = ?
-      UNION ALL
-      SELECT s.*, 3 AS priority, 'nest-level steward' AS match_source
-        FROM stewards s
-        WHERE s.nest_id = ? AND s.is_active = 1 AND s.scope = 'nest'
-      ORDER BY priority ASC, user_email ASC
-      `,
-    [
-      nestId,
-      nodeId,
-      // document branch
-      nestId,
-      nodeId,
-      // tag branch
-      nestId
-      // nest branch
-    ]
-  );
-  const resolved = rows.map((row) => ({
-    steward: rowToSteward(row),
-    priority: row.priority,
-    source: row.match_source
-  }));
-  if (resolved.length > 0) {
-    return { stewards: resolved, fallbackToOwner: false };
-  }
-  const owner = await db.get(
-    `SELECT u.email FROM nests n
-       JOIN users u ON u.id = n.user_id
-       WHERE n.id = ?`,
-    [nestId]
+    "INSERT INTO nests (id, user_id, name, slug, description, visibility, is_imported) VALUES (?, ?, ?, ?, ?, ?, 1)",
+    [id, userId, nm, slug, null, visibility]
   );
-  return {
-    stewards: [],
-    fallbackToOwner: true,
-    ownerEmail: owner?.email
-  };
+  trackEvent("nest.import", { nestId: id, userId });
+  return await db.get("SELECT * FROM nests WHERE id = ?", [id]);
 }
-async function userIdForEmail(email) {
+async function listNests(userId) {
   const db = getDb();
-  const row = await db.get(
-    "SELECT id FROM users WHERE LOWER(email) = LOWER(?)",
-    [email]
+  if (userId === ANON_USER_ID) {
+    return await db.all(
+      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
+      [ANON_USER_ID]
+    );
+  }
+  const includeAnon = config.AUTH_MODE === "open" || await isLicenseAdminUserId(userId);
+  if (!includeAnon) {
+    return await db.all(
+      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
+      [userId]
+    );
+  }
+  return await db.all(
+    "SELECT * FROM nests WHERE user_id = ? OR user_id = ? ORDER BY created_at DESC",
+    [userId, ANON_USER_ID]
   );
-  return row?.id;
 }
-async function getStewardRolesForUser(nestId, userEmail) {
+async function nestsSharedViaTeams(userId) {
   const db = getDb();
-  const rows = await db.all(
-    "SELECT DISTINCT role FROM stewards WHERE nest_id = ? AND is_active = 1 AND LOWER(user_email) = LOWER(?)",
-    [nestId, userEmail]
+  const teams = await db.all(
+    "SELECT id, members FROM teams WHERE members LIKE ?",
+    [`%${userId}%`]
   );
-  return rows.map((r) => r.role);
-}
-async function getStewardsForUser(nestId, userEmail) {
-  const db = getDb();
-  const rows = await db.all(
-    "SELECT * FROM stewards WHERE nest_id = ? AND is_active = 1 AND LOWER(user_email) = LOWER(?)",
-    [nestId, userEmail]
+  const myTeamIds = /* @__PURE__ */ new Set();
+  for (const t of teams) {
+    try {
+      const members = JSON.parse(t.members || "[]");
+      if (Array.isArray(members) && members.some((m) => m?.userId === userId)) {
+        myTeamIds.add(t.id);
+      }
+    } catch {
+    }
+  }
+  if (myTeamIds.size === 0) return [];
+  const ids = [...myTeamIds];
+  const candidates = await db.all(
+    `SELECT * FROM nests
+       WHERE user_id != ?
+         AND (${ids.map(() => "shared_teams LIKE ?").join(" OR ")})`,
+    [userId, ...ids.map((id) => `%${id}%`)]
   );
-  return rows.map(rowToSteward);
+  return candidates.filter((n) => {
+    try {
+      const refs = JSON.parse(n.shared_teams || "[]");
+      return Array.isArray(refs) && refs.some((r) => myTeamIds.has(r?.teamId));
+    } catch {
+      return false;
+    }
+  });
 }
-async function getCollaboratorRole(nestId, userEmail) {
-  const userId = await userIdForEmail(userEmail);
-  if (!userId) return null;
+async function listSharedNests(userId) {
   const db = getDb();
-  const row = await db.get(
-    "SELECT permission FROM nest_collaborators WHERE nest_id = ? AND user_id = ?",
-    [nestId, userId]
+  const direct = await db.all(
+    `SELECT DISTINCT n.* FROM nests n
+       LEFT JOIN nest_collaborators nc
+         ON nc.nest_id = n.id AND nc.user_id = ?
+       LEFT JOIN users u ON u.id = ?
+       LEFT JOIN stewards s
+         ON s.nest_id = n.id AND s.is_active = 1
+        AND LOWER(s.user_email) = LOWER(u.email)
+       WHERE n.user_id != ?
+         AND (nc.user_id IS NOT NULL OR s.id IS NOT NULL)
+       ORDER BY n.created_at DESC`,
+    [userId, userId, userId]
   );
-  return row?.permission ?? null;
-}
-async function resolveGrantRoles(nestId, userEmail, userId) {
-  const [grantRaw, stewardRoles, teamRoles] = await Promise.all([
-    getCollaboratorRole(nestId, userEmail),
-    getStewardRolesForUser(nestId, userEmail),
-    resolveTeamRolesForUser(nestId, userId)
-  ]);
-  return [
-    ...new Set(
-      [collabPermToRole(grantRaw), ...stewardRoles, ...teamRoles].filter(
-        Boolean
-      )
-    )
-  ];
-}
-async function resolveUserRoles(nestId, userEmail, opts) {
-  const roles = /* @__PURE__ */ new Set();
-  if (isSuperAdmin(userEmail)) roles.add("admin");
-  const owner = await getNestOwnerEmail(nestId);
-  if (owner && owner.toLowerCase() === userEmail.toLowerCase()) {
-    roles.add("owner");
-  }
-  const userId = await userIdForEmail(userEmail);
-  if (userId) {
-    const collabRole = collabPermToRole(await resolveNestPermission(nestId, userId));
-    if (collabRole) roles.add(collabRole);
-    for (const role of await resolveTeamRolesForUser(nestId, userId)) {
-      roles.add(role);
+  const seen = new Set(direct.map((n) => n.id));
+  for (const n of await nestsSharedViaTeams(userId)) {
+    if (!seen.has(n.id)) {
+      direct.push(n);
+      seen.add(n.id);
     }
   }
-  const stewardRoles = opts?.nodeId ? (await resolveStewardsForNode(nestId, opts.nodeId)).filter(
-    (r) => r.steward.userEmail.toLowerCase() === userEmail.toLowerCase()
-  ).map((r) => r.steward.role) : await getStewardRolesForUser(nestId, userEmail);
-  for (const role of stewardRoles) roles.add(role);
-  return [...roles];
-}
-async function canManageStewards(nestId, userId) {
-  if (config.AUTH_MODE === "open") return true;
-  const perm = await resolveNestPermission(nestId, userId);
-  return perm === "owner" || perm === "admin";
-}
-async function canCreateInNest(nestId, userEmail) {
-  if (config.AUTH_MODE === "open" || isSuperAdmin(userEmail)) return true;
-  const userId = await userIdForEmail(userEmail);
-  if (userId) {
-    const perm = await resolveNestPermission(nestId, userId);
-    if (perm === "owner" || perm === "admin" || perm === "write") return true;
+  if (await isServerAdminUserId(userId)) {
+    const anon = await db.all(
+      "SELECT * FROM nests WHERE user_id = ? ORDER BY created_at DESC",
+      [ANON_USER_ID]
+    );
+    for (const n of anon) {
+      if (!seen.has(n.id)) {
+        direct.push(n);
+        seen.add(n.id);
+      }
+    }
   }
-  return (await getStewardsForUser(nestId, userEmail)).some(
-    (s) => s.role === "editor" && s.scope === "nest"
+  direct.sort(
+    (a, b) => a.created_at === b.created_at ? 0 : a.created_at < b.created_at ? 1 : -1
   );
+  return direct;
 }
-async function getNestOwnerEmail(nestId) {
+async function listVisibleNests(userId) {
   const db = getDb();
-  const row = await db.get(
-    `SELECT u.email FROM nests n
-       JOIN users u ON u.id = n.user_id
-       WHERE n.id = ?`,
-    [nestId]
+  const includeAnon = config.AUTH_MODE === "open" || await isServerAdminUserId(userId);
+  const params = includeAnon ? [userId, userId, userId, ANON_USER_ID] : [userId, userId, userId];
+  const rows = await db.all(
+    `SELECT DISTINCT n.* FROM nests n
+       LEFT JOIN nest_collaborators nc
+         ON nc.nest_id = n.id AND nc.user_id = ?
+       LEFT JOIN users u ON u.id = ?
+       LEFT JOIN stewards s
+         ON s.nest_id = n.id AND s.is_active = 1
+        AND LOWER(s.user_email) = LOWER(u.email)
+      WHERE n.user_id = ?
+         OR nc.user_id IS NOT NULL
+         OR s.id IS NOT NULL
+         ${includeAnon ? "OR n.user_id = ?" : ""}
+      ORDER BY n.created_at DESC`,
+    params
   );
-  return row?.email ?? null;
-}
-async function canUserEdit(nestId, nodeId, userEmail) {
-  const roles = await resolveUserRoles(nestId, userEmail, { nodeId });
-  if (roles.includes("owner")) {
-    return { allowed: true, reason: "nest owner", role: "owner" };
-  }
-  if (isSuperAdmin(userEmail)) {
-    return { allowed: true, reason: "super admin", role: "super_admin" };
-  }
-  if (canEditWith(roles)) {
-    return {
-      allowed: true,
-      reason: "editor access (collaborator or steward)",
-      role: roles.includes("admin") ? "admin" : "editor"
-    };
+  const seen = new Set(rows.map((n) => n.id));
+  for (const n of await nestsSharedViaTeams(userId)) {
+    if (!seen.has(n.id)) {
+      rows.push(n);
+      seen.add(n.id);
+    }
   }
-  return { allowed: false, reason: "no editor role on this node", role: null };
+  return rows;
 }
-async function getCurrentVersionAuthor(nestId, nodeId) {
+async function listPublicNests(userId) {
   const db = getDb();
-  const row = await db.get(
-    `SELECT author FROM node_versions
-       WHERE nest_id = ? AND node_id = ?
-       ORDER BY version DESC LIMIT 1`,
-    [nestId, nodeId]
+  return await db.all(
+    `SELECT n.* FROM nests n
+       WHERE n.visibility = 'public'
+         AND n.user_id != ?
+         AND NOT EXISTS (
+           SELECT 1 FROM nest_collaborators nc
+           WHERE nc.nest_id = n.id AND nc.user_id = ?
+         )
+       ORDER BY n.created_at DESC`,
+    [userId, userId]
   );
-  return row?.author ?? null;
 }
-async function getPendingReviewRequester(nestId, nodeId) {
+async function getNest(nestId) {
   const db = getDb();
-  const row = await db.get(
-    `SELECT requested_by FROM review_requests
-       WHERE nest_id = ? AND node_id = ? AND status = 'pending'
-       ORDER BY requested_at DESC LIMIT 1`,
-    [nestId, nodeId]
-  );
-  return row?.requested_by ?? null;
-}
-async function canUserApprove(nestId, nodeId, userEmail) {
-  const roles = await resolveUserRoles(nestId, userEmail, { nodeId });
-  const isOwner = roles.includes("owner");
-  const isSuper = isSuperAdmin(userEmail);
-  const allowSelf = await nestAllowsSelfApprove(nestId);
-  const hasStewardApprove = roles.includes("admin") || roles.includes("reviewer");
-  const actor = await getPendingReviewRequester(nestId, nodeId) ?? await getCurrentVersionAuthor(nestId, nodeId);
-  const isOwnSubmission = !!actor && actor.toLowerCase() === userEmail.toLowerCase();
-  if (hasStewardApprove) {
-    if (isOwnSubmission && !((isOwner || isSuper) && allowSelf)) {
-      return {
-        allowed: false,
-        reason: "You submitted this version for review, so you can't approve it yourself. Ask another reviewer to approve it (separation of duties).",
-        role: roles.includes("admin") ? "admin" : "reviewer"
-      };
-    }
-    return {
-      allowed: true,
-      reason: "reviewer access (collaborator or steward)",
-      role: roles.includes("admin") ? "admin" : "reviewer"
-    };
-  }
-  if (isOwner || isSuper) {
-    if (allowSelf) {
-      return {
-        allowed: true,
-        reason: isOwner ? "nest owner (self-approve enabled)" : "super admin",
-        role: isOwner ? "owner" : "super_admin"
-      };
-    }
-    return {
-      allowed: false,
-      reason: "Approvals go to assigned reviewers while self-approve is off. Enable self-approve in nest settings to approve directly (e.g. while seeding), or add a reviewer steward.",
-      role: isOwner ? "owner" : "super_admin"
-    };
-  }
-  const held = primaryRole(roles);
-  return {
-    allowed: false,
-    reason: held ? `You're a "${held}" on this document \u2014 only reviewers (or admins) can approve. Ask the nest owner to grant you the reviewer steward role.` : "You're not a steward on this document, so you can't approve it. Ask the nest owner to add you as a reviewer.",
-    role: held
-  };
-}
-async function canUserAccess(nestId, nodeId, userEmail) {
-  const roles = await resolveUserRoles(nestId, userEmail, { nodeId });
-  if (roles.includes("owner")) {
-    return { allowed: true, reason: "nest owner", role: "owner" };
-  }
-  if (isSuperAdmin(userEmail)) {
-    return { allowed: true, reason: "super admin", role: "super_admin" };
-  }
-  if (canViewWith(roles)) {
-    return {
-      allowed: true,
-      reason: "collaborator or steward access",
-      role: primaryRole(roles)
-    };
-  }
-  return { allowed: false, reason: "no collaborator or steward access", role: null };
+  return await db.get("SELECT * FROM nests WHERE id = ?", [nestId]) || null;
 }
-async function syncFromConfig(nestId, config2) {
+async function deleteNest(nestId) {
   const db = getDb();
-  let count = 0;
-  await db.run(
-    "UPDATE stewards SET is_active = 0 WHERE nest_id = ?",
-    [nestId]
-  );
-  await db.run(
-    "UPDATE nests SET stewardship_enabled = 1 WHERE id = ?",
-    [nestId]
-  );
-  const addEntries = async (scope, entries, target) => {
-    for (const entry of entries) {
-      const user = await db.get(
-        "SELECT id FROM users WHERE email = ?",
-        [entry.email]
-      );
-      const rawRole = entry.role || "reviewer";
-      const role = rawRole === "admin" ? "reviewer" : rawRole;
-      await assignSteward({
-        nestId,
-        scope,
-        nodePattern: target?.nodePattern,
-        tagName: target?.tagName ? target.tagName.trim().replace(/^#+/, "").toLowerCase() : void 0,
-        userEmail: entry.email.toLowerCase(),
-        userId: user?.id,
-        role,
-        assignedBy: "config",
-        assignedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        isActive: true
-      });
-      count++;
-    }
-  };
-  if (config2.nest) {
-    await addEntries("nest", config2.nest);
-  }
-  if (config2.tags) {
-    for (const [tagName, entries] of Object.entries(config2.tags)) {
-      await addEntries("tag", entries, { tagName });
-    }
-  }
-  if (config2.documents) {
-    for (const [docPattern, entries] of Object.entries(config2.documents)) {
-      await addEntries("document", entries, { nodePattern: docPattern });
+  await db.transaction(async (tx) => {
+    const id = nestId;
+    await tx.run("DELETE FROM approved_versions WHERE nest_id = ?", [id]);
+    await tx.run("DELETE FROM node_versions WHERE nest_id = ?", [id]);
+    await tx.run("DELETE FROM review_requests WHERE nest_id = ?", [id]);
+    await tx.run("DELETE FROM stewards WHERE nest_id = ?", [id]);
+    await tx.run("DELETE FROM nest_collaborators WHERE nest_id = ?", [id]);
+    try {
+      await tx.run("DELETE FROM node_tag_index WHERE nest_id = ?", [id]);
+    } catch {
     }
+    await tx.run("DELETE FROM api_keys WHERE nest_id = ?", [id]);
+    await tx.run("DELETE FROM nests WHERE id = ?", [id]);
+  });
+  const path = resolveNestPath(nestId);
+  try {
+    rmSync2(path, { recursive: true, force: true });
+  } catch (err) {
+    console.warn(`[nests] failed to remove nest directory ${path}:`, err);
   }
-  return count;
-}
-function rowToSteward(row) {
-  return {
-    id: row.id,
-    nestId: row.nest_id,
-    scope: row.scope,
-    nodePattern: row.node_pattern || void 0,
-    tagName: row.tag_name || void 0,
-    userEmail: row.user_email,
-    userId: row.user_id || void 0,
-    role: row.role,
-    assignedBy: row.assigned_by,
-    assignedAt: row.assigned_at,
-    isActive: !!row.is_active
-  };
+  trackEvent("nest.delete", { nestId });
 }
 
 export {
+  nowExpr,
+  insertOrIgnore,
+  insertOrReplace,
   trackEvent,
   startTelemetryLoop,
   persistSetting,
@@ -2177,31 +2166,23 @@ export {
   getAccessConfig,
   isSuperAdmin,
   isConfigSuperAdmin,
-  createTeam,
-  findTeamByExternalId,
-  listTeamsForUser,
-  getTeam,
-  renameTeam,
-  deleteTeam,
-  addMember,
-  resolveMemberIdentity,
-  replaceTeamRoster,
-  updateMemberRole,
-  removeMember,
-  listNestTeams,
-  shareTeamWithNest,
-  unshareTeamFromNest,
-  isServerAdminUserId,
-  resolveNestPermission,
-  permissionLevel,
-  isPublicReader,
+  verifySmtp,
+  notifyEmailForNest,
+  sendEmailToRecipient,
   nestStorageRoot,
   resolveNestPath,
+  normalizeTag,
+  syncNodeTags,
+  removeNodeFromTagIndex,
   uniqueNestName,
   isStewardshipEnabled,
   setStewardshipEnabled,
   nestAllowsSelfApprove,
   setAllowSelfApprove,
+  nestReviewsPrimeOnly,
+  setPrimeOnlyReview,
+  nestPrimeTags,
+  setPrimeTags,
   disableStewardshipAndWipeGovernance,
   renameNest,
   createNest,
@@ -2214,30 +2195,35 @@ export {
   deleteNest,
   engineCache,
   buildTitleMap,
+  folderForNode,
   describeNode,
+  titleForNode,
+  prettyFolderPath,
   nestName,
   docLink,
   buildDocContext,
-  assignSteward,
-  removeSteward,
-  updateSteward,
-  updateStewardRole,
-  getSteward,
-  getStewardsForNest,
-  getStewardsForScope,
-  listStewards,
-  createStewardRecord,
-  resolveStewardsForNode,
-  resolveStewardsWithFallback,
-  getStewardRolesForUser,
-  getStewardsForUser,
-  getCollaboratorRole,
-  resolveGrantRoles,
-  resolveUserRoles,
-  canManageStewards,
-  canCreateInNest,
-  canUserEdit,
-  canUserApprove,
-  canUserAccess,
-  syncFromConfig
+  createTeam,
+  findTeamByExternalId,
+  listTeamsForUser,
+  getTeam,
+  renameTeam,
+  deleteTeam,
+  addMember,
+  resolveMemberIdentity,
+  replaceTeamRoster,
+  updateMemberRole,
+  removeMember,
+  listNestTeams,
+  shareTeamWithNest,
+  unshareTeamFromNest,
+  resolveTeamRolesForUser,
+  collabPermToRole,
+  canViewWith,
+  canEditWith,
+  canApproveWith,
+  primaryRole,
+  isServerAdminUserId,
+  resolveNestPermission,
+  permissionLevel,
+  isPublicReader
 };