@systemdox/mcp-server 0.1.46 → 0.1.48

package/README.md

@@ -160,6 +160,75 @@ reaches every member's computer as one plugin, `<workspace>-setup`.
   by identifier (`` `con_…` (reseller, sales) ``): their label, name, phone
   number and email address. The details are for that session only; the memory
   keeps the identifier. It writes nothing.
+- **`sync_memory`** (your own computer only) syncs a project's team memory, as
+  `sync-memory` below does with no one at the terminal: it never answers a
+  question about a person and never rewrites a file for one. A file that still
+  holds a phone number, an email address or a home-folder path is skipped and
+  listed with the command to run yourself. Inputs: `project`, `dryRun`.
+
+One command sets up your computer, and the same command updates it:
+
+```bash
+npx -y @systemdox/mcp-server setup [--project <name>] [--dir <checkout>] [--yes] [--overwrite]
+```
+
+- It first writes the SystemDox MCP server into your AI tool's config, as it
+  always has. Then, when your workspace has anything published, it checks that
+  Claude Code is 2.1.316 or later (`claude update` otherwise) and shows you
+  everything it will add: the marketplace entry for `~/.claude/settings.json`,
+  the plugin with every hook command and every MCP server's command or URL
+  verbatim, the import block for `~/.claude/CLAUDE.md`, each team memory with
+  its file count and folder, and the `autoMemoryDirectory` it will set. On an
+  update it shows only what changed, with a line diff for hooks and
+  instructions. Nothing changes until you answer `y`.
+- Then, in this order: your key goes into
+  `~/.claude/systemdox/credentials.json` (readable by you alone, and nowhere
+  else); the team instructions into `~/.claude/systemdox/<workspace>/CLAUDE.md`
+  (if you edited that file, it stops unless `--overwrite`); one marked import
+  block into `~/.claude/CLAUDE.md`; one `extraKnownMarketplaces` entry,
+  `systemdox-<workspace>`, into `~/.claude/settings.json` (nothing else in
+  either file is touched); and, for the project (`--project`, or the only
+  one), `autoMemoryDirectory` in `<checkout>/.claude/settings.local.json`
+  (`--dir`, or the current folder), followed by its first sync.
+- Two steps are left for you, because Claude Code registers a marketplace only
+  once a session has started: open Claude Code once in any folder and close
+  it, then run `claude plugin install <workspace>-setup@systemdox-<workspace>`
+  in your own terminal and accept the command it shows. `setup` never adds the
+  marketplace through `claude` and never enables the plugin for you.
+- `--yes` answers for you only without a terminal, and only for what you have
+  accepted before; anything new or changed is listed and stops the run.
+- Exit codes: `0` done, `1` usage / no key / API error, `2` your edited team
+  `CLAUDE.md` would be replaced (named), `3` Claude Code missing or too old,
+  `4` not confirmed (you answered N, or `--yes` met something new).
+
+Each project's team memory is synced file by file with one command, which you
+run in your own terminal:
+
+```bash
+npx -y @systemdox/mcp-server sync-memory [--project <name>] [--dir <folder>] [--import <folder>] [--dry-run]
+```
+
+- The folder is `--dir`, or `~/.claude/systemdox/<workspace>/memory/<project>/`.
+  Only `feedback`, `project` and `reference` memories and `MEMORY.md` are
+  shared; a `user` memory, a file with `share: false` and a
+  `<name>.local-<date>.md` conflict copy never leave your computer, and the
+  sync never touches them.
+- A file changed only here goes up, one changed only by the team comes down,
+  and one changed on both sides keeps the team's text under its name and yours
+  beside it as `<name>.local-<date>.md`. `MEMORY.md` is merged line by line.
+- Each phone number or email address is asked about once for the whole
+  workspace: `m` a member's contact, `p` someone else (with a role label, never
+  a name), `o` ours, not a person, `x` leave these files out (`share: false`),
+  `s` skip for now. After one `y/N` over the whole diff, each person becomes
+  their identifier (`` `con_…` (reseller, sales) ``) and a home folder `~`.
+- `--import <folder>` merges a second copy of the same memory in (your first
+  sync), keeping every difference as a pair; that folder is not changed.
+  `--dry-run` shows what would be pulled, pushed, deleted, conflicted and
+  skipped, and how many values are still to answer; it asks, writes and sends
+  nothing.
+- Exit codes: `0` synced (conflict copies and skipped files are listed, not
+  errors), `1` usage / no key / API error, `2` the team memory moved on twice
+  while syncing (your folder holds the merge; run it again).
 
 Claude Code runs two commands itself; you never type them: