@tablation/crew 0.39.1 → 0.40.0

package/dist/cli.js

@@ -6642,9 +6642,9 @@ var alreadyReported = (ticket, g, comments) => comments.some((c) => c.ticket_id
 
 // src/agent.ts
 import { spawn as spawn2 } from "child_process";
-import { readFileSync as readFileSync9, existsSync as existsSync10, statSync as statSync5, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7, createWriteStream } from "fs";
+import { readFileSync as readFileSync10, existsSync as existsSync11, statSync as statSync5, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7, createWriteStream } from "fs";
 import { finished } from "stream/promises";
-import { join as join11, dirname as dirname6 } from "path";
+import { join as join12, dirname as dirname6 } from "path";
 import { createHash as createHash2 } from "crypto";
 
 // src/environment.ts
@@ -7033,33 +7033,144 @@ function expandSkillMarkers(text, lookup, opts = {}) {
 }
 
 // src/skills.ts
-import { readFileSync as readFileSync8, readdirSync as readdirSync2, existsSync as existsSync9 } from "fs";
-import { join as join10 } from "path";
+import { readFileSync as readFileSync9, readdirSync as readdirSync2, existsSync as existsSync10 } from "fs";
+import { join as join11 } from "path";
 import { parse as parseYaml } from "yaml";
+import { TablationClient as TablationClient3, StaleWriteError as StaleWriteError7, TablationApiError as TablationApiError2 } from "@tablation/client";
+
+// src/agents.ts
+import { readFileSync as readFileSync8, existsSync as existsSync9 } from "fs";
+import { join as join10 } from "path";
 import { TablationClient as TablationClient2, StaleWriteError as StaleWriteError6, TablationApiError } from "@tablation/client";
-var SkillSyncError = class extends Error {
+var PERSONA_NAME = {
+  dev: "Developer",
+  design: "Design",
+  qa: "QA",
+  triage: "Triage",
+  pair: "Pair"
 };
-function parseSkillFile(path) {
-  const text = readFileSync8(path, "utf8");
-  const match = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/.exec(text);
-  if (!match) throw new SkillSyncError(`${path}: missing YAML frontmatter (expected a leading --- block)`);
-  const frontmatter = match[1];
-  const body = match[2];
-  const meta = parseYaml(frontmatter);
-  if (typeof meta.name !== "string" || !meta.name) throw new SkillSyncError(`${path}: frontmatter is missing "name"`);
-  if (typeof meta.description !== "string" || !meta.description) {
-    throw new SkillSyncError(`${path}: frontmatter is missing "description"`);
+var CREW_AGENT_FIELD_NAME = "Agent";
+var CREW_AGENT_COLUMN = "agent_id";
+var AgentsSyncError = class extends Error {
+};
+function personaDefaultPrompt(promptsDir, role) {
+  const briefPath = join10(promptsDir, "personas", `lane-${role}.md`);
+  if (!existsSync9(briefPath)) throw new AgentsSyncError(`no brief at ${briefPath}`);
+  if (SELF_CONTAINED_ROLES.has(role)) return readFileSync8(briefPath, "utf8");
+  const commonPath = join10(promptsDir, "personas", "common.md");
+  if (!existsSync9(commonPath)) return readFileSync8(briefPath, "utf8");
+  return `${readFileSync8(commonPath, "utf8")}${readFileSync8(briefPath, "utf8")}`;
+}
+async function resolveAgentId(route, role, opts) {
+  const cached = route.resolved?.agentPersonas?.[role]?.agentId;
+  if (cached) return cached;
+  const seatId = route.resolved?.seats?.[role];
+  if (!seatId || !route.resolved) return void 0;
+  const client2 = new TablationClient2({
+    baseUrl: `${route.baseUrl}/api`,
+    apiKey: resolveApiKey(route),
+    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
+  });
+  try {
+    const row = await client2.records.get(route.resolved.models.crew, seatId);
+    return row.agent_id ?? void 0;
+  } catch {
+    return void 0;
   }
-  return { name: meta.name, description: meta.description, prompt: body, file: path };
 }
-function listLocalSkills(promptsDir) {
-  const dir = join10(promptsDir, "skills");
-  if (!existsSync9(dir)) return [];
-  return readdirSync2(dir).filter((f) => f.endsWith(".md")).map((f) => parseSkillFile(join10(dir, f)));
+async function fetchDivergedPrompt(route, role, opts) {
+  const agentId = await resolveAgentId(route, role, opts);
+  if (!agentId || !route.resolved) return void 0;
+  const client2 = new TablationClient2({
+    baseUrl: `${route.baseUrl}/api`,
+    apiKey: resolveApiKey(route),
+    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
+  });
+  let row;
+  let agentsModelId;
+  try {
+    const agentsModel = await client2.dataModels.get("agents", route.resolved.workspaceId);
+    agentsModelId = agentsModel.id;
+    row = await client2.records.get(agentsModelId, agentId);
+  } catch {
+    return void 0;
+  }
+  const defaultPrompt = personaDefaultPrompt(route.promptsDir, role);
+  if (row.prompt === defaultPrompt) return void 0;
+  const cached = route.resolved.agentPersonas?.[role];
+  if (cached?.agentId === agentId && cached.historyId) {
+    const lastSynced = await fetchLastSyncedPrompt(route, agentsModelId, agentId, cached.historyId, opts.userAgent);
+    if (lastSynced !== void 0 && lastSynced === row.prompt) return void 0;
+  }
+  return row.prompt;
 }
-async function syncSkills(route, opts) {
+async function fetchLastSyncedPrompt(route, agentsModelId, recordId, historyId, userAgent) {
+  try {
+    const entries = await fetchHistoryEntries(route, agentsModelId, recordId, userAgent);
+    return entries.find((e) => e.history_id === historyId)?.prompt;
+  } catch {
+    return void 0;
+  }
+}
+function choiceValue(v) {
+  const raw = typeof v === "string" ? v : v && typeof v === "object" ? v.value ?? v.key : void 0;
+  return typeof raw === "string" && raw.trim() ? raw.trim().toLowerCase() : void 0;
+}
+async function fetchSeatPersona(route, role, opts) {
+  const agentId = await resolveAgentId(route, role, opts);
+  if (!agentId || !route.resolved) return void 0;
+  const client2 = new TablationClient2({
+    baseUrl: `${route.baseUrl}/api`,
+    apiKey: resolveApiKey(route),
+    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
+  });
+  try {
+    const agentsModel = await client2.dataModels.get("agents", route.resolved.workspaceId);
+    const row = await client2.records.get(agentsModel.id, agentId);
+    const tier = choiceValue(row.tier);
+    const vendor = choiceValue(row.vendor);
+    const persona = {
+      ...row.model ? { model: row.model } : {},
+      ...tier && TIERS.includes(tier) ? { tier } : {},
+      ...vendor ? { vendor } : {}
+    };
+    return Object.keys(persona).length > 0 ? persona : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function currentPersonaPrompt(route, role, opts) {
+  const diverged = await fetchDivergedPrompt(route, role, opts);
+  return diverged ?? personaDefaultPrompt(route.promptsDir, role);
+}
+async function fetchHistoryEntries(route, agentsModelId, recordId, userAgent, limit = 50) {
+  const url = `${route.baseUrl.replace(/\/+$/, "")}/api/data-models/${agentsModelId}/records/${recordId}/history?limit=${limit}`;
+  const res = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${resolveApiKey(route)}`,
+      "User-Agent": userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0"
+    }
+  });
+  if (!res.ok) throw new AgentsSyncError(`history lookup for ${recordId}: ${res.status} ${res.statusText}`);
+  return await res.json();
+}
+async function fetchLatestHistoryId(route, agentsModelId, recordId, userAgent) {
+  try {
+    const entries = await fetchHistoryEntries(route, agentsModelId, recordId, userAgent, 1);
+    return entries[0]?.history_id;
+  } catch {
+    return void 0;
+  }
+}
+function promptSourceFields(model, prompt) {
+  return model.fields?.some((f) => f.columnName === "prompt_baseline") ? { prompt_source: "crew", prompt_baseline: prompt } : {};
+}
+function isPromptGateRejection(e) {
+  return e instanceof TablationApiError && e.status === 422;
+}
+async function syncPersonas(route, opts) {
   if (!route.resolved) {
-    throw new SkillSyncError(`route "${route.route}" has no resolved ids \u2014 run \`crew connect\` first`);
+    throw new AgentsSyncError(`route "${route.route}" has no resolved ids \u2014 run \`crew connect\` first`);
   }
   const workspaceId = route.resolved.workspaceId;
   const client2 = new TablationClient2({
@@ -7067,100 +7178,344 @@ async function syncSkills(route, opts) {
     apiKey: resolveApiKey(route),
     headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
   });
-  let skillsModel;
+  let agentsModel;
   try {
-    skillsModel = await client2.dataModels.get("agent_skills", workspaceId);
+    agentsModel = await client2.dataModels.get("agents", workspaceId);
   } catch (e) {
     if (e instanceof TablationApiError && e.status === 404) {
-      throw new SkillSyncError(
-        `workspace ${workspaceId} has no Agent Skills table yet \u2014 every workspace auto-provisions one; an older workspace may still need its one-time backfill`
+      throw new AgentsSyncError(
+        `workspace ${workspaceId} has no Agents table yet \u2014 every workspace auto-provisions one (ISSUE-465); an older workspace may still need its one-time backfill`
       );
     }
     throw e;
   }
-  const local = listLocalSkills(route.promptsDir);
-  const rows = await client2.records.list(skillsModel.id, { limit: 200 });
-  const cache = route.resolved.agentSkills ?? {};
+  const rows = await client2.records.list(agentsModel.id, { limit: 200 });
+  const cache = route.resolved.agentPersonas ?? {};
   const outcomes = [];
-  const agentSkills = { ...cache };
-  for (const skill of local) {
-    const row = rows.find((r) => r.name === skill.name);
+  const agentPersonas = { ...cache };
+  for (const role of ROLE_NAMES) {
+    const name = PERSONA_NAME[role];
+    const defaultPrompt = personaDefaultPrompt(route.promptsDir, role);
+    const row = rows.find((r) => r.name === name);
     if (!row) {
       if (opts.dryRun) {
-        outcomes.push({ name: skill.name, action: "created", skillId: "(dry run)" });
+        outcomes.push({ role, action: "created", agentId: "(dry run)" });
         continue;
       }
-      const created = await client2.records.create(skillsModel.id, {
-        name: skill.name,
-        description: skill.description,
-        prompt: skill.prompt
-      });
-      agentSkills[skill.name] = { skillId: created.id, lastSyncedUpdatedAt: created.updated_at };
-      outcomes.push({ name: skill.name, action: "created", skillId: created.id });
+      const created = await client2.records.create(agentsModel.id, { name, prompt: defaultPrompt, ...promptSourceFields(agentsModel, defaultPrompt) });
+      const historyId = await fetchLatestHistoryId(route, agentsModel.id, created.id, opts.userAgent);
+      agentPersonas[role] = { agentId: created.id, lastSyncedUpdatedAt: created.updated_at, ...historyId ? { historyId } : {} };
+      outcomes.push({ role, action: "created", agentId: created.id });
       continue;
     }
-    if (row.description === skill.description && row.prompt === skill.prompt) {
-      agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: row.updated_at };
-      outcomes.push({ name: skill.name, action: "unchanged", skillId: row.id });
+    if (row.prompt === defaultPrompt) {
+      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
+      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: row.updated_at, ...historyId ? { historyId } : {} };
+      outcomes.push({ role, action: "unchanged", agentId: row.id });
       continue;
     }
-    const knownBaseline = cache[skill.name]?.skillId === row.id ? cache[skill.name]?.lastSyncedUpdatedAt : void 0;
-    if (!knownBaseline) {
-      outcomes.push({ name: skill.name, action: "diverged", skillId: row.id });
+    if (row.prompt_customized === true) {
+      const prior = cache[role]?.agentId === row.id ? cache[role] : void 0;
+      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: row.updated_at, ...prior?.historyId ? { historyId: prior.historyId } : {} };
+      outcomes.push({ role, action: "overridden", agentId: row.id });
+      continue;
+    }
+    if (opts.force) {
+      if (opts.dryRun) {
+        outcomes.push({ role, action: "forced", agentId: row.id, previousPrompt: row.prompt });
+        continue;
+      }
+      let updated;
+      try {
+        updated = await client2.records.update(agentsModel.id, row.id, { prompt: defaultPrompt, ...promptSourceFields(agentsModel, defaultPrompt) });
+      } catch (e) {
+        if (!isPromptGateRejection(e)) throw e;
+        outcomes.push({ role, action: "overridden", agentId: row.id });
+        agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: row.updated_at, ...cache[role]?.agentId === row.id && cache[role]?.historyId ? { historyId: cache[role].historyId } : {} };
+        continue;
+      }
+      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
+      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: updated.updated_at, ...historyId ? { historyId } : {} };
+      outcomes.push({ role, action: "forced", agentId: row.id, previousPrompt: row.prompt });
+      continue;
+    }
+    const cached = cache[role]?.agentId === row.id ? cache[role] : void 0;
+    if (!cached?.historyId) {
+      outcomes.push({ role, action: "diverged", agentId: row.id });
+      continue;
+    }
+    let lastSyncedPrompt;
+    try {
+      const entries = await fetchHistoryEntries(route, agentsModel.id, row.id, opts.userAgent);
+      lastSyncedPrompt = entries.find((e) => e.history_id === cached.historyId)?.prompt;
+    } catch {
+      lastSyncedPrompt = void 0;
+    }
+    if (lastSyncedPrompt === void 0 || lastSyncedPrompt !== row.prompt) {
+      outcomes.push({ role, action: "diverged", agentId: row.id });
       continue;
     }
     if (opts.dryRun) {
-      outcomes.push({ name: skill.name, action: "updated", skillId: row.id });
+      outcomes.push({ role, action: "updated", agentId: row.id });
       continue;
     }
     try {
       const updated = await client2.records.update(
-        skillsModel.id,
+        agentsModel.id,
         row.id,
-        { description: skill.description, prompt: skill.prompt },
-        knownBaseline
+        { prompt: defaultPrompt, ...promptSourceFields(agentsModel, defaultPrompt) },
+        row.updated_at
       );
-      agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: updated.updated_at };
-      outcomes.push({ name: skill.name, action: "updated", skillId: row.id });
+      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
+      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: updated.updated_at, ...historyId ? { historyId } : {} };
+      outcomes.push({ role, action: "updated", agentId: row.id });
     } catch (e) {
       if (e instanceof StaleWriteError6) {
-        outcomes.push({ name: skill.name, action: "diverged", skillId: row.id });
+        outcomes.push({ role, action: "diverged", agentId: row.id });
+        continue;
+      }
+      if (isPromptGateRejection(e)) {
+        agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: row.updated_at, historyId: cached.historyId };
+        outcomes.push({ role, action: "overridden", agentId: row.id });
         continue;
       }
       throw e;
     }
   }
-  return { outcomes, agentSkills };
-}
-function describeSkillSyncOutcome(o) {
-  switch (o.action) {
-    case "created":
-      return `${o.name}: created (${o.skillId})`;
-    case "updated":
-      return `${o.name}: prompt updated from crew's local file`;
-    case "unchanged":
-      return `${o.name}: already in sync`;
-    case "diverged":
-      return `${o.name}: HAS LOCAL EDITS \u2014 crew's default is newer but was NOT applied; review ${o.skillId} in the app before syncing again`;
-  }
+  const crewLinks = opts.dryRun ? [] : await linkCrewSeats(route, client2, agentsModel.id, agentPersonas, opts.userAgent);
+  return { outcomes, agentPersonas, crewLinks };
 }
-async function fetchSkillOverrides(route, opts) {
-  if (!route.resolved) return {};
-  const client2 = new TablationClient2({
-    baseUrl: `${route.baseUrl}/api`,
-    apiKey: resolveApiKey(route),
-    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
-  });
-  let rows;
-  try {
-    const model = await client2.dataModels.get("agent_skills", route.resolved.workspaceId);
-    rows = await client2.records.list(model.id, { limit: 200 });
-  } catch {
-    return {};
+async function linkCrewSeats(route, client2, agentsModelId, agentPersonas, userAgent) {
+  const seats2 = route.resolved.seats;
+  const rolesWithSeats = ROLE_NAMES.filter((role) => seats2[role] && agentPersonas[role]);
+  if (rolesWithSeats.length === 0) {
+    return ROLE_NAMES.map((role) => ({ role, action: seats2[role] ? "persona_diverged" : "no_seat" }));
   }
-  const local = new Map(listLocalSkills(route.promptsDir).map((s) => [s.name, s]));
-  const cache = route.resolved.agentSkills ?? {};
-  const out = {};
+  const crewModelId = route.resolved.models.crew;
+  const crewModel = await client2.dataModels.get(crewModelId);
+  const columnName = await ensureCrewAgentField(route, client2, crewModel, agentsModelId, userAgent);
+  const outcomes = [];
+  for (const role of ROLE_NAMES) {
+    const seatId = seats2[role];
+    const agentId = agentPersonas[role]?.agentId;
+    if (!seatId) {
+      outcomes.push({ role, action: "no_seat" });
+      continue;
+    }
+    if (!agentId) {
+      outcomes.push({ role, action: "persona_diverged" });
+      continue;
+    }
+    const seatRow = await client2.records.get(crewModelId, seatId);
+    if (seatRow[CREW_AGENT_COLUMN] === agentId) {
+      outcomes.push({ role, action: "already_linked" });
+      continue;
+    }
+    await client2.records.update(crewModelId, seatId, { [columnName]: agentId });
+    outcomes.push({ role, action: "linked" });
+  }
+  return outcomes;
+}
+async function ensureCrewAgentField(route, client2, crewModel, agentsModelId, userAgent) {
+  const existing = crewModel.fields.find(
+    (f) => f.fieldType?.kind === "REFERENCE" && f.fieldType.targetModelId === agentsModelId && f.fieldType.isMultiple === false
+  );
+  if (existing) return existing.columnName;
+  const workspaceId = route.resolved.workspaceId;
+  const baseUrl = route.baseUrl.replace(/\/+$/, "");
+  const apiKey = resolveApiKey(route);
+  const headers = { Authorization: `Bearer ${apiKey}`, "User-Agent": userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" };
+  const typesRes = await fetch(`${baseUrl}/api/workspaces/${workspaceId}/field-types`, { headers });
+  if (!typesRes.ok) throw new AgentsSyncError(`field-types lookup failed: ${typesRes.status} ${typesRes.statusText}`);
+  const types = await typesRes.json();
+  const fieldType = types.find((t) => t.kind === "REFERENCE" && t.targetModelId === agentsModelId && t.isMultiple === false);
+  if (!fieldType) {
+    throw new AgentsSyncError(
+      `workspace ${workspaceId} has no single-valued Agents-reference field type \u2014 every table auto-provisions one (see the pseudo-builtin reference types convention); an older Agents table may need its one-time backfill`
+    );
+  }
+  const createRes = await fetch(`${baseUrl}/api/data-models/${crewModel.id}/fields`, {
+    method: "POST",
+    headers: { ...headers, "Content-Type": "application/json" },
+    body: JSON.stringify({
+      name: CREW_AGENT_FIELD_NAME,
+      columnName: CREW_AGENT_COLUMN,
+      fieldTypeId: fieldType.id,
+      description: "The Agents-table row backing this seat's persona \u2014 set by `crew agents sync` (ISSUE-416), never edited by hand."
+    })
+  });
+  if (!createRes.ok) throw new AgentsSyncError(`creating the Crew table's Agent field failed: ${createRes.status} ${createRes.statusText}`);
+  const created = await createRes.json();
+  return created.columnName;
+}
+function describeSyncOutcome(o) {
+  const label = PERSONA_NAME[o.role];
+  switch (o.action) {
+    case "created":
+      return `${label}: created (${o.agentId})`;
+    case "updated":
+      return `${label}: prompt updated from crew's local default`;
+    case "unchanged":
+      return `${label}: already in sync`;
+    case "diverged":
+      return `${label}: HAS LOCAL EDITS \u2014 crew's default is newer but was NOT applied; review ${o.agentId} in the app before syncing again`;
+    case "overridden":
+      return `${label}: override in place \u2014 prompt not synced (clear "Customize prompt" on the Agents row to resume)`;
+    case "forced":
+      return `${label}: --force overwrote local edits (previous prompt was: ${JSON.stringify(o.previousPrompt ?? "")})`;
+  }
+}
+function describeCrewLink(o) {
+  const label = PERSONA_NAME[o.role];
+  switch (o.action) {
+    case "linked":
+      return `${label}: Crew row now references its Agents row`;
+    case "already_linked":
+      return `${label}: Crew row already references its Agents row`;
+    case "no_seat":
+      return `${label}: no seat configured for this role \u2014 skipped linking`;
+    case "persona_diverged":
+      return `${label}: persona has local edits and was not synced this pass \u2014 skipped linking until it's resolved`;
+  }
+}
+
+// src/skills.ts
+var SkillSyncError = class extends Error {
+};
+function parseSkillFile(path) {
+  const text = readFileSync9(path, "utf8");
+  const match = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/.exec(text);
+  if (!match) throw new SkillSyncError(`${path}: missing YAML frontmatter (expected a leading --- block)`);
+  const frontmatter = match[1];
+  const body = match[2];
+  const meta = parseYaml(frontmatter);
+  if (typeof meta.name !== "string" || !meta.name) throw new SkillSyncError(`${path}: frontmatter is missing "name"`);
+  if (typeof meta.description !== "string" || !meta.description) {
+    throw new SkillSyncError(`${path}: frontmatter is missing "description"`);
+  }
+  return { name: meta.name, description: meta.description, prompt: body, file: path };
+}
+function listLocalSkills(promptsDir) {
+  const dir = join11(promptsDir, "skills");
+  if (!existsSync10(dir)) return [];
+  return readdirSync2(dir).filter((f) => f.endsWith(".md")).map((f) => parseSkillFile(join11(dir, f)));
+}
+async function syncSkills(route, opts) {
+  if (!route.resolved) {
+    throw new SkillSyncError(`route "${route.route}" has no resolved ids \u2014 run \`crew connect\` first`);
+  }
+  const workspaceId = route.resolved.workspaceId;
+  const client2 = new TablationClient3({
+    baseUrl: `${route.baseUrl}/api`,
+    apiKey: resolveApiKey(route),
+    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
+  });
+  let skillsModel;
+  try {
+    skillsModel = await client2.dataModels.get("agent_skills", workspaceId);
+  } catch (e) {
+    if (e instanceof TablationApiError2 && e.status === 404) {
+      throw new SkillSyncError(
+        `workspace ${workspaceId} has no Agent Skills table yet \u2014 every workspace auto-provisions one; an older workspace may still need its one-time backfill`
+      );
+    }
+    throw e;
+  }
+  const local = listLocalSkills(route.promptsDir);
+  const rows = await client2.records.list(skillsModel.id, { limit: 200 });
+  const cache = route.resolved.agentSkills ?? {};
+  const outcomes = [];
+  const agentSkills = { ...cache };
+  for (const skill of local) {
+    const row = rows.find((r) => r.name === skill.name);
+    if (!row) {
+      if (opts.dryRun) {
+        outcomes.push({ name: skill.name, action: "created", skillId: "(dry run)" });
+        continue;
+      }
+      const created = await client2.records.create(skillsModel.id, {
+        name: skill.name,
+        description: skill.description,
+        prompt: skill.prompt,
+        ...promptSourceFields(skillsModel, skill.prompt)
+      });
+      agentSkills[skill.name] = { skillId: created.id, lastSyncedUpdatedAt: created.updated_at };
+      outcomes.push({ name: skill.name, action: "created", skillId: created.id });
+      continue;
+    }
+    if (row.description === skill.description && row.prompt === skill.prompt) {
+      agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: row.updated_at };
+      outcomes.push({ name: skill.name, action: "unchanged", skillId: row.id });
+      continue;
+    }
+    if (row.prompt_customized === true) {
+      agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: row.updated_at };
+      outcomes.push({ name: skill.name, action: "overridden", skillId: row.id });
+      continue;
+    }
+    const knownBaseline = cache[skill.name]?.skillId === row.id ? cache[skill.name]?.lastSyncedUpdatedAt : void 0;
+    if (!knownBaseline) {
+      outcomes.push({ name: skill.name, action: "diverged", skillId: row.id });
+      continue;
+    }
+    if (opts.dryRun) {
+      outcomes.push({ name: skill.name, action: "updated", skillId: row.id });
+      continue;
+    }
+    try {
+      const updated = await client2.records.update(
+        skillsModel.id,
+        row.id,
+        { description: skill.description, prompt: skill.prompt, ...promptSourceFields(skillsModel, skill.prompt) },
+        knownBaseline
+      );
+      agentSkills[skill.name] = { skillId: row.id, lastSyncedUpdatedAt: updated.updated_at };
+      outcomes.push({ name: skill.name, action: "updated", skillId: row.id });
+    } catch (e) {
+      if (e instanceof StaleWriteError7) {
+        outcomes.push({ name: skill.name, action: "diverged", skillId: row.id });
+        continue;
+      }
+      if (isPromptGateRejection(e)) {
+        outcomes.push({ name: skill.name, action: "overridden", skillId: row.id });
+        continue;
+      }
+      throw e;
+    }
+  }
+  return { outcomes, agentSkills };
+}
+function describeSkillSyncOutcome(o) {
+  switch (o.action) {
+    case "created":
+      return `${o.name}: created (${o.skillId})`;
+    case "updated":
+      return `${o.name}: prompt updated from crew's local file`;
+    case "unchanged":
+      return `${o.name}: already in sync`;
+    case "overridden":
+      return `${o.name}: override in place \u2014 prompt not synced (clear "Customize prompt" on the Agent Skills row to resume)`;
+    case "diverged":
+      return `${o.name}: HAS LOCAL EDITS \u2014 crew's default is newer but was NOT applied; review ${o.skillId} in the app before syncing again`;
+  }
+}
+async function fetchSkillOverrides(route, opts) {
+  if (!route.resolved) return {};
+  const client2 = new TablationClient3({
+    baseUrl: `${route.baseUrl}/api`,
+    apiKey: resolveApiKey(route),
+    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
+  });
+  let rows;
+  try {
+    const model = await client2.dataModels.get("agent_skills", route.resolved.workspaceId);
+    rows = await client2.records.list(model.id, { limit: 200 });
+  } catch {
+    return {};
+  }
+  const local = new Map(listLocalSkills(route.promptsDir).map((s) => [s.name, s]));
+  const cache = route.resolved.agentSkills ?? {};
+  const out = {};
   for (const row of rows) {
     const name = row.name;
     if (row.prompt === local.get(name)?.prompt) continue;
@@ -7235,23 +7590,23 @@ var AgentError = class extends Error {
 var AgentSpawnError = class extends AgentError {
 };
 function planAgentRun(o) {
-  const briefPath = join11(o.route.promptsDir, "personas", `lane-${o.role}.md`);
-  if (!existsSync10(briefPath)) {
+  const briefPath = join12(o.route.promptsDir, "personas", `lane-${o.role}.md`);
+  if (!existsSync11(briefPath)) {
     throw new AgentError(`no brief at ${briefPath} \u2014 refusing to run an unscoped session`);
   }
-  const commonPath = join11(o.route.promptsDir, "personas", "common.md");
-  const usesCommon = !SELF_CONTAINED_ROLES.has(o.role) && existsSync10(commonPath);
+  const commonPath = join12(o.route.promptsDir, "personas", "common.md");
+  const usesCommon = !SELF_CONTAINED_ROLES.has(o.role) && existsSync11(commonPath);
   const now = o.now ?? (() => Date.now());
   const routeLabel = routeSlug(o.route.route);
-  const digestPath2 = join11(o.stateDir, `digest-${routeLabel}-${o.role}.md`);
+  const digestPath2 = join12(o.stateDir, `digest-${routeLabel}-${o.role}.md`);
   let digest;
   let ageSeconds;
-  if (existsSync10(digestPath2)) {
+  if (existsSync11(digestPath2)) {
     ageSeconds = Math.floor((now() - statSync5(digestPath2).mtimeMs) / 1e3);
-    if (ageSeconds <= DIGEST_MAX_AGE_SECONDS) digest = readFileSync9(digestPath2, "utf8");
+    if (ageSeconds <= DIGEST_MAX_AGE_SECONDS) digest = readFileSync10(digestPath2, "utf8");
   }
-  const common = usesCommon ? readFileSync9(commonPath, "utf8") : "";
-  const brief = readFileSync9(briefPath, "utf8");
+  const common = usesCommon ? readFileSync10(commonPath, "utf8") : "";
+  const brief = readFileSync10(briefPath, "utf8");
   const effectiveCommon = o.divergedPrompt ? "" : common;
   const effectiveBrief = o.divergedPrompt ?? brief;
   const localSkills = new Map(listLocalSkills(o.route.promptsDir).map((s) => [s.name, s.prompt]));
@@ -7273,7 +7628,7 @@ function planAgentRun(o) {
     digest
   });
   const promptSha = createHash2("sha256").update(expanded.text).digest("hex");
-  const streamsDir = join11(o.stateDir, "streams");
+  const streamsDir = join12(o.stateDir, "streams");
   const base = `${routeLabel}-${o.role}-${o.cycle}`;
   const seat = resolveSeat(o.ship, o.route, o.role, o.agentPersona ?? (o.agentModel ? { model: o.agentModel } : {}), o.repo);
   const { toolchain, model } = seat;
@@ -7329,8 +7684,8 @@ function planAgentRun(o) {
     digestAttached: digest !== void 0,
     digestAgeSeconds: ageSeconds,
     model,
-    streamPath: join11(streamsDir, `${base}.jsonl`),
-    eventsPath: join11(streamsDir, `${base}.events.jsonl`),
+    streamPath: join12(streamsDir, `${base}.jsonl`),
+    eventsPath: join12(streamsDir, `${base}.events.jsonl`),
     ticket: o.ticket,
     agentLog,
     promptVersion: o.route.resolved?.agentPersonas?.[o.role]?.historyId,
@@ -7536,13 +7891,13 @@ function spawnAgent(plan, emit) {
 }
 
 // src/run-worktree.ts
-import { existsSync as existsSync12 } from "fs";
-import { dirname as dirname7, join as join13 } from "path";
+import { existsSync as existsSync13 } from "fs";
+import { dirname as dirname7, join as join14 } from "path";
 
 // src/ports.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { existsSync as existsSync11 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync12 } from "fs";
+import { join as join13 } from "path";
 var run = (cmd, args) => {
   try {
     return execFileSync2(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -7587,7 +7942,7 @@ function ticketForPort(port, s = DEFAULT_PORTS) {
 }
 function worktreeExists(parent, prefix, n) {
   for (const name of [`${prefix}${n}`, `${prefix}${String(n).padStart(3, "0")}`]) {
-    if (existsSync11(join12(parent, name, ".git"))) return true;
+    if (existsSync12(join13(parent, name, ".git"))) return true;
   }
   return false;
 }
@@ -7661,7 +8016,7 @@ function planRunWorktree(dir, cfg, t, role) {
   const existing = worktreeForNumber(dir, num);
   const located = locateBranchForTicket(dir, cfg, t, role);
   const baseRef = hasRemote ? `${remote}/${base}` : base;
-  if (existing && !existing.prunable && existsSync12(existing.path)) {
+  if (existing && !existing.prunable && existsSync13(existing.path)) {
     const branch = existing.branch;
     if (status(existing.path).length > 0) return { action: "leave-dirty", path: existing.path, branch };
     if (!branch) return { action: "leave-unpushed", path: existing.path, branch: "(detached HEAD)" };
@@ -7675,7 +8030,7 @@ function planRunWorktree(dir, cfg, t, role) {
     if (countCommits(existing.path, `${baseRef}..HEAD`) > 0) return { action: "leave-unpushed", path: existing.path, branch };
     return { action: "recut", path: existing.path, branch, base: baseRef };
   }
-  const path = join13(dirname7(dir), worktreeForTicket(dir, cfg, t, role));
+  const path = join14(dirname7(dir), worktreeForTicket(dir, cfg, t, role));
   if (located?.where === "remote" || located && hasRemote && remoteBranchExists(dir, remote, located.branch)) {
     return { action: "cut-remote", path, branch: located.branch };
   }
@@ -7722,7 +8077,7 @@ function worktreeHoldsUnpushed(path, remote) {
 }
 async function finishRunWorktree(dir, cfg, branch) {
   const wt = worktrees(dir).find((w) => w.branch === branch && !w.prunable && w.path !== dir);
-  if (!wt || !existsSync12(wt.path)) return { kind: "none" };
+  if (!wt || !existsSync13(wt.path)) return { kind: "none" };
   if (cfg.hooks.handoff) return { kind: "kept-handoff", path: wt.path };
   if (status(wt.path).length > 0) return { kind: "kept-dirty", path: wt.path };
   if (remoteConfigured(dir, cfg.branch.remote) && worktreeHoldsUnpushed(wt.path, cfg.branch.remote)) {
@@ -7734,7 +8089,7 @@ async function finishRunWorktree(dir, cfg, branch) {
     if (pids.length) await killGently(pids);
   }
   gitOk(dir, ["worktree", "remove", wt.path]);
-  return existsSync12(wt.path) ? { kind: "kept-dirty", path: wt.path } : { kind: "removed", path: wt.path };
+  return existsSync13(wt.path) ? { kind: "kept-dirty", path: wt.path } : { kind: "removed", path: wt.path };
 }
 
 // src/handoff-guard.ts
@@ -7883,13 +8238,13 @@ async function retireRunWorktree(tracker, dir, cfg, t, role, seatId, shipName2,
 }
 
 // src/connect-wizard.ts
-import { delimiter, dirname as dirname8, join as join14 } from "path";
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync13, mkdirSync as mkdirSync7, writeFileSync as writeFileSync8 } from "fs";
+import { delimiter, dirname as dirname8, join as join15 } from "path";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync14, mkdirSync as mkdirSync7, writeFileSync as writeFileSync8 } from "fs";
 import { stringify } from "yaml";
 var HOST_PASSENGERS_DOCS_URL = "https://crew.tablation.dev/host-passengers";
 function shouldRunWizard(opts) {
   if (!opts.isTTY) return false;
-  const exists = opts.configExists ?? existsSync13;
+  const exists = opts.configExists ?? existsSync14;
   return !configSearchPath(opts.crewHome).some((p) => exists(p));
 }
 function firstRunConfigPath() {
@@ -7906,7 +8261,7 @@ function defaultIsExecutable(p) {
 function findOnPath2(name, pathEnv, isExecutable = defaultIsExecutable) {
   for (const dir of pathEnv.split(delimiter)) {
     if (!dir) continue;
-    const candidate = join14(dir, name);
+    const candidate = join15(dir, name);
     if (isExecutable(candidate)) return candidate;
   }
   return void 0;
@@ -8001,8 +8356,8 @@ Wrote ${o.configPath}.
 }
 
 // src/release-run.ts
-import { readFileSync as readFileSync10, writeFileSync as writeFileSync9, existsSync as existsSync14, copyFileSync, mkdirSync as mkdirSync8, mkdtempSync, rmSync as rmSync6 } from "fs";
-import { dirname as dirname9, join as join15 } from "path";
+import { readFileSync as readFileSync11, writeFileSync as writeFileSync9, existsSync as existsSync15, copyFileSync, mkdirSync as mkdirSync8, mkdtempSync, rmSync as rmSync6 } from "fs";
+import { dirname as dirname9, join as join16 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 
 // src/release.ts
@@ -8660,13 +9015,13 @@ async function bump(o, size) {
     }
     return printed;
   }
-  const files = o.repo.release.versionFiles.map((f) => join15(o.cwd, f));
+  const files = o.repo.release.versionFiles.map((f) => join16(o.cwd, f));
   const first = files[0];
-  if (!existsSync14(first)) {
+  if (!existsSync15(first)) {
     o.emit.error(`no ${o.repo.release.versionFiles[0]} to read a version from`);
     return null;
   }
-  const current = JSON.parse(readFileSync10(first, "utf8")).version;
+  const current = JSON.parse(readFileSync11(first, "utf8")).version;
   if (!current) {
     o.emit.error(`no version field in ${o.repo.release.versionFiles[0]}`);
     return null;
@@ -8679,7 +9034,7 @@ async function bump(o, size) {
     return version;
   }
   for (const f of files) {
-    const src = readFileSync10(f, "utf8");
+    const src = readFileSync11(f, "utf8");
     const out = src.replace(/("version"\s*:\s*")[^"]*(")/, `$1${version}$2`);
     if (out === src) {
       o.emit.error(`no version field in ${f}`);
@@ -8692,13 +9047,13 @@ async function bump(o, size) {
 function writeChangelog(o, version, entries) {
   const file = o.repo.release.changelog;
   if (!file || entries.length === 0) return;
-  const path = join15(o.cwd, file);
+  const path = join16(o.cwd, file);
   const section = renderChangelogSection(version, (/* @__PURE__ */ new Date()).toISOString().slice(0, 10), entries);
   if (o.dryRun) {
     o.emit.emit(`would prepend ${entries.length} entr(ies) to ${file}`);
     return;
   }
-  const existing = existsSync14(path) ? readFileSync10(path, "utf8") : "# Changelog\n";
+  const existing = existsSync15(path) ? readFileSync11(path, "utf8") : "# Changelog\n";
   writeFileSync9(path, insertChangelogSection(existing, section));
 }
 async function confirm(o, expected) {
@@ -8780,8 +9135,8 @@ async function confirmLastRelease(o, decision) {
 function openReleaseCheckout(o) {
   const { remote, base } = o.repo.branch;
   const branch = `crew/release-${Date.now()}`;
-  const root = mkdtempSync(join15(tmpdir2(), "crew-release-"));
-  const dir = join15(root, "checkout");
+  const root = mkdtempSync(join16(tmpdir2(), "crew-release-"));
+  const dir = join16(root, "checkout");
   const close = () => {
     gitOk(o.cwd, ["worktree", "remove", "--force", dir]);
     rmSync6(root, { recursive: true, force: true });
@@ -8795,10 +9150,10 @@ function openReleaseCheckout(o) {
     throw e;
   }
   for (const f of o.repo.worktrees.copy) {
-    const src = join15(o.cwd, f);
-    if (!existsSync14(src)) continue;
-    mkdirSync8(dirname9(join15(dir, f)), { recursive: true });
-    copyFileSync(src, join15(dir, f));
+    const src = join16(o.cwd, f);
+    if (!existsSync15(src)) continue;
+    mkdirSync8(dirname9(join16(dir, f)), { recursive: true });
+    copyFileSync(src, join16(dir, f));
   }
   return { dir, branch, close };
 }
@@ -9267,7 +9622,7 @@ function missingReleaserWarning(repo, release, ships, now = Date.now()) {
 }
 
 // src/watch.ts
-import { watch as watchFile, existsSync as existsSync15, statSync as statSync6, openSync as openSync3, readSync, closeSync as closeSync3 } from "fs";
+import { watch as watchFile, existsSync as existsSync16, statSync as statSync6, openSync as openSync3, readSync, closeSync as closeSync3 } from "fs";
 var E = "\x1B[";
 var dim = (s) => `${E}2m${s}${E}0m`;
 var bold = (s) => `${E}1m${s}${E}0m`;
@@ -9368,7 +9723,7 @@ function renderHeaders(states, now = Date.now()) {
   return states.map((s) => renderHeader(s, now)).join("");
 }
 function readFrom(file, from) {
-  if (!existsSync15(file)) return { events: [], offset: from };
+  if (!existsSync16(file)) return { events: [], offset: from };
   const size = statSync6(file).size;
   if (size < from) return readFrom(file, 0);
   if (size === from) return { events: [], offset: from };
@@ -9607,320 +9962,6 @@ function nextRoles(decision, ran) {
   return decision.selection.pending.filter((r) => !ran.includes(r)).sort((a, b) => (decision.selection.ranks[a] ?? 0) - (decision.selection.ranks[b] ?? 0));
 }
 
-// src/agents.ts
-import { readFileSync as readFileSync11, existsSync as existsSync16 } from "fs";
-import { join as join16 } from "path";
-import { TablationClient as TablationClient3, StaleWriteError as StaleWriteError7, TablationApiError as TablationApiError2 } from "@tablation/client";
-var PERSONA_NAME = {
-  dev: "Developer",
-  design: "Design",
-  qa: "QA",
-  triage: "Triage",
-  pair: "Pair"
-};
-var CREW_AGENT_FIELD_NAME = "Agent";
-var CREW_AGENT_COLUMN = "agent_id";
-var AgentsSyncError = class extends Error {
-};
-function personaDefaultPrompt(promptsDir, role) {
-  const briefPath = join16(promptsDir, "personas", `lane-${role}.md`);
-  if (!existsSync16(briefPath)) throw new AgentsSyncError(`no brief at ${briefPath}`);
-  if (SELF_CONTAINED_ROLES.has(role)) return readFileSync11(briefPath, "utf8");
-  const commonPath = join16(promptsDir, "personas", "common.md");
-  if (!existsSync16(commonPath)) return readFileSync11(briefPath, "utf8");
-  return `${readFileSync11(commonPath, "utf8")}${readFileSync11(briefPath, "utf8")}`;
-}
-async function resolveAgentId(route, role, opts) {
-  const cached = route.resolved?.agentPersonas?.[role]?.agentId;
-  if (cached) return cached;
-  const seatId = route.resolved?.seats?.[role];
-  if (!seatId || !route.resolved) return void 0;
-  const client2 = new TablationClient3({
-    baseUrl: `${route.baseUrl}/api`,
-    apiKey: resolveApiKey(route),
-    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
-  });
-  try {
-    const row = await client2.records.get(route.resolved.models.crew, seatId);
-    return row.agent_id ?? void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function fetchDivergedPrompt(route, role, opts) {
-  const agentId = await resolveAgentId(route, role, opts);
-  if (!agentId || !route.resolved) return void 0;
-  const client2 = new TablationClient3({
-    baseUrl: `${route.baseUrl}/api`,
-    apiKey: resolveApiKey(route),
-    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
-  });
-  let row;
-  let agentsModelId;
-  try {
-    const agentsModel = await client2.dataModels.get("agents", route.resolved.workspaceId);
-    agentsModelId = agentsModel.id;
-    row = await client2.records.get(agentsModelId, agentId);
-  } catch {
-    return void 0;
-  }
-  const defaultPrompt = personaDefaultPrompt(route.promptsDir, role);
-  if (row.prompt === defaultPrompt) return void 0;
-  const cached = route.resolved.agentPersonas?.[role];
-  if (cached?.agentId === agentId && cached.historyId) {
-    const lastSynced = await fetchLastSyncedPrompt(route, agentsModelId, agentId, cached.historyId, opts.userAgent);
-    if (lastSynced !== void 0 && lastSynced === row.prompt) return void 0;
-  }
-  return row.prompt;
-}
-async function fetchLastSyncedPrompt(route, agentsModelId, recordId, historyId, userAgent) {
-  try {
-    const entries = await fetchHistoryEntries(route, agentsModelId, recordId, userAgent);
-    return entries.find((e) => e.history_id === historyId)?.prompt;
-  } catch {
-    return void 0;
-  }
-}
-function choiceValue(v) {
-  const raw = typeof v === "string" ? v : v && typeof v === "object" ? v.value ?? v.key : void 0;
-  return typeof raw === "string" && raw.trim() ? raw.trim().toLowerCase() : void 0;
-}
-async function fetchSeatPersona(route, role, opts) {
-  const agentId = await resolveAgentId(route, role, opts);
-  if (!agentId || !route.resolved) return void 0;
-  const client2 = new TablationClient3({
-    baseUrl: `${route.baseUrl}/api`,
-    apiKey: resolveApiKey(route),
-    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
-  });
-  try {
-    const agentsModel = await client2.dataModels.get("agents", route.resolved.workspaceId);
-    const row = await client2.records.get(agentsModel.id, agentId);
-    const tier = choiceValue(row.tier);
-    const vendor = choiceValue(row.vendor);
-    const persona = {
-      ...row.model ? { model: row.model } : {},
-      ...tier && TIERS.includes(tier) ? { tier } : {},
-      ...vendor ? { vendor } : {}
-    };
-    return Object.keys(persona).length > 0 ? persona : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function currentPersonaPrompt(route, role, opts) {
-  const diverged = await fetchDivergedPrompt(route, role, opts);
-  return diverged ?? personaDefaultPrompt(route.promptsDir, role);
-}
-async function fetchHistoryEntries(route, agentsModelId, recordId, userAgent, limit = 50) {
-  const url = `${route.baseUrl.replace(/\/+$/, "")}/api/data-models/${agentsModelId}/records/${recordId}/history?limit=${limit}`;
-  const res = await fetch(url, {
-    headers: {
-      Authorization: `Bearer ${resolveApiKey(route)}`,
-      "User-Agent": userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0"
-    }
-  });
-  if (!res.ok) throw new AgentsSyncError(`history lookup for ${recordId}: ${res.status} ${res.statusText}`);
-  return await res.json();
-}
-async function fetchLatestHistoryId(route, agentsModelId, recordId, userAgent) {
-  try {
-    const entries = await fetchHistoryEntries(route, agentsModelId, recordId, userAgent, 1);
-    return entries[0]?.history_id;
-  } catch {
-    return void 0;
-  }
-}
-async function syncPersonas(route, opts) {
-  if (!route.resolved) {
-    throw new AgentsSyncError(`route "${route.route}" has no resolved ids \u2014 run \`crew connect\` first`);
-  }
-  const workspaceId = route.resolved.workspaceId;
-  const client2 = new TablationClient3({
-    baseUrl: `${route.baseUrl}/api`,
-    apiKey: resolveApiKey(route),
-    headers: { "User-Agent": opts.userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" }
-  });
-  let agentsModel;
-  try {
-    agentsModel = await client2.dataModels.get("agents", workspaceId);
-  } catch (e) {
-    if (e instanceof TablationApiError2 && e.status === 404) {
-      throw new AgentsSyncError(
-        `workspace ${workspaceId} has no Agents table yet \u2014 every workspace auto-provisions one (ISSUE-465); an older workspace may still need its one-time backfill`
-      );
-    }
-    throw e;
-  }
-  const rows = await client2.records.list(agentsModel.id, { limit: 200 });
-  const cache = route.resolved.agentPersonas ?? {};
-  const outcomes = [];
-  const agentPersonas = { ...cache };
-  for (const role of ROLE_NAMES) {
-    const name = PERSONA_NAME[role];
-    const defaultPrompt = personaDefaultPrompt(route.promptsDir, role);
-    const row = rows.find((r) => r.name === name);
-    if (!row) {
-      if (opts.dryRun) {
-        outcomes.push({ role, action: "created", agentId: "(dry run)" });
-        continue;
-      }
-      const created = await client2.records.create(agentsModel.id, { name, prompt: defaultPrompt });
-      const historyId = await fetchLatestHistoryId(route, agentsModel.id, created.id, opts.userAgent);
-      agentPersonas[role] = { agentId: created.id, lastSyncedUpdatedAt: created.updated_at, ...historyId ? { historyId } : {} };
-      outcomes.push({ role, action: "created", agentId: created.id });
-      continue;
-    }
-    if (row.prompt === defaultPrompt) {
-      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
-      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: row.updated_at, ...historyId ? { historyId } : {} };
-      outcomes.push({ role, action: "unchanged", agentId: row.id });
-      continue;
-    }
-    if (opts.force) {
-      if (opts.dryRun) {
-        outcomes.push({ role, action: "forced", agentId: row.id, previousPrompt: row.prompt });
-        continue;
-      }
-      const updated = await client2.records.update(agentsModel.id, row.id, { prompt: defaultPrompt });
-      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
-      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: updated.updated_at, ...historyId ? { historyId } : {} };
-      outcomes.push({ role, action: "forced", agentId: row.id, previousPrompt: row.prompt });
-      continue;
-    }
-    const cached = cache[role]?.agentId === row.id ? cache[role] : void 0;
-    if (!cached?.historyId) {
-      outcomes.push({ role, action: "diverged", agentId: row.id });
-      continue;
-    }
-    let lastSyncedPrompt;
-    try {
-      const entries = await fetchHistoryEntries(route, agentsModel.id, row.id, opts.userAgent);
-      lastSyncedPrompt = entries.find((e) => e.history_id === cached.historyId)?.prompt;
-    } catch {
-      lastSyncedPrompt = void 0;
-    }
-    if (lastSyncedPrompt === void 0 || lastSyncedPrompt !== row.prompt) {
-      outcomes.push({ role, action: "diverged", agentId: row.id });
-      continue;
-    }
-    if (opts.dryRun) {
-      outcomes.push({ role, action: "updated", agentId: row.id });
-      continue;
-    }
-    try {
-      const updated = await client2.records.update(
-        agentsModel.id,
-        row.id,
-        { prompt: defaultPrompt },
-        row.updated_at
-      );
-      const historyId = await fetchLatestHistoryId(route, agentsModel.id, row.id, opts.userAgent);
-      agentPersonas[role] = { agentId: row.id, lastSyncedUpdatedAt: updated.updated_at, ...historyId ? { historyId } : {} };
-      outcomes.push({ role, action: "updated", agentId: row.id });
-    } catch (e) {
-      if (e instanceof StaleWriteError7) {
-        outcomes.push({ role, action: "diverged", agentId: row.id });
-        continue;
-      }
-      throw e;
-    }
-  }
-  const crewLinks = opts.dryRun ? [] : await linkCrewSeats(route, client2, agentsModel.id, agentPersonas, opts.userAgent);
-  return { outcomes, agentPersonas, crewLinks };
-}
-async function linkCrewSeats(route, client2, agentsModelId, agentPersonas, userAgent) {
-  const seats2 = route.resolved.seats;
-  const rolesWithSeats = ROLE_NAMES.filter((role) => seats2[role] && agentPersonas[role]);
-  if (rolesWithSeats.length === 0) {
-    return ROLE_NAMES.map((role) => ({ role, action: seats2[role] ? "persona_diverged" : "no_seat" }));
-  }
-  const crewModelId = route.resolved.models.crew;
-  const crewModel = await client2.dataModels.get(crewModelId);
-  const columnName = await ensureCrewAgentField(route, client2, crewModel, agentsModelId, userAgent);
-  const outcomes = [];
-  for (const role of ROLE_NAMES) {
-    const seatId = seats2[role];
-    const agentId = agentPersonas[role]?.agentId;
-    if (!seatId) {
-      outcomes.push({ role, action: "no_seat" });
-      continue;
-    }
-    if (!agentId) {
-      outcomes.push({ role, action: "persona_diverged" });
-      continue;
-    }
-    const seatRow = await client2.records.get(crewModelId, seatId);
-    if (seatRow[CREW_AGENT_COLUMN] === agentId) {
-      outcomes.push({ role, action: "already_linked" });
-      continue;
-    }
-    await client2.records.update(crewModelId, seatId, { [columnName]: agentId });
-    outcomes.push({ role, action: "linked" });
-  }
-  return outcomes;
-}
-async function ensureCrewAgentField(route, client2, crewModel, agentsModelId, userAgent) {
-  const existing = crewModel.fields.find(
-    (f) => f.fieldType?.kind === "REFERENCE" && f.fieldType.targetModelId === agentsModelId && f.fieldType.isMultiple === false
-  );
-  if (existing) return existing.columnName;
-  const workspaceId = route.resolved.workspaceId;
-  const baseUrl = route.baseUrl.replace(/\/+$/, "");
-  const apiKey = resolveApiKey(route);
-  const headers = { Authorization: `Bearer ${apiKey}`, "User-Agent": userAgent ?? "Mozilla/5.0 TablationCrewAgent/1.0" };
-  const typesRes = await fetch(`${baseUrl}/api/workspaces/${workspaceId}/field-types`, { headers });
-  if (!typesRes.ok) throw new AgentsSyncError(`field-types lookup failed: ${typesRes.status} ${typesRes.statusText}`);
-  const types = await typesRes.json();
-  const fieldType = types.find((t) => t.kind === "REFERENCE" && t.targetModelId === agentsModelId && t.isMultiple === false);
-  if (!fieldType) {
-    throw new AgentsSyncError(
-      `workspace ${workspaceId} has no single-valued Agents-reference field type \u2014 every table auto-provisions one (see the pseudo-builtin reference types convention); an older Agents table may need its one-time backfill`
-    );
-  }
-  const createRes = await fetch(`${baseUrl}/api/data-models/${crewModel.id}/fields`, {
-    method: "POST",
-    headers: { ...headers, "Content-Type": "application/json" },
-    body: JSON.stringify({
-      name: CREW_AGENT_FIELD_NAME,
-      columnName: CREW_AGENT_COLUMN,
-      fieldTypeId: fieldType.id,
-      description: "The Agents-table row backing this seat's persona \u2014 set by `crew agents sync` (ISSUE-416), never edited by hand."
-    })
-  });
-  if (!createRes.ok) throw new AgentsSyncError(`creating the Crew table's Agent field failed: ${createRes.status} ${createRes.statusText}`);
-  const created = await createRes.json();
-  return created.columnName;
-}
-function describeSyncOutcome(o) {
-  const label = PERSONA_NAME[o.role];
-  switch (o.action) {
-    case "created":
-      return `${label}: created (${o.agentId})`;
-    case "updated":
-      return `${label}: prompt updated from crew's local default`;
-    case "unchanged":
-      return `${label}: already in sync`;
-    case "diverged":
-      return `${label}: HAS LOCAL EDITS \u2014 crew's default is newer but was NOT applied; review ${o.agentId} in the app before syncing again`;
-    case "forced":
-      return `${label}: --force overwrote local edits (previous prompt was: ${JSON.stringify(o.previousPrompt ?? "")})`;
-  }
-}
-function describeCrewLink(o) {
-  const label = PERSONA_NAME[o.role];
-  switch (o.action) {
-    case "linked":
-      return `${label}: Crew row now references its Agents row`;
-    case "already_linked":
-      return `${label}: Crew row already references its Agents row`;
-    case "no_seat":
-      return `${label}: no seat configured for this role \u2014 skipped linking`;
-    case "persona_diverged":
-      return `${label}: persona has local edits and was not synced this pass \u2014 skipped linking until it's resolved`;
-  }
-}
-
 // src/connect.ts
 var ConnectHttpError = class extends Error {
   status;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.39.1",
+  "version": "0.40.0",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",