@systemdox/mcp-server 0.1.46 → 0.1.48

package/dist/sync-memory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `systemdox-mcp-server sync-memory [--project <name>] [--dir <folder>]
+ * [--import <folder>] [--dry-run]`, and the core of the local MCP tool
+ * `sync_memory` (ADR-217 §2.3 with Amendment 2,
+ * specs/changes/team-setup/contract.md "sync-memory and the MCP tool
+ * sync_memory").
+ *
+ * 1. Pull: the team's latest version (`getMemory`), the base (state.json; with
+ *    none, the empty manifest, while the push names the team's latest version)
+ *    and the local folder.
+ * 2. People: every value in the shared files, grouped; `lookupValues`; in a
+ *    terminal only, one question per unanswered value, then one y/N over the
+ *    whole rewrite. Without a terminal nothing is asked or rewritten, and a
+ *    file still holding a value is skipped and listed.
+ * 3. The merge (lib/memory-sync.ts), written to the local folder.
+ * 4. The push on the base; on 409 SYD-K010 pull, merge again and retry once.
+ *    state.json takes the new base only after the push succeeds.
+ *
+ * Exit codes: 0 synced; 1 usage, no key, or the API refused; 2 the push was
+ * refused twice on a stale base.
+ */
+import { SystemDoxApiClient } from "./lib/api-client.js";
+import { type CommandIo } from "./lib/team-setup-files.js";
+export declare const SYNC_MEMORY_USAGE = "Usage: systemdox-mcp-server sync-memory [--project <name>] [--dir <folder>] [--import <folder>] [--dry-run]";
+export declare const SYNC_MEMORY_COMMAND = "npx -y @systemdox/mcp-server sync-memory";
+export type SyncClient = Pick<SystemDoxApiClient, "getOwnTeamSetup" | "getMemory" | "readBlobs" | "findMissingBlobs" | "uploadBlobs" | "pushMemoryVersion" | "lookupValues" | "answerValues" | "fileMemoryPeople">;
+export interface SyncMemoryArgs {
+    project?: string;
+    dir?: string;
+    importDir?: string;
+    dryRun: boolean;
+}
+export interface SyncMemoryOptions extends SyncMemoryArgs {
+    client: SyncClient;
+    /** Each argument is one line of the report. */
+    out: (...lines: string[]) => void;
+    /** A person at a terminal. Absent for the MCP tool, a hook or CI: then
+     * nothing is asked and nothing is rewritten. */
+    ask?: (question: string) => Promise<string>;
+    now?: () => Date;
+}
+export declare function parseSyncMemoryArgs(argv: string[]): SyncMemoryArgs;
+/**
+ * Sync one project's team memory. Returns the exit code; every line of the
+ * report goes to `opts.out`.
+ */
+export declare function syncMemory(opts: SyncMemoryOptions): Promise<number>;
+/** The command: parse, find the key, sync. */
+export declare function runSyncMemory(argv: string[], io: CommandIo & {
+    client?: SyncClient;
+    ask?: (question: string) => Promise<string>;
+    now?: () => Date;
+}, env?: NodeJS.ProcessEnv): Promise<number>;