@systemdox/mcp-server 0.1.58 → 0.1.60

package/README.md

@@ -226,6 +226,16 @@ One command sets up your computer, and the same command updates it:
 npx -y @systemdox/mcp-server setup [--project <name>] [--dir <checkout>] [--import <folder>]... [--yes] [--overwrite]
 ```
 
+- **The key must be able to sync.** Create it in the console under Settings ›
+  API keys with **Developer** or **Architect** access on **All spaces**, with
+  **Allow changes** ticked. A key made with the defaults is a **Reader** key:
+  it reads the team setup, but SystemDox refuses its pushes (`SYD-A001`), so it
+  cannot sync a team memory.
+- **The workspace's first team memory needs a name.** With no team memory yet,
+  name it once with `--project <name>`. Without it, `setup` installs the plugin
+  and the instructions and sets up no memory. Later computers find the only
+  team memory by themselves, and with several they ask which is the checkout's.
+
 - It first writes the SystemDox MCP server into your AI tool's config, without
   your key: the key is stored once, in `~/.claude/systemdox/credentials.json`
   (readable by you alone), and a key an earlier `setup` wrote into that config
@@ -301,12 +311,16 @@ npx -y @systemdox/mcp-server sync-memory --hook <workspace>
 - It syncs only the projects this computer synced before (the first sync is
   yours, in your terminal), asks nothing and rewrites nothing.
 - It prints one line per project, which Claude Code adds to the session, plus a
-  line naming any conflict copy to tidy and one for files waiting for you, with
-  the command to run. A value is never printed. The full report is appended to
+  line naming any conflict copy to tidy and one naming the files waiting for you
+  (the first five, then how many more), with the command to run. A value is
+  never printed. The full report is appended to
   `~/.claude/systemdox/<workspace>/sync-memory.log`.
-- One run at a time per workspace (`sync.lock`), a 20-second budget, and exit
-  `0` always: offline or slow, it says the memory was not synced and the next
-  session tries again.
+- One run at a time per workspace (`sync.lock`), a 20-second budget counted from
+  the start of the process, and exit `0` always: offline or slow, it says the
+  memory was not synced and the next session tries again.
+- A key for another workspace, or a team memory SystemDox no longer serves,
+  syncs nothing and leaves the folder as it is. Every file is written whole
+  (a temporary file, then a rename).
 
 Claude Code runs two commands itself; you never type them:
 

package/dist/cli.js

@@ -884,6 +884,7 @@ __export(sync_memory_exports, {
   HOOK_BUDGET_MS: () => HOOK_BUDGET_MS,
   HOOK_LOCK_STALE_MS: () => HOOK_LOCK_STALE_MS,
   HOOK_LOG_MAX_BYTES: () => HOOK_LOG_MAX_BYTES,
+  HOOK_WAITING_NAMED: () => HOOK_WAITING_NAMED,
   SYNC_MEMORY_COMMAND: () => SYNC_MEMORY_COMMAND,
   SYNC_MEMORY_USAGE: () => SYNC_MEMORY_USAGE,
   hookLines: () => hookLines,
@@ -1411,9 +1412,14 @@ async function syncMemory(opts) {
     return 1;
   }
 }
+function firstNames(names) {
+  const shown = names.slice(0, HOOK_WAITING_NAMED).join(", ");
+  const rest = names.length - HOOK_WAITING_NAMED;
+  return rest > 0 ? `${shown} and ${rest} more` : shown;
+}
 function hookLines(ws, project, folder, s) {
   if (s.outcome !== "synced") {
-    return [`Team memory ${ws}/${project}: not synced (${s.reason ?? "it did not finish"}); your files are unchanged and the next session tries again.`];
+    return [`Team memory ${ws}/${project}: not synced (${s.reason ?? "it did not finish"}); the next session tries again.`];
   }
   const lines = [`Team memory ${ws}/${project}: version ${s.version}, ${s.pulled} pulled, ${s.pushed} pushed, ${s.deleted} deleted.`];
   if (s.conflictCopies.length) {
@@ -1421,7 +1427,7 @@ function hookLines(ws, project, folder, s) {
   }
   if (s.waiting.length) {
     lines.push(
-      `  ${plural(s.waiting.length, "file waits", "files wait")} for you: run \`${SYNC_MEMORY_COMMAND} --project ${project}\` in your terminal.`
+      `  ${plural(s.waiting.length, "file waits", "files wait")} for you (${firstNames(s.waiting)}): run \`${SYNC_MEMORY_COMMAND} --project ${project}\` in your terminal.`
     );
   }
   return lines;
@@ -1595,7 +1601,7 @@ async function runSyncMemory(argv, io, env = process.env) {
   }
   return syncMemory({ ...args2, client, out: (...lines) => lines.forEach((l) => io.out(l)), ask: io.ask, now: io.now });
 }
-var SYNC_MEMORY_USAGE, HOOK_BUDGET_MS, HOOK_LOCK_STALE_MS, HOOK_LOG_MAX_BYTES, SYNC_MEMORY_COMMAND, SyncFailed, SyncStopped, toPath, LEFT_TEMP_RE, Report, ANSWER_WORDS, sameManifest, plural;
+var SYNC_MEMORY_USAGE, HOOK_BUDGET_MS, HOOK_LOCK_STALE_MS, HOOK_LOG_MAX_BYTES, SYNC_MEMORY_COMMAND, SyncFailed, SyncStopped, toPath, LEFT_TEMP_RE, Report, ANSWER_WORDS, sameManifest, plural, HOOK_WAITING_NAMED;
 var init_sync_memory = __esm({
   "src/sync-memory.ts"() {
     "use strict";
@@ -1702,6 +1708,7 @@ var init_sync_memory = __esm({
     };
     sameManifest = (a, b) => Object.keys(a).length === Object.keys(b).length && Object.entries(a).every(([p, h]) => b[p] === h);
     plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+    HOOK_WAITING_NAMED = 5;
   }
 });
 
@@ -5758,7 +5765,7 @@ var init_server = __esm({
     init_create_prompt_template();
     init_skills2();
     init_team_setup();
-    SERVER_VERSION = true ? "0.1.58" : "0.0.0-dev";
+    SERVER_VERSION = true ? "0.1.60" : "0.0.0-dev";
     READ_TOOLS = [
       "get_context",
       "get_checks",

package/dist/http.js

@@ -4102,7 +4102,7 @@ function registerTeamSetupTools(server, apiClient, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.58" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.60" : "0.0.0-dev";
 var READ_TOOLS = [
   "get_context",
   "get_checks",

package/dist/index.js

@@ -4156,7 +4156,7 @@ function registerTeamSetupTools(server, apiClient2, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.58" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.60" : "0.0.0-dev";
 var READ_TOOLS = [
   "get_context",
   "get_checks",

package/dist/server.js

@@ -3769,7 +3769,7 @@ function registerTeamSetupTools(server, apiClient, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.58" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.60" : "0.0.0-dev";
 var READ_TOOLS = [
   "get_context",
   "get_checks",

package/dist/sync-memory.d.ts

@@ -53,7 +53,11 @@ export interface SyncSummary {
     deleted: number;
     /** The `.local-<date>.md` copies this run wrote. */
     conflictCopies: string[];
-    /** The files skipped this run (waiting for the member, or refused). */
+    /**
+     * The files held back for the member at a terminal (a value nobody answered
+     * for, a value to rewrite, the vault not answering), sorted. A secret or a
+     * refusal is not here: it is in the log.
+     */
     waiting: string[];
 }
 export interface SyncMemoryOptions extends SyncMemoryArgs {
@@ -79,7 +83,14 @@ export declare function parseSyncMemoryArgs(argv: string[]): SyncMemoryArgs;
  * report goes to `opts.out`.
  */
 export declare function syncMemory(opts: SyncMemoryOptions): Promise<number>;
-/** The lines the hook prints for one project (contract.md "--hook"): never a value. */
+/** How many waiting files the hook's line names before it says "and n more". */
+export declare const HOOK_WAITING_NAMED = 5;
+/**
+ * The lines the hook prints for one project (contract.md "--hook"): files and
+ * counts, never a value. A run that did not finish says only that the next
+ * session tries again: a push refused twice leaves the merge in the folder,
+ * so the files are not always as they were.
+ */
 export declare function hookLines(ws: string, project: string, folder: string, s: SyncSummary): string[];
 export interface HookIo extends CommandIo {
     client?: SyncClient;

package/dist/sync-memory.js

@@ -1358,9 +1358,15 @@ async function syncMemory(opts) {
   }
 }
 var plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+var HOOK_WAITING_NAMED = 5;
+function firstNames(names) {
+  const shown = names.slice(0, HOOK_WAITING_NAMED).join(", ");
+  const rest = names.length - HOOK_WAITING_NAMED;
+  return rest > 0 ? `${shown} and ${rest} more` : shown;
+}
 function hookLines(ws, project, folder, s) {
   if (s.outcome !== "synced") {
-    return [`Team memory ${ws}/${project}: not synced (${s.reason ?? "it did not finish"}); your files are unchanged and the next session tries again.`];
+    return [`Team memory ${ws}/${project}: not synced (${s.reason ?? "it did not finish"}); the next session tries again.`];
   }
   const lines = [`Team memory ${ws}/${project}: version ${s.version}, ${s.pulled} pulled, ${s.pushed} pushed, ${s.deleted} deleted.`];
   if (s.conflictCopies.length) {
@@ -1368,7 +1374,7 @@ function hookLines(ws, project, folder, s) {
   }
   if (s.waiting.length) {
     lines.push(
-      `  ${plural(s.waiting.length, "file waits", "files wait")} for you: run \`${SYNC_MEMORY_COMMAND} --project ${project}\` in your terminal.`
+      `  ${plural(s.waiting.length, "file waits", "files wait")} for you (${firstNames(s.waiting)}): run \`${SYNC_MEMORY_COMMAND} --project ${project}\` in your terminal.`
     );
   }
   return lines;
@@ -1546,6 +1552,7 @@ export {
   HOOK_BUDGET_MS,
   HOOK_LOCK_STALE_MS,
   HOOK_LOG_MAX_BYTES,
+  HOOK_WAITING_NAMED,
   SYNC_MEMORY_COMMAND,
   SYNC_MEMORY_USAGE,
   hookLines,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@systemdox/mcp-server",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "mcpName": "io.github.puglieseweb/systemdox",
   "type": "module",
   "description": "Give AI coding agents your architecture context over MCP — checks, specs, ADRs, project rules, and docs from SystemDox, delivered at write time",