@systemdox/mcp-server 0.1.45 → 0.1.46

package/dist/index.js

@@ -70,6 +70,28 @@ var ResponseCache = class {
 };
 
 // src/lib/api-client.ts
+var SystemDoxApiError = class extends Error {
+  constructor(status, text3) {
+    super(`SystemDox API error ${status}: ${text3}`);
+    this.status = status;
+    this.text = text3;
+    let body;
+    try {
+      body = JSON.parse(text3);
+    } catch {
+      body = void 0;
+    }
+    this.body = body;
+    const code = body?.code;
+    this.code = typeof code === "string" ? code : /\b(SYD-[A-Z]\d{3})\b/.exec(text3)?.[1];
+  }
+  status;
+  text;
+  code;
+  body;
+};
+var TEAM_SETUP = "/v1/team-setup";
+var seg = (s) => encodeURIComponent(String(s));
 var SystemDoxApiClient = class {
   config;
   cache;
@@ -91,10 +113,7 @@ var SystemDoxApiClient = class {
     const cached = this.cache.get(cacheKey);
     if (cached !== void 0) return cached;
     const res = await this.fetchRaw(path, params);
-    if (!res.ok) {
-      const body = await res.text();
-      throw new Error(`SystemDox API error ${res.status}: ${body}`);
-    }
+    if (!res.ok) throw new SystemDoxApiError(res.status, await res.text());
     const data = await res.json();
     this.cache.set(cacheKey, data);
     return data;
@@ -103,10 +122,7 @@ var SystemDoxApiClient = class {
    * latest now, not the one cached before someone published another. */
   async getFresh(path) {
     const res = await this.fetchRaw(path);
-    if (!res.ok) {
-      const body = await res.text();
-      throw new Error(`SystemDox API error ${res.status}: ${body}`);
-    }
+    if (!res.ok) throw new SystemDoxApiError(res.status, await res.text());
     return await res.json();
   }
   async post(path, body) {
@@ -128,12 +144,101 @@ var SystemDoxApiClient = class {
       },
       body: JSON.stringify(body)
     });
-    if (!res.ok) {
-      const text2 = await res.text();
-      throw new Error(`SystemDox API error ${res.status}: ${text2}`);
-    }
+    if (!res.ok) throw new SystemDoxApiError(res.status, await res.text());
     return await res.json();
   }
+  // ── Team setup (ADR-217, specs/changes/team-setup/openapi.yaml) ──────────
+  // One method per operationId. Every read skips the cache: setup, sync and
+  // plugin-path act on what the workspace holds now.
+  /** getOwnTeamSetup: the key's own workspace, named in `workspace`. */
+  getOwnTeamSetup() {
+    return this.getFresh(TEAM_SETUP);
+  }
+  getTeamSetup(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}`);
+  }
+  getMarketplace(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/marketplace.json`);
+  }
+  getPart(workspace, part) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/parts/${seg(part)}`);
+  }
+  publishPartVersion(workspace, part, files) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/parts/${seg(part)}/versions`, { files });
+  }
+  getPartVersion(workspace, part, version) {
+    return this.getFresh(
+      `${TEAM_SETUP}/${seg(workspace)}/parts/${seg(part)}/versions/${seg(version)}`
+    );
+  }
+  getSetupSkills(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/skills`);
+  }
+  setSetupSkills(workspace, skills) {
+    return this.put(`${TEAM_SETUP}/${seg(workspace)}/skills`, { skills });
+  }
+  getPlugin(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/plugin`);
+  }
+  /** getPluginZip: the zip's bytes as served, and its X-Content-SHA256
+   * header. The caller checks the BYTES against the hash it was given. */
+  async getPluginZip(workspace, version) {
+    const res = await fetch(
+      this.buildUrl(`${TEAM_SETUP}/${seg(workspace)}/plugin/versions/${seg(version)}/zip`),
+      {
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`,
+          "X-API-Key": this.config.apiKey,
+          Accept: "application/zip"
+        }
+      }
+    );
+    if (!res.ok) throw new SystemDoxApiError(res.status, await res.text());
+    return { bytes: Buffer.from(await res.arrayBuffer()), sha256: res.headers.get("x-content-sha256") };
+  }
+  listMemoryProjects(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/memory`);
+  }
+  getMemory(workspace, project) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}`);
+  }
+  /** pushMemoryVersion: a stale base throws SystemDoxApiError with status 409,
+   * code SYD-K010 and `body.currentVersion`. */
+  pushMemoryVersion(workspace, project, body) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}/versions`, body);
+  }
+  getMemoryVersion(workspace, project, version) {
+    return this.getFresh(
+      `${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}/versions/${seg(version)}`
+    );
+  }
+  findMissingBlobs(workspace, project, hashes) {
+    return this.post(
+      `${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}/blobs/missing`,
+      { hashes }
+    );
+  }
+  uploadBlobs(workspace, project, blobs) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}/blobs`, { blobs });
+  }
+  readBlobs(workspace, project, hashes) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/memory/${seg(project)}/blobs/read`, { hashes });
+  }
+  listValueAnswers(workspace) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/values`);
+  }
+  lookupValues(workspace, values) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/values`, { values });
+  }
+  answerValues(workspace, answers) {
+    return this.put(`${TEAM_SETUP}/${seg(workspace)}/values`, { answers });
+  }
+  fileMemoryPeople(workspace, people) {
+    return this.post(`${TEAM_SETUP}/${seg(workspace)}/people`, { people });
+  }
+  resolvePerson(workspace, personId) {
+    return this.getFresh(`${TEAM_SETUP}/${seg(workspace)}/people/${seg(personId)}`);
+  }
   invalidateCache(path) {
     if (path) {
       this.cache.invalidate(this.buildUrl(path).toString());
@@ -295,12 +400,12 @@ function registerGetGuardrails(server2, apiClient2) {
       );
     }
     if (filtered.length === 0) {
-      const text3 = guardrails.length === 0 ? `No checks found. Add checks at ${configLink("/docs/guardrails", await workspaceBase(apiClient2))}` : `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`;
+      const text4 = guardrails.length === 0 ? `No checks found. Add checks at ${configLink("/docs/guardrails", await workspaceBase(apiClient2))}` : `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`;
       return {
-        content: [{ type: "text", text: text3 }]
+        content: [{ type: "text", text: text4 }]
       };
     }
-    const text2 = filtered.map(
+    const text3 = filtered.map(
       (g) => `## ${g.title} [${g.severity}]
 
 ${g.description}
@@ -324,7 +429,7 @@ ${g.fix}
           type: "text",
           text: `Found ${filtered.length} check(s):
 
-${text2}`
+${text3}`
         }
       ]
     };
@@ -414,7 +519,7 @@ ${spec.taskContent}`);
           ]
         };
       }
-      const text2 = filtered.map(
+      const text3 = filtered.map(
         (s) => `- **${s.name}** (${s.draftId}) \u2014 ${s.status}, ${s.requirementCount} requirements` + (s.repoFullName ? `, repo: ${s.repoFullName}` : "")
       ).join("\n");
       return {
@@ -423,7 +528,7 @@ ${spec.taskContent}`);
             type: "text",
             text: `Found ${filtered.length} spec(s):
 
-${text2}`
+${text3}`
           }
         ]
       };
@@ -476,18 +581,18 @@ function registerGetDocs(server2, apiClient2) {
             isError: true
           };
         }
-        let text3 = doc.content;
+        let text4 = doc.content;
         if (anchor && doc.section_resolved === false) {
-          text3 = `_Section "${anchor}" not found \u2014 returning the full document._
+          text4 = `_Section "${anchor}" not found \u2014 returning the full document._
 
-` + text3;
+` + text4;
         } else if (anchor && doc.heading) {
-          text3 = `## ${doc.heading}
+          text4 = `## ${doc.heading}
 
 ${doc.content}`;
         }
         return {
-          content: [{ type: "text", text: text3 }]
+          content: [{ type: "text", text: text4 }]
         };
       }
       const params = {};
@@ -511,7 +616,7 @@ ${doc.content}`;
           ]
         };
       }
-      const text2 = items.map((d) => {
+      const text3 = items.map((d) => {
         const sections = (d.outline ?? []).slice(0, 8);
         const sectionHint = sections.length > 0 ? `
   sections: ${sections.map((s) => s.anchor).join(", ")}` : "";
@@ -525,7 +630,7 @@ ${doc.content}`;
             type: "text",
             text: `Found ${items.length} document(s) (${response.total} total):
 
-${text2}
+${text3}
 
 Use doc_id for full content, or doc_id + section to fetch one section.`
           }
@@ -860,13 +965,13 @@ var SEVERITY_SCORES = {
   low: 0.25
 };
 var CHARS_PER_TOKEN = 4;
-function estimateTokens(text2) {
-  return Math.ceil(text2.length / CHARS_PER_TOKEN);
+function estimateTokens(text3) {
+  return Math.ceil(text3.length / CHARS_PER_TOKEN);
 }
-function truncateToTokens(text2, maxTokens) {
+function truncateToTokens(text3, maxTokens) {
   const maxChars = Math.max(0, maxTokens) * CHARS_PER_TOKEN;
-  if (text2.length <= maxChars) return { text: text2, truncated: false };
-  const head = text2.slice(0, maxChars);
+  if (text3.length <= maxChars) return { text: text3, truncated: false };
+  const head = text3.slice(0, maxChars);
   const floor = Math.floor(maxChars * 0.75);
   const paragraph = head.lastIndexOf("\n\n");
   const line = head.lastIndexOf("\n");
@@ -911,7 +1016,7 @@ function scoreSeverity(item) {
   if (!item.severity) return 0.5;
   return SEVERITY_SCORES[item.severity] ?? 0.5;
 }
-function extractKeywords(text2) {
+function extractKeywords(text3) {
   const stopWords = /* @__PURE__ */ new Set([
     "the",
     "a",
@@ -996,7 +1101,7 @@ function extractKeywords(text2) {
     "implement",
     "create"
   ]);
-  return text2.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !stopWords.has(w));
+  return text3.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !stopWords.has(w));
 }
 function scoreItems(items, taskDescription, filePaths) {
   const languages = detectLanguages(filePaths);
@@ -1039,20 +1144,20 @@ var MAX_TAIL = 10;
 var TAIL_SHARE = 0.15;
 var TRUNCATION_NOTICE_TOKENS = 30;
 function formatGuardrail(g) {
-  let text2 = `## ${g.title} [${g.severity}]
+  let text3 = `## ${g.title} [${g.severity}]
 
 ${g.description}`;
-  if (g.pattern) text2 += `
+  if (g.pattern) text3 += `
 
 **Bad:** \`\`\`
 ${g.pattern}
 \`\`\``;
-  if (g.fix) text2 += `
+  if (g.fix) text3 += `
 
 **Good:** \`\`\`
 ${g.fix}
 \`\`\``;
-  return text2;
+  return text3;
 }
 function formatSpecHeadline(s) {
   return `### ${s.name}
@@ -1074,19 +1179,19 @@ function formatRules(rules) {
     if (!byCategory.has(cat)) byCategory.set(cat, []);
     byCategory.get(cat).push(r);
   }
-  let text2 = "";
+  let text3 = "";
   for (const [cat, catRules] of byCategory) {
-    text2 += `### ${cat.charAt(0).toUpperCase() + cat.slice(1)}
+    text3 += `### ${cat.charAt(0).toUpperCase() + cat.slice(1)}
 `;
     for (const r of catRules) {
-      text2 += `- ${r.text}
+      text3 += `- ${r.text}
 `;
     }
-    text2 += "\n";
+    text3 += "\n";
   }
   return `## Project Rules (${rules.length})
 
-${text2.trim()}`;
+${text3.trim()}`;
 }
 async function fetchSpecBody(api, draftId) {
   const spec = await api.get(
@@ -1423,13 +1528,13 @@ function registerGetContext(server2, apiClient2) {
       }
     },
     async ({ task_description, file_paths, max_tokens }) => {
-      const { text: text2 } = await buildContext(apiClient2, {
+      const { text: text3 } = await buildContext(apiClient2, {
         taskDescription: task_description,
         filePaths: file_paths,
         maxTokens: max_tokens
       });
       return {
-        content: [{ type: "text", text: text2 }]
+        content: [{ type: "text", text: text3 }]
       };
     }
   );
@@ -1677,9 +1782,9 @@ function registerGetProjectRules(server2, apiClient2) {
         );
       }
       if (filtered.length === 0) {
-        const text3 = rules.length === 0 ? `No project rules found. Add rules at ${configLink("/docs/rules", await workspaceBase(apiClient2))}` : `No project rules found${category ? ` in category "${category}"` : ""}.`;
+        const text4 = rules.length === 0 ? `No project rules found. Add rules at ${configLink("/docs/rules", await workspaceBase(apiClient2))}` : `No project rules found${category ? ` in category "${category}"` : ""}.`;
         return {
-          content: [{ type: "text", text: text3 }]
+          content: [{ type: "text", text: text4 }]
         };
       }
       const grouped = /* @__PURE__ */ new Map();
@@ -1688,25 +1793,25 @@ function registerGetProjectRules(server2, apiClient2) {
         if (!grouped.has(cat)) grouped.set(cat, []);
         grouped.get(cat).push(rule);
       }
-      let text2 = `Found ${filtered.length} project rule(s):
+      let text3 = `Found ${filtered.length} project rule(s):
 
 `;
       for (const [cat, catRules] of grouped) {
         const label = CATEGORY_LABELS[cat] ?? cat;
-        text2 += `## ${label}
+        text3 += `## ${label}
 
 `;
         for (const rule of catRules) {
-          text2 += `- ${rule.text}
+          text3 += `- ${rule.text}
 `;
         }
-        text2 += "\n";
+        text3 += "\n";
       }
       return {
         content: [
           {
             type: "text",
-            text: text2
+            text: text3
           }
         ]
       };
@@ -1732,10 +1837,10 @@ function registerCreateProjectRule(server2, apiClient2) {
         readOnlyHint: false
       }
     },
-    async ({ text: text2, category }) => {
+    async ({ text: text3, category }) => {
       const saved = await apiClient2.post(
         "/v1/standards/rules",
-        { text: text2, category }
+        { text: text3, category }
       );
       apiClient2.invalidateCache("/v1/standards/rules");
       return {
@@ -1773,7 +1878,7 @@ function registerGetPromptTemplates(server2, apiClient2) {
           ]
         };
       }
-      const text2 = templates.map(
+      const text3 = templates.map(
         (t) => `## ${t.name}
 
 ` + (t.description ? `*${t.description}*
@@ -1788,7 +1893,7 @@ ${t.prompt}
             type: "text",
             text: `Found ${templates.length} prompt template(s):
 
-${text2}`
+${text3}`
           }
         ]
       };
@@ -1896,18 +2001,9 @@ async function walk(root, { skipHidden }, dir = root, out = { files: [], links:
   out.files.sort();
   return out;
 }
-async function readSkillDirectory(directory) {
-  const root = resolve(directory);
-  if (!existsSync(join(root, ENTRY_FILE))) {
-    throw new Error(`${root} has no ${ENTRY_FILE}: a skill folder holds SKILL.md at its root`);
-  }
-  const walked = await walk(root, { skipHidden: true });
-  if (walked.links.length) {
-    throw new Error(`${walked.links.join(", ")}: links are not followed; copy the file into the skill folder`);
-  }
-  const paths = walked.files;
+async function readTextFiles(root, paths, what) {
   if (paths.length > MAX_FILES) {
-    throw new Error(`${root} holds ${paths.length} files: a skill holds at most ${MAX_FILES}`);
+    throw new Error(`${root} holds ${paths.length} files: ${what} holds at most ${MAX_FILES}`);
   }
   const decoder = new TextDecoder("utf-8", { fatal: true });
   const files = [];
@@ -1917,7 +2013,7 @@ async function readSkillDirectory(directory) {
       throw new Error(`${path}: file names may use letters, digits, ".", "_" and "-" only`);
     }
     const raw = await readFile(join(root, ...path.split("/")));
-    if (raw.includes(0)) throw new Error(`${path} is binary: a skill holds text files only`);
+    if (raw.includes(0)) throw new Error(`${path} is binary: ${what} holds text files only`);
     if (raw.length > MAX_FILE_BYTES) {
       throw new Error(`${path} is ${raw.length} bytes: a file holds at most ${MAX_FILE_BYTES}`);
     }
@@ -1933,6 +2029,18 @@ async function readSkillDirectory(directory) {
     }
     files.push({ path, content });
   }
+  return files;
+}
+async function readSkillDirectory(directory) {
+  const root = resolve(directory);
+  if (!existsSync(join(root, ENTRY_FILE))) {
+    throw new Error(`${root} has no ${ENTRY_FILE}: a skill folder holds SKILL.md at its root`);
+  }
+  const walked = await walk(root, { skipHidden: true });
+  if (walked.links.length) {
+    throw new Error(`${walked.links.join(", ")}: links are not followed; copy the file into the skill folder`);
+  }
+  const files = await readTextFiles(root, walked.files, "a skill");
   const skillMd = files.find((f) => f.path === ENTRY_FILE);
   const name = frontmatterName(skillMd.content);
   if (!name) throw new Error(`${ENTRY_FILE} has no frontmatter name`);
@@ -2014,8 +2122,8 @@ async function installSkill(version, dest, { overwrite = false } = {}) {
     keptEdited
   };
 }
-function fenceFor(text2) {
-  const longest = Math.max(0, ...(text2.match(/`+/g) ?? []).map((r) => r.length));
+function fenceFor(text3) {
+  const longest = Math.max(0, ...(text3.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
 function describeInstall(name, r) {
@@ -2171,8 +2279,186 @@ ${body}`
   );
 }
 
+// src/tools/team-setup.ts
+import { z as z14 } from "zod";
+import { existsSync as existsSync2 } from "fs";
+import { lstat as lstat2 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join2, resolve as resolve3 } from "path";
+
+// src/lib/person-values.ts
+var W = "[\\p{L}\\p{N}_]";
+var D = "\\p{Nd}";
+var WORD_OR = (extra) => `[\\p{L}\\p{N}_${extra}]`;
+var PERSON_ID = "(?:con|ctc|usr)_[0-9A-Za-z]{10,40}";
+var PERSON_TOKEN = `\`${PERSON_ID}\`(?:[ \\t]*\\([^()\\n]*\\))?`;
+var BEFORE = `(?<!${WORD_OR("+.:/\\\\\\-")})(?<!${D}[ -])`;
+var AFTER = `(?!${WORD_OR(":/\\\\")}|\\.${D}|[ -]?${D}|-${W})`;
+var E164 = `${BEFORE}\\+${D}+(?:[ -]${D}+)*${AFTER}`;
+var NATIONAL = `${BEFORE}0${D}*(?:[ -]${D}+)*${AFTER}`;
+var ATEXT = "[A-Za-z0-9!#$%&'*+/=?^_{|}~\\-]";
+var EMAIL_RE = "(?<![A-Za-z0-9!#$%&*+/=?^_{|}~.@\\-])[A-Za-z0-9_]" + ATEXT + "*(?:\\." + ATEXT + "+)*@(?:[A-Za-z0-9](?:[A-Za-z0-9\\-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}(?![A-Za-z0-9\\-]|\\.[A-Za-z0-9])";
+var HOME_PREFIX = "(?:[A-Za-z]:\\\\+Users\\\\+|[A-Za-z]:/+Users/+|/Users/|/home/)";
+var HOME = `(?<!${WORD_OR(".~:/\\\\$}\\-")})${HOME_PREFIX}[^\\\\/\\s"'\`<>|:*?]+`;
+var KEY_PREFIX = `(?<!${W})(?:pweb_[a-z]+_key_|sk-ant-|sk_live_|rk_live_|github_pat_|gh[pousr]_|sntrys_|xox[baprs]-)[A-Za-z0-9_\\-]{4,}`;
+
+// src/lib/team-setup-types.ts
+var PARTS = ["hooks", "mcp", "agents", "commands", "instructions"];
+var PERSON_ID_RE = new RegExp(`^${PERSON_ID}$`);
+
+// src/tools/team-setup.ts
+var LAYOUT = {
+  hooks: { files: ["hooks/hooks.json"], folders: [{ dir: "scripts", md: false }], required: "hooks/hooks.json" },
+  mcp: { files: [".mcp.json"], folders: [], required: ".mcp.json" },
+  agents: { files: [], folders: [{ dir: "agents", md: true }] },
+  commands: { files: [], folders: [{ dir: "commands", md: true }] },
+  instructions: { files: ["CLAUDE.md"], folders: [], required: "CLAUDE.md" }
+};
+function expandHome2(path) {
+  return path.replace(/^~(?=$|[\\/])/, homedir3());
+}
+function text2(t) {
+  return { content: [{ type: "text", text: t }] };
+}
+async function isLink(path) {
+  try {
+    return (await lstat2(path)).isSymbolicLink();
+  } catch (e) {
+    if (e.code === "ENOENT") return false;
+    throw e;
+  }
+}
+async function readPartDirectory(part, directory) {
+  const root = resolve3(directory);
+  const layout = LAYOUT[part];
+  const paths = [];
+  const leftOut = [];
+  const links = [];
+  for (const path of layout.files) {
+    const segments = path.split("/");
+    let present = true;
+    for (let i = 1; i <= segments.length; i++) {
+      const rel = segments.slice(0, i).join("/");
+      if (await isLink(join2(root, ...segments.slice(0, i)))) {
+        links.push(rel);
+        present = false;
+        break;
+      }
+    }
+    if (present && existsSync2(join2(root, ...segments))) paths.push(path);
+  }
+  for (const { dir, md } of layout.folders) {
+    const full = join2(root, dir);
+    if (await isLink(full)) {
+      links.push(dir);
+      continue;
+    }
+    if (!existsSync2(full)) continue;
+    const walked = await walk(full, { skipHidden: true });
+    links.push(...walked.links.map((p) => `${dir}/${p}`));
+    leftOut.push(...walked.hidden.map((p) => `${dir}/${p}`));
+    for (const p of walked.files) {
+      if (md && !p.endsWith(".md")) leftOut.push(`${dir}/${p}`);
+      else paths.push(`${dir}/${p}`);
+    }
+  }
+  if (links.length) {
+    throw new Error(
+      `${links.join(", ")}: links are not followed; copy the file into the folder. Nothing was sent.`
+    );
+  }
+  if (layout.required && !paths.includes(layout.required)) {
+    throw new Error(`${root} has no ${layout.required}: the ${part} part needs it. Nothing was sent.`);
+  }
+  if (!paths.length) {
+    throw new Error(
+      `${root} has no ${layout.folders.map((f) => `${f.dir}/*.md`).join(" or ")}: nothing to publish for ${part}.`
+    );
+  }
+  return { files: await readTextFiles(root, paths.sort(), `the ${part} part`), leftOut };
+}
+function describePerson(id, person) {
+  const lines = [`**${person.label ?? "(no label)"}**, \`${id}\``];
+  if (person.mergedInto) {
+    lines.push(`\`${id}\` was merged into \`${person.mergedInto}\`: these are \`${person.mergedInto}\`'s details.`);
+  }
+  lines.push(`- Name: ${person.name ?? "(none held)"}`);
+  lines.push(`- Phone number: ${person.phone ?? "(none held)"}`);
+  lines.push(`- Email address: ${person.email ?? "(none held)"}`);
+  const token = `\`${person.mergedInto ?? id}\`${person.label ? ` (${person.label})` : ""}`;
+  lines.push(
+    "",
+    `These details are for this session only. Do not write them into a memory file, a note or a commit: a memory names this person by the identifier, as ${token}. A memory file that holds the details is offered for rewriting again at the next sync.`
+  );
+  return lines.join("\n");
+}
+function registerTeamSetupTools(server2, apiClient2, { localFiles }) {
+  const fileSchema = z14.object({
+    path: z14.string().describe(`Path inside the part's folder, forward slashes, e.g. "hooks/hooks.json"`),
+    content: z14.string().describe("The file's full text, exactly as it is")
+  });
+  server2.registerTool(
+    "publish_setup_part",
+    {
+      title: "Publish Setup Part",
+      description: "Publish one part of your team's Claude Code setup to SystemDox: `hooks` (hooks/hooks.json and the scripts/ it calls), `mcp` (.mcp.json), `agents` (agents/*.md), `commands` (commands/*.md) or `instructions` (CLAUDE.md). Every part but instructions makes a new version of the team plugin, which each member accepts at their next update. Publishing hooks, mcp, agents or commands needs the admin role. " + (localFiles ? "Pass `directory`: the server reads only the files the part accepts, byte for byte, and refuses a link, a binary file or a file too large before anything is sent. Never retype the files into `files` when the folder is on this computer." : "Pass every file of the part in `files`, exactly as it is."),
+      inputSchema: {
+        part: z14.enum(PARTS).describe("Which part of the setup"),
+        ...localFiles ? {
+          directory: z14.string().optional().describe(
+            "The folder on this computer: for hooks, the one holding hooks/hooks.json and scripts/; for mcp, the one holding .mcp.json; for instructions, the one holding CLAUDE.md; for agents or commands, the one holding agents/ or commands/"
+          )
+        } : {},
+        files: z14.array(fileSchema).optional().describe(localFiles ? "Only when there is no folder to read" : "Every file of the part")
+      },
+      annotations: { readOnlyHint: false }
+    },
+    async (args) => {
+      let files;
+      let leftOut = [];
+      if (localFiles && args.directory) {
+        ({ files, leftOut } = await readPartDirectory(args.part, expandHome2(args.directory)));
+      } else if (args.files?.length) {
+        files = args.files;
+      } else {
+        throw new Error(localFiles ? "Pass `directory` (or `files`)." : "Pass `files`.");
+      }
+      const { workspace } = await apiClient2.getOwnTeamSetup();
+      const saved = await apiClient2.publishPartVersion(workspace, args.part, files);
+      const lines = [`Published **${saved.part}** version ${saved.version}.`];
+      if (saved.part !== "instructions" && saved.pluginVersion !== void 0) {
+        lines.push(`Team plugin version ${saved.pluginVersion}; each member accepts it at their next update.`);
+      }
+      if (saved.replacedValues?.length) {
+        lines.push(
+          "Replaced by a reference to each member's own environment variable:",
+          ...saved.replacedValues.map((r) => `- ${r.server} ${r.field} ${r.name}: \${${r.name}}`)
+        );
+      }
+      if (leftOut.length) lines.push(`Left out (not part of ${args.part}): ${leftOut.join(", ")}`);
+      return text2(lines.join("\n"));
+    }
+  );
+  server2.registerTool(
+    "resolve_person",
+    {
+      title: "Resolve Person",
+      description: "Read back a person that a team memory names by identifier, written as `con_\u2026` (label), `ctc_\u2026` or `usr_\u2026`: their label, name, phone number and email address, from the vault that holds them. The details are for this session only: never write them into a memory file; the memory keeps the identifier. Writes nothing.",
+      inputSchema: {
+        id: z14.string().regex(PERSON_ID_RE, "a con_, ctc_ or usr_ identifier, as written in the memory").describe("The identifier, e.g. con_01JC2Q8Y4M7T0X3K5N9P2R6S8V")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async (args) => {
+      const { workspace } = await apiClient2.getOwnTeamSetup();
+      const person = await apiClient2.resolvePerson(workspace, args.id);
+      return text2(describePerson(args.id, person));
+    }
+  );
+}
+
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.45" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.46" : "0.0.0-dev";
 function createServer(apiClient2, { localFiles = false } = {}) {
   const server2 = new McpServer({
     name: "systemdox-mcp-server",
@@ -2193,6 +2479,7 @@ function createServer(apiClient2, { localFiles = false } = {}) {
   registerCreateProjectRule(server2, apiClient2);
   registerCreatePromptTemplate(server2, apiClient2);
   registerSkillTools(server2, apiClient2, { localFiles });
+  registerTeamSetupTools(server2, apiClient2, { localFiles });
   return server2;
 }