@odla-ai/chapter 0.42.0 → 0.42.2

package/dist/worker/index.js

@@ -607,6 +607,11 @@ function validateAdmissionGrantDocument(input) {
     }
   };
 }
+async function createAdmissionGrantEnvelope(document) {
+  const checked = validateAdmissionGrantDocument(document);
+  if (!checked.ok) throw new TypeError(`Invalid admission grant document: ${checked.errors.join("; ")}`);
+  return { document: checked.value, digest: await signupControlDigest(checked.value) };
+}
 var rows = (value) => Array.isArray(value) ? value : [];
 function asGrant(row) {
   if (typeof row.id !== "string" || typeof row.emailNormalized !== "string") return null;
@@ -3110,12 +3115,17 @@ import { verifyFederatedRequest as verifyFederatedRequest4 } from "@odla-ai/db";
 var reject3 = (reason, status, errors) => json({ ok: false, reason, ...errors ? { errors } : {} }, status);
 var handleAdmissionGrants = async (req, url, env, ctx) => {
   if (req.method !== "POST" || url.pathname !== ADMISSION_GRANTS_PATH) return null;
-  const authority = ctx.chapter.signupControl;
-  if (!authority) return json({ error: "not found" }, 404);
+  const claimedSender = req.headers.get("x-odla-federation-sender") ?? "";
+  const networkReader = ctx.chapter.network.readers.find((reader) => reader.id === claimedSender && reader.admissionGrants);
+  const signupAuthority = ctx.chapter.signupControl?.sourceId === claimedSender ? ctx.chapter.signupControl : void 0;
+  if (!networkReader && !signupAuthority) return json({ error: "not found" }, 404);
   const db = ctx.makeDb(env);
-  const secret = await getVaultSecret(db, authority.secretName);
+  const secret = await getVaultSecret(
+    db,
+    networkReader ? "network_share_secret" : signupAuthority.secretName
+  );
   if (!secret) return json({ error: "unauthorized" }, 401);
-  const verified = await verifyFederatedRequest4(req, { secret, senders: [authority.sourceId] });
+  const verified = await verifyFederatedRequest4(req, { secret, senders: [claimedSender] });
   if (!verified.ok) return json({ error: "unauthorized", reason: verified.reason }, 401);
   let input;
   try {
@@ -3127,11 +3137,11 @@ var handleAdmissionGrants = async (req, url, env, ctx) => {
   const checked = validateAdmissionGrantDocument(input.document);
   if (!checked.ok) return reject3("invalid_document", 400, checked.errors);
   const document = checked.value;
-  if (document.source.appId !== authority.sourceId) return reject3("wrong_source", 403);
+  if (document.source.appId !== claimedSender) return reject3("wrong_source", 403);
   if (document.target.chapterId !== ctx.chapter.id) return reject3("wrong_target", 409);
   if (document.target.environment !== env.ODLA_ENV) return reject3("wrong_environment", 409);
   if (!digest || await signupControlDigest(document) !== digest) return reject3("invalid_digest", 400);
-  const latest = await loadLatestAdmissionRevision(db, authority.sourceId, ctx.chapter.id, env.ODLA_ENV);
+  const latest = await loadLatestAdmissionRevision(db, claimedSender, ctx.chapter.id, env.ODLA_ENV);
   if (latest && document.revision < latest.revision) return reject3("stale_revision", 409);
   if (latest && document.revision === latest.revision) {
     if (latest.digest !== digest) return reject3("conflicting_revision", 409);
@@ -3256,6 +3266,365 @@ var handleAdminAdmissionGrants = async (req, url, env, ctx) => {
   return null;
 };
 
+// src/worker-routes-network-admission.ts
+import { getRecord as getRecord2 } from "@odla-ai/crm";
+
+// src/admission-grants-delivery.ts
+import { signFederatedRequest } from "@odla-ai/db";
+var AdmissionGrantDeliveryError = class extends Error {
+  constructor(status, reason) {
+    super(`admission grants rejected (${status}): ${reason}`);
+    this.status = status;
+    this.reason = reason;
+    this.name = "AdmissionGrantDeliveryError";
+  }
+  status;
+  reason;
+};
+async function deliverAdmissionGrants(options) {
+  const destination = new URL(ADMISSION_GRANTS_PATH, options.targetUrl);
+  const body = JSON.stringify(options.envelope);
+  const signed = await signFederatedRequest({
+    secret: options.secret,
+    sender: options.sender,
+    method: "POST",
+    url: destination,
+    body
+  });
+  const response = await (options.fetch ?? globalThis.fetch)(destination, {
+    method: "POST",
+    headers: { ...signed, "content-type": "application/json" },
+    body
+  });
+  const result = await response.json();
+  if (!response.ok || !("ok" in result) || result.ok !== true) {
+    const failure = result;
+    throw new AdmissionGrantDeliveryError(
+      response.status,
+      failure.reason ?? failure.error ?? "unknown"
+    );
+  }
+  return result;
+}
+
+// src/worker-network-fetch.ts
+function targetFetcher(env, target) {
+  if (!target.binding) return null;
+  const candidate = env[target.binding];
+  if (typeof candidate !== "object" || candidate === null || !("fetch" in candidate) || typeof candidate.fetch !== "function") {
+    throw new Error(`service binding "${target.binding}" is unavailable`);
+  }
+  return candidate;
+}
+function fetchNetworkTarget(env, target, destination, init) {
+  const binding = targetFetcher(env, target);
+  return binding ? binding.fetch(new Request(destination, init)) : globalThis.fetch(destination, init);
+}
+
+// src/worker-network-admission-state.ts
+import { getRecord } from "@odla-ai/crm";
+var MAX_ASSIGNMENTS = 2e3;
+var admissionRows = (value) => Array.isArray(value) ? value : [];
+function assignmentId(targetId, personId) {
+  return `leader-admission:${targetId}:${personId}`;
+}
+function deliveryId(targetId, environment) {
+  return `leader-admission-delivery:${targetId}:${environment}`;
+}
+async function loadLeaderAdmissionAssignments(db, targetId) {
+  const result = await db.query({ leaderAdmissionAssignments: { $: {
+    where: { targetId },
+    order: { updatedAt: "desc" },
+    limit: MAX_ASSIGNMENTS
+  } } });
+  return admissionRows(result.leaderAdmissionAssignments);
+}
+async function loadLeaderAdmissionDelivery(db, targetId, environment) {
+  const id = deliveryId(targetId, environment);
+  const result = await db.query({ leaderAdmissionDeliveries: { $: { where: { id }, limit: 1 } } });
+  return admissionRows(result.leaderAdmissionDeliveries)[0] ?? null;
+}
+function personAdmissionEmail(ctx, record4) {
+  if (record4.type !== "person") return null;
+  const field = ctx.chapter.crm.config.types.person?.emailField;
+  if (!field) return null;
+  const raw = record4.fields[field] ?? record4.primaryEmail;
+  if (typeof raw !== "string") return null;
+  const normalized = normalizeAdmissionEmail(raw);
+  return isValidEmail(normalized) ? normalized : null;
+}
+async function grantInput(db, ctx, assignment) {
+  const person = await getRecord({ crm: ctx.chapter.crm, db }, assignment.personId);
+  const email = person ? personAdmissionEmail(ctx, person) : null;
+  if (!email) throw new Error(`person ${assignment.personId} has no valid authoritative email`);
+  return {
+    id: assignment.grantId,
+    email,
+    decision: assignment.decision,
+    ...assignment.note ? { note: assignment.note } : {},
+    ...assignment.expiresAt !== void 0 ? { expiresAt: assignment.expiresAt } : {}
+  };
+}
+async function persistLeaderAdmissionDesiredSet(opts) {
+  const now = Date.now();
+  const current = await loadLeaderAdmissionAssignments(opts.db, opts.target.id);
+  const id = assignmentId(opts.target.id, opts.personId);
+  const existing = current.find((row) => row.id === id);
+  const digest = await signupControlDigest({
+    targetId: opts.target.id,
+    personId: opts.personId,
+    decision: opts.decision,
+    note: opts.note ?? null,
+    expiresAt: opts.expiresAt ?? null,
+    active: opts.active
+  });
+  const mutationReceiptId = `leader-admission-mutation:${opts.target.id}:${opts.mutationId}`;
+  const priorMutation2 = await opts.db.query({ leaderAdmissionMutations: { $: {
+    where: { id: mutationReceiptId },
+    limit: 1
+  } } });
+  const receipt = admissionRows(priorMutation2.leaderAdmissionMutations)[0];
+  if (receipt) {
+    if (receipt.requestDigest !== digest || receipt.personId !== opts.personId) {
+      throw new Error("mutation_conflict");
+    }
+    const saved = await loadLeaderAdmissionDelivery(opts.db, opts.target.id, opts.env.ODLA_ENV);
+    if (!saved) throw new Error("delivery_missing");
+    return { delivery: saved, duplicate: true };
+  }
+  if (existing?.lastMutationId === opts.mutationId) {
+    if (existing.lastRequestDigest !== digest) throw new Error("mutation_conflict");
+    const saved = await loadLeaderAdmissionDelivery(opts.db, opts.target.id, opts.env.ODLA_ENV);
+    if (!saved) throw new Error("delivery_missing");
+    return { delivery: saved, duplicate: true };
+  }
+  const assignment = {
+    id,
+    targetId: opts.target.id,
+    personId: opts.personId,
+    grantId: existing?.grantId ?? crypto.randomUUID().replaceAll("-", ""),
+    decision: opts.decision,
+    ...opts.note ? { note: opts.note } : {},
+    ...opts.expiresAt !== void 0 ? { expiresAt: opts.expiresAt } : {},
+    active: opts.active,
+    lastMutationId: opts.mutationId,
+    lastRequestDigest: digest,
+    createdAt: existing?.createdAt ?? now,
+    createdBy: existing?.createdBy ?? opts.actor,
+    updatedAt: now,
+    updatedBy: opts.actor
+  };
+  const desired = current.filter((row) => row.id !== id && row.active).concat(assignment.active ? [assignment] : []);
+  const grants = await Promise.all(desired.map((row) => grantInput(opts.db, opts.ctx, row)));
+  const previous = await loadLeaderAdmissionDelivery(opts.db, opts.target.id, opts.env.ODLA_ENV);
+  const revision = (previous?.revision ?? 0) + 1;
+  const envelope = await createAdmissionGrantEnvelope({
+    schemaVersion: 1,
+    revision,
+    generatedAt: now,
+    source: { appId: opts.ctx.chapter.id, actor: opts.actor },
+    target: { chapterId: opts.target.id, environment: opts.env.ODLA_ENV },
+    grants
+  });
+  const delivery = {
+    id: deliveryId(opts.target.id, opts.env.ODLA_ENV),
+    targetId: opts.target.id,
+    environment: opts.env.ODLA_ENV,
+    revision,
+    digest: envelope.digest,
+    envelope,
+    status: "saved",
+    attempts: 0,
+    updatedAt: now
+  };
+  const ops = [
+    { t: "update", ns: "leaderAdmissionAssignments", id, attrs: assignment },
+    { t: "update", ns: "leaderAdmissionDeliveries", id: delivery.id, attrs: delivery },
+    { t: "update", ns: "leaderAdmissionMutations", id: mutationReceiptId, attrs: {
+      id: mutationReceiptId,
+      targetId: opts.target.id,
+      personId: opts.personId,
+      requestDigest: digest,
+      revision,
+      createdAt: now
+    } }
+  ];
+  const retract = [
+    ...!opts.note && existing?.note !== void 0 ? ["note"] : [],
+    ...opts.expiresAt === void 0 && existing?.expiresAt !== void 0 ? ["expiresAt"] : []
+  ];
+  if (retract.length) ops.push({ t: "retract", ns: "leaderAdmissionAssignments", id, attrs: retract });
+  const tx = await opts.db.transact(ops, {
+    mutationId: `leader-admission:${opts.target.id}:${opts.mutationId}`,
+    guards: previous ? [{ ns: "leaderAdmissionDeliveries", id: previous.id, exists: true, equals: { revision: previous.revision } }] : [{ ns: "leaderAdmissionDeliveries", id: delivery.id, exists: false }]
+  });
+  return { delivery, duplicate: tx.duplicate };
+}
+
+// src/worker-routes-network-admission.ts
+var PATH = "/api/admin/network/admissions";
+var RETRY_PATH = "/api/admin/network/admissions/retry";
+var REVOKE_PATH = "/api/admin/network/admissions/revoke";
+var MUTATION_ID = /^[A-Za-z0-9_-]{16,128}$/;
+var MAX_NOTE2 = 2e3;
+var reject4 = (status, code, error) => json({ ok: false, code, error }, status);
+async function gate2(req, env, ctx) {
+  const db = ctx.makeDb(env);
+  const user = await ctx.verifyUser(req, env);
+  if (!user) return { response: reject4(401, "unauthorized", "unauthorized") };
+  if (!await ctx.isAdmin(db, user)) return { response: reject4(403, "forbidden", "forbidden") };
+  return { db, user };
+}
+function targetFor(ctx, id) {
+  return ctx.chapter.network.targets.find((target) => target.id === id && target.admissionGrants);
+}
+async function deliverSaved(db, env, ctx, target, delivery) {
+  if (delivery.status === "acknowledged") return delivery;
+  const secret = await getVaultSecret(db, target.secretName);
+  const attemptedAt = Date.now();
+  const attempts = delivery.attempts + 1;
+  let patch;
+  if (!secret) {
+    patch = {
+      status: delivery.attempts > 0 ? "retrying" : "pending",
+      attempts,
+      lastAttemptAt: attemptedAt,
+      lastError: "edge secret is missing",
+      updatedAt: attemptedAt
+    };
+  } else {
+    try {
+      const receipt = await deliverAdmissionGrants({
+        secret,
+        sender: ctx.chapter.id,
+        targetUrl: target.url,
+        envelope: delivery.envelope,
+        fetch: ((input, init) => fetchNetworkTarget(env, target, new URL(String(input)), init ?? {}))
+      });
+      patch = {
+        status: "acknowledged",
+        attempts,
+        lastAttemptAt: attemptedAt,
+        acknowledgedAt: receipt.acknowledgedAt,
+        updatedAt: attemptedAt
+      };
+    } catch (error) {
+      const permanent = error instanceof AdmissionGrantDeliveryError && error.status >= 400 && error.status < 500;
+      patch = {
+        status: permanent ? "rejected" : delivery.attempts > 0 ? "retrying" : "pending",
+        attempts,
+        lastAttemptAt: attemptedAt,
+        lastError: error instanceof Error ? error.message.slice(0, 2e3) : "delivery failed",
+        updatedAt: attemptedAt
+      };
+    }
+  }
+  const ops = [{
+    t: "update",
+    ns: "leaderAdmissionDeliveries",
+    id: delivery.id,
+    attrs: patch
+  }];
+  if (patch.status === "acknowledged" && delivery.lastError) {
+    ops.push({ t: "retract", ns: "leaderAdmissionDeliveries", id: delivery.id, attrs: ["lastError"] });
+  }
+  await db.transact(ops, {
+    mutationId: `leader-admission-attempt:${delivery.targetId}:${delivery.revision}:${attempts}:${patch.status}`
+  });
+  return { ...delivery, ...patch };
+}
+async function parseBody(req) {
+  try {
+    return await req.json();
+  } catch {
+    return null;
+  }
+}
+var handleAdminNetworkAdmissions = async (req, url, env, ctx) => {
+  if (![PATH, RETRY_PATH, REVOKE_PATH].includes(url.pathname)) return null;
+  const auth = await gate2(req, env, ctx);
+  if ("response" in auth) return auth.response;
+  const db = auth.db;
+  if (url.pathname === PATH && req.method === "GET") {
+    const targetId2 = url.searchParams.get("targetId") ?? "";
+    const target2 = targetFor(ctx, targetId2);
+    if (!target2) return reject4(404, "unknown_target", "admission target is not configured");
+    return json({
+      ok: true,
+      target: { id: target2.id, name: target2.name },
+      assignments: await loadLeaderAdmissionAssignments(db, target2.id),
+      delivery: await loadLeaderAdmissionDelivery(db, target2.id, env.ODLA_ENV)
+    });
+  }
+  if (req.method !== "POST") return null;
+  const body = await parseBody(req);
+  if (!body) return reject4(422, "invalid_request", "request body must be JSON");
+  const targetId = typeof body.targetId === "string" ? body.targetId : "";
+  const target = targetFor(ctx, targetId);
+  if (!target) return reject4(404, "unknown_target", "admission target is not configured");
+  if (url.pathname === RETRY_PATH) {
+    const delivery = await loadLeaderAdmissionDelivery(db, target.id, env.ODLA_ENV);
+    if (!delivery) return reject4(404, "not_found", "no saved admission delivery exists");
+    return json({ ok: true, delivery: await deliverSaved(db, env, ctx, target, delivery) });
+  }
+  const personId = typeof body.personId === "string" ? body.personId : "";
+  const mutationId = typeof body.mutationId === "string" ? body.mutationId : "";
+  if (!personId || !MUTATION_ID.test(mutationId)) {
+    return reject4(422, "invalid_request", "personId and a stable mutationId are required");
+  }
+  const person = await getRecord2({ crm: ctx.chapter.crm, db: auth.db }, personId);
+  if (!person) return reject4(404, "person_not_found", "person not found");
+  if (!personAdmissionEmail(ctx, person)) {
+    return reject4(422, "invalid_email", "person has no valid authoritative email");
+  }
+  const decision = body.decision ?? "waive_interview";
+  if (decision !== "waive_interview" && decision !== "require_interview") {
+    return reject4(422, "invalid_decision", "decision must be waive_interview or require_interview");
+  }
+  const note = typeof body.note === "string" ? body.note.trim() : "";
+  if (note.length > MAX_NOTE2) return reject4(422, "invalid_note", "note is too long");
+  const expiresAt = body.expiresAt == null ? void 0 : Number(body.expiresAt);
+  if (expiresAt !== void 0 && (!Number.isFinite(expiresAt) || expiresAt <= Date.now())) {
+    return reject4(422, "invalid_expiry", "expiresAt must be a future epoch timestamp");
+  }
+  try {
+    const saved = await persistLeaderAdmissionDesiredSet({
+      db,
+      ctx,
+      env,
+      target,
+      personId,
+      decision,
+      ...note ? { note } : {},
+      ...expiresAt !== void 0 ? { expiresAt } : {},
+      active: url.pathname !== REVOKE_PATH,
+      mutationId,
+      actor: auth.user.email ?? auth.user.userId
+    });
+    const delivery = await deliverSaved(db, env, ctx, target, saved.delivery);
+    return json({ ok: true, duplicate: saved.duplicate, delivery }, delivery.status === "acknowledged" ? 200 : 202);
+  } catch (error) {
+    if (error instanceof Error && error.message === "mutation_conflict") {
+      return reject4(409, "mutation_conflict", "mutationId was already used for another request");
+    }
+    if (error instanceof Error && /valid authoritative email/.test(error.message)) {
+      return reject4(422, "invalid_email", error.message);
+    }
+    return reject4(409, "revision_conflict", "admission assignments changed; reload and retry");
+  }
+};
+async function retryLeaderAdmissionDeliveries(env, ctx, limit = 100) {
+  const db = ctx.makeDb(env);
+  const result = await db.query({ leaderAdmissionDeliveries: { $: { limit } } });
+  const pending = admissionRows(result.leaderAdmissionDeliveries).filter((delivery) => delivery.status !== "acknowledged" && delivery.status !== "rejected").slice(0, Math.max(1, Math.min(limit, 500)));
+  const delivered = [];
+  for (const item of pending) {
+    const target = targetFor(ctx, item.targetId);
+    if (target) delivered.push(await deliverSaved(db, env, ctx, target, item));
+  }
+  return delivered;
+}
+
 // src/worker-routes-schedule.ts
 import { computeBookableSlots, initCalendar } from "@odla-ai/calendar";
 function errCode(err) {
@@ -4517,16 +4886,16 @@ var crmDeps2 = (db, ctx) => ({
 });
 var handleAdminCrmSync = async (req, url, env, ctx) => {
   if (req.method !== "POST" || url.pathname !== "/api/admin/crm/sync") return null;
-  const gate9 = await adminGate(req, env, ctx);
-  if (gate9 instanceof Response) return gate9;
-  const result = await backfillCrm(crmDeps2(gate9.db, ctx));
+  const gate10 = await adminGate(req, env, ctx);
+  if (gate10 instanceof Response) return gate10;
+  const result = await backfillCrm(crmDeps2(gate10.db, ctx));
   return json({ ok: true, ...result });
 };
 var handleAdminPeople = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/people") return null;
-  const gate9 = await adminGate(req, env, ctx);
-  if (gate9 instanceof Response) return gate9;
-  const { db } = gate9;
+  const gate10 = await adminGate(req, env, ctx);
+  if (gate10 instanceof Response) return gate10;
+  const { db } = gate10;
   const sk = await getVaultSecret(db, "clerk_secret_key");
   const [data, roleList] = await Promise.all([
     db.query({
@@ -4579,9 +4948,9 @@ var handleAdminPeople = async (req, url, env, ctx) => {
 };
 var handleAdminPeopleAccess = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/people/access") return null;
-  const gate9 = await adminGate(req, env, ctx);
-  if (gate9 instanceof Response) return gate9;
-  const { db } = gate9;
+  const gate10 = await adminGate(req, env, ctx);
+  if (gate10 instanceof Response) return gate10;
+  const { db } = gate10;
   const targetId = url.searchParams.get("userId") ?? "";
   if (!targetId.startsWith("user_")) return json({ error: "invalid userId" }, 400);
   const sk = await getVaultSecret(db, "clerk_secret_key");
@@ -4592,9 +4961,9 @@ var handleAdminPeopleAccess = async (req, url, env, ctx) => {
 };
 var handleAdminPeopleRole = async (req, url, env, ctx) => {
   if (req.method !== "POST" || url.pathname !== "/api/admin/people/role") return null;
-  const gate9 = await adminGate(req, env, ctx);
-  if (gate9 instanceof Response) return gate9;
-  const { db, actor } = gate9;
+  const gate10 = await adminGate(req, env, ctx);
+  if (gate10 instanceof Response) return gate10;
+  const { db, actor } = gate10;
   let body;
   try {
     body = await req.json();
@@ -4741,7 +5110,7 @@ function subAnnualCents(sub) {
 }
 
 // src/worker-routes-admin-dashboard.ts
-async function gate2(req, env, ctx) {
+async function gate3(req, env, ctx) {
   const rawDb = ctx.makeDb(env);
   const u = await ctx.verifyUser(req, env);
   if (!u) return json({ error: "unauthorized" }, 401);
@@ -4751,7 +5120,7 @@ async function gate2(req, env, ctx) {
 var rows3 = (v) => Array.isArray(v) ? v : [];
 var handleAdminDashboard = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/dashboard") return null;
-  const got = await gate2(req, env, ctx);
+  const got = await gate3(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const now = Date.now();
@@ -4834,7 +5203,7 @@ var handleAdminDashboard = async (req, url, env, ctx) => {
 };
 var handleAdminBilling = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/billing") return null;
-  const got = await gate2(req, env, ctx);
+  const got = await gate3(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const sk = await getVaultSecret(db, "stripe_secret_key");
@@ -4894,7 +5263,7 @@ var handleAdminBilling = async (req, url, env, ctx) => {
 
 // src/worker-routes-admin-lifecycle.ts
 import { computeBookableSlots as computeBookableSlots2, initCalendar as initCalendar3 } from "@odla-ai/calendar";
-async function gate3(req, env, ctx) {
+async function gate4(req, env, ctx) {
   const rawDb = ctx.makeDb(env);
   const u = await ctx.verifyUser(req, env);
   if (!u) return json({ error: "unauthorized" }, 401);
@@ -4920,7 +5289,7 @@ async function loadGroup(db, id) {
 var handleAdminMeetingReschedule = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/meetings\/([0-9a-f-]+)\/reschedule$/);
   if (req.method !== "POST" || !m) return null;
-  const got = await gate3(req, env, ctx);
+  const got = await gate4(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const body = await readJson(req);
@@ -4961,7 +5330,7 @@ var handleAdminMeetingReschedule = async (req, url, env, ctx) => {
 var handleAdminMeetingCancel = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/meetings\/([0-9a-f-]+)\/cancel$/);
   if (req.method !== "POST" || !m) return null;
-  const got = await gate3(req, env, ctx);
+  const got = await gate4(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const { meetings } = await db.query({ meetings: { $: { where: { id: m[1] }, limit: 1 } } });
@@ -4984,7 +5353,7 @@ var handleAdminMeetingCancel = async (req, url, env, ctx) => {
 var handleAdminApprove = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/applications\/([0-9a-f-]+)\/approve$/);
   if (req.method !== "POST" || !m) return null;
-  const got = await gate3(req, env, ctx);
+  const got = await gate4(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const id = m[1];
@@ -4997,7 +5366,7 @@ var handleAdminApprove = async (req, url, env, ctx) => {
 var handleAdminRefund = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/applications\/([0-9a-f-]+)\/refund$/);
   if (req.method !== "POST" || !m) return null;
-  const got = await gate3(req, env, ctx);
+  const got = await gate4(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const app = await loadApp(db, m[1]);
@@ -5029,7 +5398,7 @@ var handleAdminRefund = async (req, url, env, ctx) => {
 var handleAdminApplicationPatch = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/applications\/([0-9a-f-]+)$/);
   if (req.method !== "PATCH" || !m) return null;
-  const got = await gate3(req, env, ctx);
+  const got = await gate4(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const id = m[1];
@@ -5057,7 +5426,7 @@ var handleAdminApplicationPatch = async (req, url, env, ctx) => {
 };
 
 // src/worker-routes-admin-comms.ts
-async function gate4(req, env, ctx) {
+async function gate5(req, env, ctx) {
   const rawDb = ctx.makeDb(env);
   const u = await ctx.verifyUser(req, env);
   if (!u) return json({ error: "unauthorized" }, 401);
@@ -5079,7 +5448,7 @@ var notifyDeps = (db, env) => ({
 });
 var handleAdminGroupEmail = async (req, url, env, ctx) => {
   if (url.pathname !== "/api/admin/group/email" || req.method !== "GET" && req.method !== "PUT") return null;
-  const got = await gate4(req, env, ctx);
+  const got = await gate5(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const group = await loadGroup2(db, ctx.chapter.id);
@@ -5141,7 +5510,7 @@ var handleAdminGroupEmail = async (req, url, env, ctx) => {
 };
 var handleAdminEmailLog = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/email/log") return null;
-  const got = await gate4(req, env, ctx);
+  const got = await gate5(req, env, ctx);
   if (got instanceof Response) return got;
   const { emailLog } = await got.query({ emailLog: { $: { order: { sentAt: "desc" }, limit: 50 } } });
   const sends = (emailLog ?? []).map((r) => ({
@@ -5158,7 +5527,7 @@ var handleAdminEmailLog = async (req, url, env, ctx) => {
 };
 var handleAdminEmailTest = async (req, url, env, ctx) => {
   if (req.method !== "POST" || url.pathname !== "/api/admin/email/test") return null;
-  const got = await gate4(req, env, ctx);
+  const got = await gate5(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   let body;
@@ -5186,7 +5555,7 @@ var handleAdminEmailTest = async (req, url, env, ctx) => {
 var handleAdminComms = async (req, url, env, ctx) => {
   const m = url.pathname.match(/^\/api\/admin\/people\/([0-9a-fA-F-]+)\/comms$/);
   if (req.method !== "GET" || !m) return null;
-  const got = await gate4(req, env, ctx);
+  const got = await gate5(req, env, ctx);
   if (got instanceof Response) return got;
   const db = got;
   const appId = m[1];
@@ -5224,26 +5593,12 @@ var handleAdminComms = async (req, url, env, ctx) => {
 };
 
 // src/worker-routes-network.ts
-import { getRecord, typeSummary } from "@odla-ai/crm";
-import { signFederatedRequest as signFederatedRequest2, verifyFederatedRequest as verifyFederatedRequest5 } from "@odla-ai/db";
-
-// src/worker-network-fetch.ts
-function targetFetcher(env, target) {
-  if (!target.binding) return null;
-  const candidate = env[target.binding];
-  if (typeof candidate !== "object" || candidate === null || !("fetch" in candidate) || typeof candidate.fetch !== "function") {
-    throw new Error(`service binding "${target.binding}" is unavailable`);
-  }
-  return candidate;
-}
-function fetchNetworkTarget(env, target, destination, init) {
-  const binding = targetFetcher(env, target);
-  return binding ? binding.fetch(new Request(destination, init)) : globalThis.fetch(destination, init);
-}
+import { getRecord as getRecord3, typeSummary } from "@odla-ai/crm";
+import { signFederatedRequest as signFederatedRequest3, verifyFederatedRequest as verifyFederatedRequest5 } from "@odla-ai/db";
 
 // src/worker-network-push.ts
 import { recordDeliveryAttempt } from "@odla-ai/crm";
-import { signFederatedRequest } from "@odla-ai/db";
+import { signFederatedRequest as signFederatedRequest2 } from "@odla-ai/db";
 async function pushNetworkRecord(db, env, ctx, target, record4) {
   const secret = await getVaultSecret(db, target.secretName);
   const crmDeps3 = {
@@ -5277,7 +5632,7 @@ async function pushNetworkRecord(db, env, ctx, target, record4) {
   const payloadBody = JSON.stringify(payload);
   const destination = new URL("/api/network/shared", target.url);
   try {
-    const signed = await signFederatedRequest({
+    const signed = await signFederatedRequest2({
       secret,
       sender: ctx.chapter.id,
       method: "POST",
@@ -5336,7 +5691,7 @@ async function pushNetworkRecord(db, env, ctx, target, record4) {
 }
 
 // src/worker-routes-network.ts
-async function gate5(req, env, ctx) {
+async function gate6(req, env, ctx) {
   const db = ctx.makeDb(env);
   const user = await ctx.verifyUser(req, env);
   if (!user) return { response: json({ error: "unauthorized" }, 401) };
@@ -5345,15 +5700,25 @@ async function gate5(req, env, ctx) {
 }
 var handleAdminNetworkTargets = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/network/targets") return null;
-  const got = await gate5(req, env, ctx);
+  const got = await gate6(req, env, ctx);
   if ("response" in got) return got.response;
   return json({
-    targets: ctx.chapter.network.targets.map(({ id, name, url: targetUrl, fields, sharedNotes }) => ({
+    targets: ctx.chapter.network.targets.map(({
+      id,
+      name,
+      url: targetUrl,
+      fields,
+      sharedNotes,
+      editableFields,
+      stageTransitions
+    }) => ({
       id,
       name,
       url: targetUrl,
       types: Object.keys(fields ?? DEFAULT_SHARE_FIELDS),
-      sharedNotes
+      sharedNotes,
+      editableFields,
+      stageTransitions
     }))
   });
 };
@@ -5380,7 +5745,7 @@ async function snapshotOne(db, env, ctx, target) {
   if (!secret) return { id: target.id, name: target.name, url: target.url, available: false, error: "edge secret is missing" };
   const destination = new URL("/api/network/snapshot", target.url);
   try {
-    const headers = await signFederatedRequest2({
+    const headers = await signFederatedRequest3({
       secret,
       sender: ctx.chapter.id,
       method: "GET",
@@ -5421,7 +5786,7 @@ async function snapshotOne(db, env, ctx, target) {
 }
 var handleAdminNetworkRollup = async (req, url, env, ctx) => {
   if (req.method !== "GET" || url.pathname !== "/api/admin/network/rollup") return null;
-  const got = await gate5(req, env, ctx);
+  const got = await gate6(req, env, ctx);
   if ("response" in got) return got.response;
   const targets = await Promise.all(
     ctx.chapter.network.targets.map((target) => snapshotOne(got.db, env, ctx, target))
@@ -5448,7 +5813,7 @@ var handleAdminNetworkRollup = async (req, url, env, ctx) => {
 };
 var handleAdminNetworkPush = async (req, url, env, ctx) => {
   if (req.method !== "POST" || url.pathname !== "/api/admin/network/push") return null;
-  const got = await gate5(req, env, ctx);
+  const got = await gate6(req, env, ctx);
   if ("response" in got) return got.response;
   let body;
   try {
@@ -5463,7 +5828,7 @@ var handleAdminNetworkPush = async (req, url, env, ctx) => {
   if (requested.size !== body.targetIds.length) return json({ error: "targetIds must contain unique strings" }, 400);
   const targets = ctx.chapter.network.targets.filter((target) => requested.has(target.id));
   if (targets.length !== requested.size) return json({ error: "one or more targetIds are not configured" }, 400);
-  const record4 = await getRecord({ crm: ctx.chapter.crm, db: got.db }, body.recordId);
+  const record4 = await getRecord3({ crm: ctx.chapter.crm, db: got.db }, body.recordId);
   if (!record4) return json({ error: "record not found" }, 404);
   const results = await Promise.all(
     targets.map((target) => pushNetworkRecord(got.db, env, ctx, target, record4))
@@ -5471,19 +5836,20 @@ var handleAdminNetworkPush = async (req, url, env, ctx) => {
   return json({ ok: results.every((result) => result.ok), results });
 };
 
-// src/worker-routes-network-records.ts
-import { listRecords } from "@odla-ai/crm";
-import { signFederatedRequest as signFederatedRequest3, verifyFederatedRequest as verifyFederatedRequest6 } from "@odla-ai/db";
+// src/worker-routes-network-records-follower.ts
+import { CRM_NS, CrmInputError, getRecord as getRecord4, listRecords, setStage as setStage2, updateRecord as updateRecord3 } from "@odla-ai/crm";
+import { verifyFederatedRequest as verifyFederatedRequest6 } from "@odla-ai/db";
+
+// src/worker-routes-network-records-common.ts
 var IDENTIFIER = /^[a-z][a-zA-Z0-9_]*$/;
 var MAX_PAGE = 50;
 var MAX_OFFSET = 1e4;
 var MAX_SEARCH = 200;
-async function gate6(req, env, ctx) {
-  const db = ctx.makeDb(env);
-  const user = await ctx.verifyUser(req, env);
-  if (!user) return { response: json({ error: "unauthorized" }, 401) };
-  if (!await ctx.isAdmin(db, user)) return { response: json({ error: "forbidden" }, 403) };
-  return { db, user };
+var MAX_BODY = 32768;
+var RECORD_ID = /^[a-zA-Z0-9][a-zA-Z0-9:_-]{0,191}$/;
+var MUTATION_ID2 = /^[a-zA-Z0-9][a-zA-Z0-9:._-]{7,127}$/;
+function bodyTooLarge(body) {
+  return new TextEncoder().encode(body).byteLength > MAX_BODY;
 }
 function integer(value, fallback, min, max) {
   if (value == null || value === "") return fallback;
@@ -5491,10 +5857,22 @@ function integer(value, fallback, min, max) {
   const parsed = Number(value);
   return Number.isSafeInteger(parsed) && parsed >= min && parsed <= max ? parsed : null;
 }
-function projectRecord(record4, allowed2) {
+function projectRecord(record4, allowed2, editable, stagesEnabled, crm) {
   const fields = Object.fromEntries(
     allowed2.flatMap((name) => Object.prototype.hasOwnProperty.call(record4.fields, name) ? [[name, record4.fields[name]]] : [])
   );
+  const def = crm.type(record4.type);
+  const editFields = editable.map((id) => {
+    const field = def.fields[id];
+    return {
+      id,
+      label: field.label ?? id,
+      type: field.type,
+      required: field.required ?? false,
+      ...field.options ? { options: field.options } : {}
+    };
+  });
+  const allowedStages = stagesEnabled ? (def.pipeline?.stages ?? []).flatMap((stage) => crm.canTransition(record4.type, record4, stage.id) ? [] : [{ id: stage.id, label: stage.label ?? stage.id }]) : [];
   return {
     id: record4.id,
     type: record4.type,
@@ -5502,11 +5880,66 @@ function projectRecord(record4, allowed2) {
     ...record4.stage ? { stage: record4.stage } : {},
     fields,
     createdAt: record4.createdAt,
-    updatedAt: record4.updatedAt
+    updatedAt: record4.updatedAt,
+    revision: record4.updatedAt,
+    ...editFields.length || stagesEnabled ? { edit: { fields: editFields, allowedStages } } : {}
   };
 }
+function readerRecord(record4, reader, crm) {
+  return projectRecord(
+    record4,
+    reader.fields[record4.type] ?? [],
+    reader.editableFields[record4.type] ?? [],
+    reader.stageTransitions.includes(record4.type),
+    crm
+  );
+}
+function restrictedRecord(record4, target) {
+  if (!record4.edit) return record4;
+  const fields = record4.edit.fields.filter((field) => target.editableFields[record4.type]?.includes(field.id));
+  const allowedStages = target.stageTransitions.includes(record4.type) ? record4.edit.allowedStages : [];
+  const edit = fields.length || target.stageTransitions.includes(record4.type) ? { fields, allowedStages } : void 0;
+  return { ...record4, ...edit ? { edit } : { edit: void 0 } };
+}
+
+// src/worker-routes-network-records-follower.ts
+var NETWORK_MUTATION_META = "chapterNetworkMutation";
+function mutationFingerprint(input) {
+  const fields = input.fields ? Object.fromEntries(Object.entries(input.fields).sort(([a], [b]) => a.localeCompare(b))) : void 0;
+  return JSON.stringify({
+    recordId: input.recordId,
+    type: input.type,
+    expectedRevision: input.expectedRevision,
+    expectedStage: input.expectedStage,
+    mutationId: input.mutationId,
+    fields,
+    stage: input.stage,
+    actor: input.actor
+  });
+}
+function mutationError(error) {
+  if (error?.code === "transact_guard_failed") {
+    return json({ error: "record changed since it was reviewed", code: "stale_revision" }, 409);
+  }
+  if (error instanceof CrmInputError) {
+    return json({ error: error.message, code: "invalid_transition_or_fields", ...error.fields ? { fields: error.fields } : {} }, 422);
+  }
+  return json({ error: "follower mutation failed", code: "mutation_failed" }, 500);
+}
+async function priorMutation(db, id) {
+  const result = await db.query({
+    [CRM_NS.activity]: { $: { where: { id }, limit: 1 } }
+  });
+  const row = (result[CRM_NS.activity] ?? [])[0];
+  const meta = row?.meta;
+  const receipt = meta?.[NETWORK_MUTATION_META];
+  return typeof receipt?.fingerprint === "string" ? { fingerprint: receipt.fingerprint } : null;
+}
 var handleNetworkRecords = async (req, url, env, ctx) => {
-  if (req.method !== "GET" || url.pathname !== "/api/network/records") return null;
+  if (url.pathname !== "/api/network/records" || req.method !== "GET" && req.method !== "PATCH") return null;
+  if (req.method === "PATCH" && Number(req.headers.get("content-length") ?? 0) > MAX_BODY) {
+    return json({ error: "mutation body is too large", code: "body_too_large" }, 413);
+  }
   const db = ctx.makeDb(env);
   const secret = await getVaultSecret(db, "network_share_secret");
   const readers = ctx.chapter.network.readers;
@@ -5517,8 +5950,105 @@ var handleNetworkRecords = async (req, url, env, ctx) => {
   });
   if (!verified.ok) return json({ error: "unauthorized", reason: verified.reason }, 401);
   const reader = readers.find((candidate) => candidate.id === verified.sender);
+  if (!reader) return json({ error: "unauthorized" }, 401);
+  if (req.method === "PATCH") {
+    if (bodyTooLarge(verified.body)) {
+      return json({ error: "mutation body is too large", code: "body_too_large" }, 413);
+    }
+    let input;
+    try {
+      input = JSON.parse(verified.body);
+    } catch {
+      return json({ error: "invalid JSON body", code: "invalid_json" }, 422);
+    }
+    const fields = input?.fields;
+    const hasFields = Boolean(fields && typeof fields === "object" && !Array.isArray(fields));
+    const hasStage = typeof input?.stage === "string";
+    const actor = input?.actor;
+    if (!input || !IDENTIFIER.test(input.type) || !RECORD_ID.test(input.recordId) || !Number.isSafeInteger(input.expectedRevision) || input.expectedRevision < 0 || !MUTATION_ID2.test(input.mutationId) || !actor || typeof actor.id !== "string" || !RECORD_ID.test(actor.id) || hasFields === hasStage) {
+      return json({ error: "invalid network mutation", code: "invalid_mutation" }, 422);
+    }
+    const editable = reader.editableFields[input.type];
+    if (hasFields) {
+      const names = Object.keys(fields);
+      if (!editable || names.length === 0 || names.length > 32 || names.some((name) => !editable.includes(name))) {
+        return json({ error: "profile fields are not delegated for this reader", code: "field_forbidden" }, 403);
+      }
+    } else if (!reader.stageTransitions.includes(input.type)) {
+      return json({ error: "stage transitions are not delegated for this reader", code: "stage_forbidden" }, 403);
+    }
+    const activityId = `network-edit:${verified.sender}:${input.mutationId}`;
+    const fingerprint = mutationFingerprint(input);
+    const prior = await priorMutation(db, activityId);
+    if (prior) {
+      if (prior.fingerprint !== fingerprint) {
+        return json({ error: "mutationId was already used for different input", code: "mutation_conflict" }, 409);
+      }
+      const replayed = await getRecord4({ crm: ctx.chapter.crm, db }, input.recordId);
+      if (!replayed || replayed.type !== input.type) return json({ error: "record not found", code: "not_found" }, 404);
+      const result = {
+        version: 1,
+        site: { id: ctx.chapter.id, name: ctx.chapter.name },
+        record: readerRecord(replayed, reader, ctx.chapter.crm),
+        duplicate: true
+      };
+      return json(result);
+    }
+    const record4 = await getRecord4({ crm: ctx.chapter.crm, db }, input.recordId);
+    if (!record4 || record4.type !== input.type) return json({ error: "record not found", code: "not_found" }, 404);
+    if (record4.updatedAt !== input.expectedRevision) {
+      return json({ error: "record changed since it was reviewed", code: "stale_revision" }, 409);
+    }
+    if (hasStage && (input.expectedStage ?? null) !== (record4.stage ?? null)) {
+      return json({ error: "stage changed since it was reviewed", code: "stale_stage" }, 409);
+    }
+    const actorEmail = typeof actor.email === "string" && actor.email.length <= 320 ? actor.email : void 0;
+    const auditMeta = {
+      [NETWORK_MUTATION_META]: {
+        version: 1,
+        sourceId: verified.sender,
+        actorId: actor.id,
+        ...actorEmail ? { actorEmail } : {},
+        mutationId: input.mutationId,
+        fingerprint
+      }
+    };
+    try {
+      const deps = { crm: ctx.chapter.crm, db };
+      const updated = hasFields ? await updateRecord3(deps, {
+        id: record4.id,
+        input: fields,
+        mutationId: activityId,
+        expectedUpdatedAt: input.expectedRevision,
+        audit: {
+          id: activityId,
+          body: `Profile edited remotely by ${verified.sender}`,
+          authorId: `network:${verified.sender}`,
+          meta: auditMeta
+        }
+      }) : await setStage2(deps, {
+        id: record4.id,
+        to: input.stage,
+        authorId: `network:${verified.sender}`,
+        mutationId: activityId,
+        expectedUpdatedAt: input.expectedRevision,
+        expectedStage: input.expectedStage ?? null,
+        activityId,
+        activityMeta: auditMeta
+      });
+      const result = {
+        version: 1,
+        site: { id: ctx.chapter.id, name: ctx.chapter.name },
+        record: readerRecord(updated.record, reader, ctx.chapter.crm),
+        duplicate: updated.duplicate
+      };
+      return json(result);
+    } catch (error) {
+      return mutationError(error);
+    }
+  }
   const type = url.searchParams.get("type") ?? "";
-  const allowed2 = reader?.fields[type];
+  const allowed2 = reader.fields[type];
   if (!IDENTIFIER.test(type) || !allowed2) return json({ error: "record type is not shared with this reader" }, 403);
   const limit = integer(url.searchParams.get("limit"), 25, 1, MAX_PAGE);
   const offset = integer(url.searchParams.get("offset"), 0, 0, MAX_OFFSET);
@@ -5540,14 +6070,24 @@ var handleNetworkRecords = async (req, url, env, ctx) => {
     version: 1,
     site: { id: ctx.chapter.id, name: ctx.chapter.name },
     type,
-    records: page.records.map((record4) => projectRecord(record4, allowed2)),
+    records: page.records.map((record4) => readerRecord(record4, reader, ctx.chapter.crm)),
     total: page.total,
     limit: page.limit,
     offset: page.offset
   };
   return json(response);
 };
-function targetFor(ctx, id) {
+
+// src/worker-routes-network-records-admin.ts
+import { signFederatedRequest as signFederatedRequest4 } from "@odla-ai/db";
+async function gate7(req, env, ctx) {
+  const db = ctx.makeDb(env);
+  const user = await ctx.verifyUser(req, env);
+  if (!user) return { response: json({ error: "unauthorized" }, 401) };
+  if (!await ctx.isAdmin(db, user)) return { response: json({ error: "forbidden" }, 403) };
+  return { db, user };
+}
+function targetFor2(ctx, id) {
   return ctx.chapter.network.targets.find((target) => target.id === id);
 }
 async function readTargetRecords(db, env, ctx, target, query) {
@@ -5556,12 +6096,7 @@ async function readTargetRecords(db, env, ctx, target, query) {
   const destination = new URL("/api/network/records", target.url);
   destination.search = query.toString();
   try {
-    const headers = await signFederatedRequest3({
-      secret,
-      sender: ctx.chapter.id,
-      method: "GET",
-      url: destination
-    });
+    const headers = await signFederatedRequest4({ secret, sender: ctx.chapter.id, method: "GET", url: destination });
     const response = await fetchNetworkTarget(env, target, destination, {
       headers,
       signal: AbortSignal.timeout(1e4)
@@ -5574,18 +6109,93 @@ async function readTargetRecords(db, env, ctx, target, query) {
         error: upstream ?? (response.ok ? "invalid follower record response" : `follower returned ${response.status}`)
       };
     }
-    return { ok: true, page: body };
+    return {
+      ok: true,
+      page: { ...body, records: body.records.map((record4) => restrictedRecord(record4, target)) }
+    };
   } catch (error) {
     return { ok: false, error: error instanceof Error ? error.message : "record read failed" };
   }
 }
+async function mutateTargetRecord(db, env, ctx, target, input) {
+  const fields = input.fields;
+  if (fields) {
+    const allowed2 = target.editableFields[input.type];
+    if (!allowed2 || Object.keys(fields).some((name) => !allowed2.includes(name))) {
+      return json({ error: "profile fields are not enabled for this target", code: "field_forbidden" }, 403);
+    }
+  } else if (!target.stageTransitions.includes(input.type)) {
+    return json({ error: "stage transitions are not enabled for this target", code: "stage_forbidden" }, 403);
+  }
+  const secret = await getVaultSecret(db, target.secretName);
+  if (!secret) return json({ error: "edge secret is missing", code: "edge_unavailable" }, 502);
+  const destination = new URL("/api/network/records", target.url);
+  const body = JSON.stringify(input);
+  try {
+    const headers = await signFederatedRequest4({
+      secret,
+      sender: ctx.chapter.id,
+      method: "PATCH",
+      url: destination,
+      body
+    });
+    const response = await fetchNetworkTarget(env, target, destination, {
+      method: "PATCH",
+      headers: { ...headers, "content-type": "application/json" },
+      body,
+      signal: AbortSignal.timeout(1e4)
+    });
+    const payload = await response.json().catch(() => null);
+    const site = payload && "site" in payload ? payload.site : void 0;
+    if (!response.ok || !payload || !("record" in payload) || site && site.id !== target.id) {
+      const status = [401, 403, 404, 409, 422].includes(response.status) ? response.status : 502;
+      return json({
+        error: payload && "error" in payload && typeof payload.error === "string" ? payload.error : `follower returned ${response.status}`,
+        ...payload && "code" in payload && typeof payload.code === "string" ? { code: payload.code } : {}
+      }, status);
+    }
+    return json({ ...payload, record: restrictedRecord(payload.record, target) });
+  } catch {
+    return json({ error: "follower mutation request failed", code: "follower_unavailable" }, 502);
+  }
+}
 var handleAdminNetworkRecords = async (req, url, env, ctx) => {
-  if (req.method !== "GET" || url.pathname !== "/api/admin/network/records") return null;
-  const got = await gate6(req, env, ctx);
+  if (url.pathname !== "/api/admin/network/records" || req.method !== "GET" && req.method !== "PATCH") return null;
+  if (req.method === "PATCH" && Number(req.headers.get("content-length") ?? 0) > MAX_BODY) {
+    return json({ error: "mutation body is too large", code: "body_too_large" }, 413);
+  }
+  const got = await gate7(req, env, ctx);
   if ("response" in got) return got.response;
+  if (req.method === "PATCH") {
+    let input;
+    try {
+      const body = await req.text();
+      if (bodyTooLarge(body)) {
+        return json({ error: "mutation body is too large", code: "body_too_large" }, 413);
+      }
+      input = JSON.parse(body);
+    } catch {
+      return json({ error: "invalid JSON body", code: "invalid_json" }, 422);
+    }
+    const target2 = targetFor2(ctx, input?.targetId);
+    const hasFields = Boolean(input?.fields && typeof input.fields === "object" && !Array.isArray(input.fields));
+    const hasStage = typeof input?.stage === "string";
+    if (!target2 || !IDENTIFIER.test(input.type) || !RECORD_ID.test(input.recordId) || !Number.isSafeInteger(input.expectedRevision) || input.expectedRevision < 0 || !MUTATION_ID2.test(input.mutationId) || hasFields === hasStage) {
+      return json({ error: "invalid network mutation", code: "invalid_mutation" }, 422);
+    }
+    return mutateTargetRecord(got.db, env, ctx, target2, {
+      type: input.type,
+      recordId: input.recordId,
+      expectedRevision: input.expectedRevision,
+      mutationId: input.mutationId,
+      ...input.expectedStage !== void 0 ? { expectedStage: input.expectedStage } : {},
+      ...hasFields ? { fields: input.fields } : { stage: input.stage },
+      actor: { id: got.user.userId, ...got.user.email ? { email: got.user.email } : {} }
+    });
+  }
   const targetId = url.searchParams.get("targetId") ?? "";
   const type = url.searchParams.get("type") ?? "";
-  const target = targetFor(ctx, targetId);
+  const target = targetFor2(ctx, targetId);
   if (!target || !IDENTIFIER.test(type)) return json({ error: "configured targetId and record type are required" }, 400);
   const limit = integer(url.searchParams.get("limit"), 25, 1, MAX_PAGE);
   const offset = integer(url.searchParams.get("offset"), 0, 0, MAX_OFFSET);
@@ -5595,21 +6205,15 @@ var handleAdminNetworkRecords = async (req, url, env, ctx) => {
   }
   const query = new URLSearchParams({ type, limit: String(limit), offset: String(offset) });
   if (search) query.set("search", search);
-  const result = await readTargetRecords(
-    got.db,
-    env,
-    ctx,
-    target,
-    query
-  );
+  const result = await readTargetRecords(got.db, env, ctx, target, query);
   return result.ok ? json(result.page) : json({ error: result.error }, 502);
 };
 
 // src/worker-routes-network-notes.ts
 var IDENTIFIER2 = /^[a-z][a-zA-Z0-9_]*$/;
-var RECORD_ID = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/;
-var MAX_NOTE2 = 4e3;
-async function gate7(req, env, ctx) {
+var RECORD_ID2 = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/;
+var MAX_NOTE3 = 4e3;
+async function gate8(req, env, ctx) {
   const db = ctx.makeDb(env);
   const user = await ctx.verifyUser(req, env);
   if (!user) return { response: json({ error: "unauthorized" }, 401) };
@@ -5621,7 +6225,7 @@ function noteIdentity(url, ctx) {
   const recordType = url.searchParams.get("type") ?? "";
   const recordId = url.searchParams.get("recordId") ?? "";
   const configured = ctx.chapter.network.targets.some((target) => target.id === targetId);
-  if (!configured || !IDENTIFIER2.test(recordType) || !RECORD_ID.test(recordId)) return null;
+  if (!configured || !IDENTIFIER2.test(recordType) || !RECORD_ID2.test(recordId)) return null;
   return {
     targetId,
     recordType,
@@ -5643,7 +6247,7 @@ function asNote(row) {
 }
 var handleAdminNetworkNotes = async (req, url, env, ctx) => {
   if (url.pathname !== "/api/admin/network/notes" || req.method !== "GET" && req.method !== "POST") return null;
-  const got = await gate7(req, env, ctx);
+  const got = await gate8(req, env, ctx);
   if ("response" in got) return got.response;
   const identity = noteIdentity(url, ctx);
   if (!identity) return json({ error: "valid targetId, type, and recordId are required" }, 400);
@@ -5660,7 +6264,7 @@ var handleAdminNetworkNotes = async (req, url, env, ctx) => {
     return json({ notes: (result.networkNotes ?? []).map((row) => asNote(row)) });
   }
   const contentLength = Number(req.headers.get("content-length") ?? 0);
-  if (contentLength > MAX_NOTE2 * 2) return json({ error: "note is too large" }, 413);
+  if (contentLength > MAX_NOTE3 * 2) return json({ error: "note is too large" }, 413);
   let input;
   try {
     input = await req.json();
@@ -5668,7 +6272,7 @@ var handleAdminNetworkNotes = async (req, url, env, ctx) => {
     return json({ error: "invalid JSON body" }, 400);
   }
   const body = typeof input.body === "string" ? input.body.trim() : "";
-  if (!body || body.length > MAX_NOTE2) return json({ error: `note must be 1\u2013${MAX_NOTE2} characters` }, 400);
+  if (!body || body.length > MAX_NOTE3) return json({ error: `note must be 1\u2013${MAX_NOTE3} characters` }, 400);
   const id = crypto.randomUUID();
   const note = {
     id,
@@ -5692,16 +6296,16 @@ var handleAdminNetworkNotes = async (req, url, env, ctx) => {
 // src/worker-routes-network-shared-notes.ts
 import {
   addActivity,
-  CRM_NS,
-  getRecord as getRecord2
+  CRM_NS as CRM_NS2,
+  getRecord as getRecord5
 } from "@odla-ai/crm";
-import { signFederatedRequest as signFederatedRequest4, verifyFederatedRequest as verifyFederatedRequest7 } from "@odla-ai/db";
+import { signFederatedRequest as signFederatedRequest5, verifyFederatedRequest as verifyFederatedRequest7 } from "@odla-ai/db";
 var IDENTIFIER3 = /^[a-z][a-zA-Z0-9_]*$/;
-var RECORD_ID2 = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/;
-var MUTATION_ID = /^[A-Za-z0-9_-]{16,128}$/;
-var MAX_NOTE3 = 4e3;
+var RECORD_ID3 = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/;
+var MUTATION_ID3 = /^[A-Za-z0-9_-]{16,128}$/;
+var MAX_NOTE4 = 4e3;
 var NETWORK_META = "chapterNetwork";
-async function gate8(req, env, ctx) {
+async function gate9(req, env, ctx) {
   const db = ctx.makeDb(env);
   const user = await ctx.verifyUser(req, env);
   if (!user) return { response: json({ error: "unauthorized" }, 401) };
@@ -5724,7 +6328,7 @@ function sharedNote(activity, sourceId) {
 }
 async function listSharedNotes(db, sourceId, recordId) {
   const result = await db.query({
-    [CRM_NS.activity]: {
+    [CRM_NS2.activity]: {
       $: {
         where: {
           and: [
@@ -5737,7 +6341,7 @@ async function listSharedNotes(db, sourceId, recordId) {
       }
     }
   });
-  return (result[CRM_NS.activity] ?? []).flatMap((activity) => {
+  return (result[CRM_NS2.activity] ?? []).flatMap((activity) => {
     const note = sharedNote(activity, sourceId);
     return note ? [note] : [];
   });
@@ -5747,7 +6351,7 @@ function sourceLabel(sourceId) {
 }
 var handleNetworkSharedNotes = async (req, url, env, ctx) => {
   if (url.pathname !== "/api/network/shared-notes" || req.method !== "GET" && req.method !== "POST") return null;
-  if (req.method === "POST" && Number(req.headers.get("content-length") ?? 0) > MAX_NOTE3 * 2) {
+  if (req.method === "POST" && Number(req.headers.get("content-length") ?? 0) > MAX_NOTE4 * 2) {
     return json({ error: "note is too large" }, 413);
   }
   const db = ctx.makeDb(env);
@@ -5762,10 +6366,10 @@ var handleNetworkSharedNotes = async (req, url, env, ctx) => {
   const reader = readers.find((candidate) => candidate.id === verified.sender);
   const recordType = url.searchParams.get("type") ?? "";
   const recordId = url.searchParams.get("recordId") ?? "";
-  if (!IDENTIFIER3.test(recordType) || !RECORD_ID2.test(recordId) || !reader?.sharedNotes.includes(recordType)) {
+  if (!IDENTIFIER3.test(recordType) || !RECORD_ID3.test(recordId) || !reader?.sharedNotes.includes(recordType)) {
     return json({ error: "shared notes are not enabled for this reader and record type" }, 403);
   }
-  const record4 = await getRecord2({ crm: ctx.chapter.crm, db }, recordId);
+  const record4 = await getRecord5({ crm: ctx.chapter.crm, db }, recordId);
   if (!record4 || record4.type !== recordType) return json({ error: "record not found" }, 404);
   if (req.method === "GET") {
     return json({
@@ -5782,8 +6386,8 @@ var handleNetworkSharedNotes = async (req, url, env, ctx) => {
   }
   const body = typeof input.body === "string" ? input.body.trim() : "";
   const mutationId = typeof input.mutationId === "string" ? input.mutationId : "";
-  if (!body || body.length > MAX_NOTE3 || !MUTATION_ID.test(mutationId)) {
-    return json({ error: `body must be 1\u2013${MAX_NOTE3} characters and mutationId must be valid` }, 400);
+  if (!body || body.length > MAX_NOTE4 || !MUTATION_ID3.test(mutationId)) {
+    return json({ error: `body must be 1\u2013${MAX_NOTE4} characters and mutationId must be valid` }, 400);
   }
   const createdAt = Date.now();
   const id = `network:${verified.sender}:${mutationId}`;
@@ -5820,18 +6424,18 @@ var handleNetworkSharedNotes = async (req, url, env, ctx) => {
   };
   return json({ version: 1, site: { id: ctx.chapter.id, name: ctx.chapter.name }, note, duplicate: result.duplicate }, 201);
 };
-function targetFor2(ctx, id) {
+function targetFor3(ctx, id) {
   return ctx.chapter.network.targets.find((target) => target.id === id);
 }
 var handleAdminNetworkSharedNotes = async (req, url, env, ctx) => {
   if (url.pathname !== "/api/admin/network/shared-notes" || req.method !== "GET" && req.method !== "POST") return null;
-  const got = await gate8(req, env, ctx);
+  const got = await gate9(req, env, ctx);
   if ("response" in got) return got.response;
   const targetId = url.searchParams.get("targetId") ?? "";
   const recordType = url.searchParams.get("type") ?? "";
   const recordId = url.searchParams.get("recordId") ?? "";
-  const target = targetFor2(ctx, targetId);
-  if (!target || !target.sharedNotes.includes(recordType) || !IDENTIFIER3.test(recordType) || !RECORD_ID2.test(recordId)) {
+  const target = targetFor3(ctx, targetId);
+  if (!target || !target.sharedNotes.includes(recordType) || !IDENTIFIER3.test(recordType) || !RECORD_ID3.test(recordId)) {
     return json({ error: "configured targetId, type, and recordId are required" }, 400);
   }
   let body = "";
@@ -5843,7 +6447,7 @@ var handleAdminNetworkSharedNotes = async (req, url, env, ctx) => {
       return json({ error: "invalid JSON body" }, 400);
     }
     const note = typeof input.body === "string" ? input.body.trim() : "";
-    if (!note || note.length > MAX_NOTE3) return json({ error: `note must be 1\u2013${MAX_NOTE3} characters` }, 400);
+    if (!note || note.length > MAX_NOTE4) return json({ error: `note must be 1\u2013${MAX_NOTE4} characters` }, 400);
     body = JSON.stringify({ body: note, mutationId: crypto.randomUUID() });
   }
   const secret = await getVaultSecret(got.db, target.secretName);
@@ -5851,7 +6455,7 @@ var handleAdminNetworkSharedNotes = async (req, url, env, ctx) => {
   const destination = new URL("/api/network/shared-notes", target.url);
   destination.search = new URLSearchParams({ type: recordType, recordId }).toString();
   try {
-    const headers = await signFederatedRequest4({
+    const headers = await signFederatedRequest5({
       secret,
       sender: ctx.chapter.id,
       method: req.method,
@@ -6443,11 +7047,11 @@ var handleAdminBuilderLibrary = async (req, url, env, ctx) => {
 };
 
 // src/signup-control-delivery.ts
-import { signFederatedRequest as signFederatedRequest5 } from "@odla-ai/db";
+import { signFederatedRequest as signFederatedRequest6 } from "@odla-ai/db";
 async function deliverSignupControl(options) {
   const destination = new URL(SIGNUP_CONTROL_PATH, options.targetUrl);
   const body = JSON.stringify(options.envelope);
-  const signed = await signFederatedRequest5({
+  const signed = await signFederatedRequest6({
     secret: options.secret,
     sender: options.sender,
     method: "POST",
@@ -6468,11 +7072,11 @@ async function deliverSignupControl(options) {
 }
 
 // src/member-content-delivery.ts
-import { signFederatedRequest as signFederatedRequest6 } from "@odla-ai/db";
+import { signFederatedRequest as signFederatedRequest7 } from "@odla-ai/db";
 async function deliverMemberContent(options) {
   const destination = new URL(MEMBER_CONTENT_CONTROL_PATH, options.targetUrl);
   const body = JSON.stringify(options.envelope);
-  const signed = await signFederatedRequest6({
+  const signed = await signFederatedRequest7({
     secret: options.secret,
     sender: options.sender,
     method: "POST",
@@ -6493,11 +7097,11 @@ async function deliverMemberContent(options) {
 }
 
 // src/builder-library-delivery.ts
-import { signFederatedRequest as signFederatedRequest7 } from "@odla-ai/db";
+import { signFederatedRequest as signFederatedRequest8 } from "@odla-ai/db";
 async function deliverBuilderLibrary(options) {
   const destination = new URL(BUILDER_LIBRARY_CONTROL_PATH, options.targetUrl);
   const body = JSON.stringify(options.envelope);
-  const signed = await signFederatedRequest7({ secret: options.secret, sender: options.sender, method: "POST", url: destination, body });
+  const signed = await signFederatedRequest8({ secret: options.secret, sender: options.sender, method: "POST", url: destination, body });
   const response = await (options.fetch ?? globalThis.fetch)(destination, { method: "POST", headers: { ...signed, "content-type": "application/json" }, body });
   const result = await response.json();
   if (!response.ok || !("ok" in result) || result.ok !== true) {
@@ -6507,31 +7111,6 @@ async function deliverBuilderLibrary(options) {
   return result;
 }
 
-// src/admission-grants-delivery.ts
-import { signFederatedRequest as signFederatedRequest8 } from "@odla-ai/db";
-async function deliverAdmissionGrants(options) {
-  const destination = new URL(ADMISSION_GRANTS_PATH, options.targetUrl);
-  const body = JSON.stringify(options.envelope);
-  const signed = await signFederatedRequest8({
-    secret: options.secret,
-    sender: options.sender,
-    method: "POST",
-    url: destination,
-    body
-  });
-  const response = await (options.fetch ?? globalThis.fetch)(destination, {
-    method: "POST",
-    headers: { ...signed, "content-type": "application/json" },
-    body
-  });
-  const result = await response.json();
-  if (!response.ok || !("ok" in result) || result.ok !== true) {
-    const failure = result;
-    throw new Error(`admission grants rejected (${response.status}): ${failure.reason ?? failure.error ?? "unknown"}`);
-  }
-  return result;
-}
-
 // src/signup-control-theme.ts
 var SIGNUP_CONTROL_THEME_MARKER = "<!--odla:signup-control-theme-->";
 var SIGNUP_CONTROL_THEME_STYLE_ID = "odla-signup-control-theme";
@@ -6691,6 +7270,7 @@ var BUILTIN_ROUTES = [
   handleAdminPeopleRole,
   handleAdminCrmSync,
   handleAdminAdmissionGrants,
+  handleAdminNetworkAdmissions,
   handleAdminClerkPrivateProfileSync,
   // Aggregation
   handleAdminDashboard,
@@ -6735,6 +7315,7 @@ function chapterWorker(options) {
   };
 }
 export {
+  AdmissionGrantDeliveryError,
   chapterWorker,
   createWorkerContext,
   deliverAdmissionGrants,
@@ -6742,6 +7323,7 @@ export {
   deliverMemberContent,
   deliverSignupControl,
   renderActiveSignupControlHtml,
+  retryLeaderAdmissionDeliveries,
   withActiveSignupControlTheme
 };
 //# sourceMappingURL=index.js.map