@maximalabs/dev-mcp-suite 0.0.0-stage → 3.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/.env.example +69 -0
  2. package/CHANGELOG.md +281 -0
  3. package/CODEX_DEV_MCP_GUIDE.md +297 -0
  4. package/LICENSE +21 -0
  5. package/README.md +193 -2
  6. package/armada/package.json +14 -0
  7. package/armada/server.js +329 -0
  8. package/backfill-sessions-v2.mjs +288 -0
  9. package/bin/_meta.mjs +73 -0
  10. package/bin/armada-mcp.mjs +12 -0
  11. package/bin/checkpoint.mjs +9 -0
  12. package/bin/context-pack.mjs +9 -0
  13. package/bin/devjournal.mjs +9 -0
  14. package/bin/init.mjs +25 -0
  15. package/bin/project-memory.mjs +10 -0
  16. package/bin/provider-smoke.mjs +278 -0
  17. package/bin/prune.mjs +158 -0
  18. package/bin/stats.mjs +101 -0
  19. package/bin/ui.mjs +5 -0
  20. package/checkpoint/package.json +14 -0
  21. package/checkpoint/server.js +318 -0
  22. package/context-pack/package.json +14 -0
  23. package/context-pack/server.js +747 -0
  24. package/devjournal/compress.js +75 -0
  25. package/devjournal/env.js +3 -0
  26. package/devjournal/package.json +14 -0
  27. package/devjournal/provider-chain.js +109 -0
  28. package/devjournal/rerank.js +120 -0
  29. package/devjournal/server.js +415 -0
  30. package/docs/ROADMAP.md +77 -0
  31. package/docs/clients/antigravity.md +52 -0
  32. package/docs/clients/claude-code.md +46 -0
  33. package/docs/clients/codex.md +39 -0
  34. package/docs/clients/generic-mcp.md +45 -0
  35. package/docs/clients/hermes.md +48 -0
  36. package/docs/configuration.md +123 -0
  37. package/docs/privacy.md +39 -0
  38. package/docs/providers.md +13 -0
  39. package/docs/superpowers/plans/2026-06-15-hardening-v1-2-implementation.md +60 -0
  40. package/docs/superpowers/plans/2026-06-15-provider-chain-v1-1-implementation.md +65 -0
  41. package/docs/superpowers/plans/2026-06-15-provider-client-agnostic-config.md +41 -0
  42. package/docs/superpowers/plans/2026-06-15-trust-release-implementation.md +62 -0
  43. package/docs/superpowers/plans/2026-06-18-v1-5-0-knowledge-graph.md +792 -0
  44. package/docs/superpowers/specs/2026-06-15-provider-chain-v1-1-design.md +89 -0
  45. package/docs/superpowers/specs/2026-06-15-trust-release-design.md +164 -0
  46. package/docs/superpowers/specs/2026-06-18-dev-mcp-suite-v1-5-0-knowledge-graph-design.md +386 -0
  47. package/docs/superpowers/specs/2026-07-22-v2-0-0-peak-intelligence.md +50 -0
  48. package/docs/superpowers/specs/2026-07-22-v3-0-0-god-tier.md +32 -0
  49. package/lib/init-wizard.js +120 -0
  50. package/lib/provider-smoke.js +234 -0
  51. package/lib/prune.js +114 -0
  52. package/lib/stats.js +269 -0
  53. package/lib/ui-server.js +151 -0
  54. package/lib/update-check.js +125 -0
  55. package/package.json +71 -4
  56. package/project-memory/auto-indexer.js +152 -0
  57. package/project-memory/dedup.js +49 -0
  58. package/project-memory/embedding.js +174 -0
  59. package/project-memory/env.js +3 -0
  60. package/project-memory/global-index.js +46 -0
  61. package/project-memory/graph.js +93 -0
  62. package/project-memory/local-embed.js +92 -0
  63. package/project-memory/package.json +14 -0
  64. package/project-memory/provider-chain.js +109 -0
  65. package/project-memory/rerank.js +120 -0
  66. package/project-memory/server.js +931 -0
  67. package/project-memory/swarm.js +56 -0
  68. package/run-tests.mjs +54 -0
@@ -0,0 +1,278 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * bin/provider-smoke.mjs — Dev MCP Suite provider smoke test.
4
+ *
5
+ * Probes every provider that can be derived from the current env:
6
+ * - MCP_LLM_BASE_URL / NINEROUTER_URL / LLM_BASE_URL (9router-like)
7
+ * - MCP_PROVIDER_PRIMARY / _CHAIN2 / _CHAIN3 / ... (numbered slots)
8
+ * - Named: GROQ_*, CEREBRAS_*, MISTRAL_*, OPENROUTER_*, OPENAI_*, OLLAMA_*, ...
9
+ *
10
+ * For each provider, runs:
11
+ * - chat probe (/v1/chat/completions, short prompt) if supportsChat
12
+ * - embed probe (/v1/embeddings, single string) if supportsEmbed
13
+ *
14
+ * Output: human text by default; --json for machines; --markdown for docs.
15
+ *
16
+ * Env override:
17
+ * --env-file <path> Source env from this file before probing (e.g. /tmp/secrets.env)
18
+ *
19
+ * Exit code:
20
+ * 0 = all probes ok
21
+ * 1 = at least one probe failed
22
+ */
23
+ import fs from "fs";
24
+ import os from "os";
25
+ import path from "path";
26
+ import { fileURLToPath } from "url";
27
+ import { buildProviderMatrix, shapeProbe, formatText, formatJson, formatMarkdown, isCloudflareURL } from "../lib/provider-smoke.js";
28
+
29
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
30
+
31
+ function pkgVersion() {
32
+ try {
33
+ return JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")).version || "unknown";
34
+ } catch { return "unknown"; }
35
+ }
36
+
37
+
38
+ /** Strip a trailing /v1 (only the literal segment, not /openai/v1) so we can re-append /v1/<endpoint>. */
39
+ function stripV1(baseUrl) {
40
+ return String(baseUrl || "").replace(/\/v1\/?$/, "").replace(/\/$/, "");
41
+ }
42
+
43
+ function parseArgs(argv) {
44
+ const opts = {
45
+ help: false, version: false,
46
+ json: false, markdown: false,
47
+ saveMd: null, envFile: null,
48
+ chatOnly: false, embedOnly: false,
49
+ timeoutMs: 15000,
50
+ only: null,
51
+ };
52
+ for (let i = 0; i < argv.length; i++) {
53
+ const a = argv[i];
54
+ if (a === "-h" || a === "--help") opts.help = true;
55
+ else if (a === "-v" || a === "--version") opts.version = true;
56
+ else if (a === "--json") opts.json = true;
57
+ else if (a === "--markdown") opts.markdown = true;
58
+ else if (a === "--save-md") opts.saveMd = argv[++i];
59
+ else if (a === "--env-file") opts.envFile = argv[++i];
60
+ else if (a === "--chat-only") opts.chatOnly = true;
61
+ else if (a === "--embed-only") opts.embedOnly = true;
62
+ else if (a === "--timeout") opts.timeoutMs = parseInt(argv[++i], 10) || 15000;
63
+ else if (a === "--only") opts.only = (argv[++i] || "").split(",").map(s => s.trim()).filter(Boolean);
64
+ else { process.stderr.write(`provider-smoke: unknown flag: ${a}\n`); process.exit(2); }
65
+ }
66
+ return opts;
67
+ }
68
+
69
+ function printHelp() {
70
+ const out = [
71
+ `provider-smoke (Dev MCP Suite) v${pkgVersion()}`,
72
+ "",
73
+ "Probe every configured LLM provider (chat + embeddings) and print a matrix.",
74
+ "",
75
+ "Usage:",
76
+ " provider-smoke [--json] [--markdown] [--save-md <path>]",
77
+ " [--chat-only | --embed-only] [--env-file <path>]",
78
+ " provider-smoke --help | --version",
79
+ "",
80
+ "Options:",
81
+ " --json Machine-readable JSON output",
82
+ " --markdown Markdown table (for docs/)",
83
+ " --save-md <path> Write markdown report to this file",
84
+ " --env-file <path> Source env vars from this file before probing",
85
+ " (KEY=value lines, one per line)",
86
+ " --chat-only Only probe /v1/chat/completions",
87
+ " --embed-only Only probe /v1/embeddings",
88
+ " --timeout <ms> Per-probe timeout (default 15000)",
89
+ " --only a,b,c Only probe these provider ids (comma-separated); others ignored",
90
+ "",
91
+ "Detected providers (precedence):",
92
+ " MCP_PROVIDER_PRIMARY / _CHAIN2 / _CHAIN3 / ... (numbered slots)",
93
+ " GROQ_*, CEREBRAS_*, MISTRAL_*, OPENROUTER_*, (named)",
94
+ " OPENAI_*, OLLAMA_*, ANTHROPIC_*, GEMINI_*, COHERE_*",
95
+ " MCP_LLM_BASE_URL / NINEROUTER_URL / LLM_BASE_URL (9router / agentrouter)",
96
+ "",
97
+ "Examples:",
98
+ " provider-smoke",
99
+ " provider-smoke --env-file /tmp/codex-dev-smoke.env",
100
+ " provider-smoke --json | jq '.[] | select(.ok == false)'",
101
+ " provider-smoke --markdown --save-md docs/providers.md",
102
+ ];
103
+ process.stdout.write(out.join("\n") + "\n");
104
+ }
105
+
106
+ function loadEnvFile(file) {
107
+ if (!file) return {};
108
+ const text = fs.readFileSync(file, "utf8");
109
+ const env = {};
110
+ for (const raw of text.split(/\r?\n/)) {
111
+ const line = raw.trim();
112
+ if (!line || line.startsWith("#")) continue;
113
+ const m = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
114
+ if (m) env[m[1]] = m[2];
115
+ }
116
+ return env;
117
+ }
118
+
119
+ function buildHeaders(provider) {
120
+ const h = { "Content-Type": "application/json" };
121
+ if (provider.apiKey) h["Authorization"] = `Bearer ${provider.apiKey}`;
122
+ return h;
123
+ }
124
+
125
+
126
+ const CF_EMBED_ONLY_PREFIXES = ["@cf/baai/", "@cf/google/embedding", "@cf/baai/sentence-"];
127
+
128
+ function isEmbedOnlyModel(model) {
129
+ if (!model) return false;
130
+ return CF_EMBED_ONLY_PREFIXES.some((p) => model.startsWith(p));
131
+ }
132
+
133
+ async function probeCloudflare(provider, timeoutMs, kind) {
134
+ // Skip chat probe for known embed-only Cloudflare model prefixes (annotate, not error).
135
+ if (kind === "chat" && isEmbedOnlyModel(provider.chatModel || provider.embedModel)) {
136
+ return shapeProbe({ name: provider.id, kind: "chat", ok: false, error: "embed-only model (chat not supported)" });
137
+ }
138
+ // Cloudflare Workers AI REST: POST {baseUrl}/{model}, body shape depends on kind.
139
+ // Cloudflare model names contain "/" (e.g. "@cf/baai/bge-base-en-v1.5"); do NOT URL-encode.
140
+ const url = `${provider.baseUrl.replace(/\/$/, "")}/${provider.chatModel || provider.embedModel}`;
141
+ let body;
142
+ if (kind === "chat") {
143
+ body = JSON.stringify({
144
+ messages: [{ role: "user", content: "Say the single word: OK" }],
145
+ max_tokens: 8,
146
+ });
147
+ } else {
148
+ body = JSON.stringify({ text: ["ping"] });
149
+ }
150
+ const t0 = Date.now();
151
+ try {
152
+ const res = await fetch(url, { method: "POST", headers: buildHeaders(provider), body, signal: AbortSignal.timeout(timeoutMs) });
153
+ const text = await res.text();
154
+ const latencyMs = Date.now() - t0;
155
+ if (res.status !== 200) {
156
+ return shapeProbe({ name: provider.id, kind, ok: false, status: res.status, latencyMs, error: text.slice(0, 200) });
157
+ }
158
+ let sample = null, dim = null;
159
+ try {
160
+ const j = JSON.parse(text);
161
+ if (kind === "embed") {
162
+ const data = j?.result?.data;
163
+ if (Array.isArray(data) && Array.isArray(data[0])) dim = data[0].length;
164
+ } else {
165
+ sample = j?.result?.response ?? null;
166
+ }
167
+ } catch { /* ignore */ }
168
+ return shapeProbe({ name: provider.id, kind, ok: true, status: res.status, latencyMs, sample, dim });
169
+ } catch (e) {
170
+ return shapeProbe({ name: provider.id, kind, ok: false, latencyMs: Date.now() - t0, error: String(e && e.message || e) });
171
+ }
172
+ }
173
+
174
+ async function probeChat(provider, timeoutMs) {
175
+ if (!provider.baseUrl || !provider.chatModel) {
176
+ return shapeProbe({ name: provider.id, kind: "chat", ok: false, error: "missing baseUrl or chatModel" });
177
+ }
178
+ const endpoint = provider.endpoint || (isCloudflareURL(provider.baseUrl) ? "cloudflare" : "openai-compatible");
179
+ if (endpoint === "cloudflare") return probeCloudflare(provider, timeoutMs, "chat");
180
+ const url = `${stripV1(provider.baseUrl)}/v1/chat/completions`;
181
+ const body = JSON.stringify({
182
+ model: provider.chatModel,
183
+ messages: [{ role: "user", content: "Say the single word: OK" }],
184
+ max_tokens: 8,
185
+ temperature: 0,
186
+ });
187
+ const t0 = Date.now();
188
+ try {
189
+ const res = await fetch(url, { method: "POST", headers: buildHeaders(provider), body, signal: AbortSignal.timeout(timeoutMs) });
190
+ const text = await res.text();
191
+ const latencyMs = Date.now() - t0;
192
+ if (res.status !== 200) {
193
+ return shapeProbe({ name: provider.id, kind: "chat", ok: false, status: res.status, latencyMs, error: text.slice(0, 200) });
194
+ }
195
+ let sample = null;
196
+ try {
197
+ const j = JSON.parse(text);
198
+ sample = j?.choices?.[0]?.message?.content ?? null;
199
+ } catch { /* ignore */ }
200
+ return shapeProbe({ name: provider.id, kind: "chat", ok: true, status: res.status, latencyMs, sample });
201
+ } catch (e) {
202
+ return shapeProbe({ name: provider.id, kind: "chat", ok: false, latencyMs: Date.now() - t0, error: String(e && e.message || e) });
203
+ }
204
+ }
205
+
206
+ async function probeEmbed(provider, timeoutMs) {
207
+ if (!provider.supportsEmbed) {
208
+ return shapeProbe({ name: provider.id, kind: "embed", ok: false, error: "provider has no /v1/embeddings endpoint" });
209
+ }
210
+ if (!provider.baseUrl || !provider.embedModel) {
211
+ return shapeProbe({ name: provider.id, kind: "embed", ok: false, error: "missing baseUrl or embedModel" });
212
+ }
213
+ if (provider.endpoint === "cloudflare" || isCloudflareURL(provider.baseUrl)) return probeCloudflare(provider, timeoutMs, "embed");
214
+ const url = `${stripV1(provider.baseUrl)}/v1/embeddings`;
215
+ const body = JSON.stringify({ model: provider.embedModel, input: "ping" });
216
+ const t0 = Date.now();
217
+ try {
218
+ const res = await fetch(url, { method: "POST", headers: buildHeaders(provider), body, signal: AbortSignal.timeout(timeoutMs) });
219
+ const text = await res.text();
220
+ const latencyMs = Date.now() - t0;
221
+ if (res.status !== 200) {
222
+ return shapeProbe({ name: provider.id, kind: "embed", ok: false, status: res.status, latencyMs, error: text.slice(0, 200) });
223
+ }
224
+ let dim = null;
225
+ try {
226
+ const j = JSON.parse(text);
227
+ dim = Array.isArray(j?.data?.[0]?.embedding) ? j.data[0].embedding.length : null;
228
+ } catch { /* ignore */ }
229
+ return shapeProbe({ name: provider.id, kind: "embed", ok: true, status: res.status, latencyMs, dim });
230
+ } catch (e) {
231
+ return shapeProbe({ name: provider.id, kind: "embed", ok: false, latencyMs: Date.now() - t0, error: String(e && e.message || e) });
232
+ }
233
+ }
234
+
235
+ const opts = parseArgs(process.argv.slice(2));
236
+ if (opts.version) { process.stdout.write(`${pkgVersion()}\n`); process.exit(0); }
237
+ if (opts.help) { printHelp(); process.exit(0); }
238
+
239
+ // Merge env: process.env + (optional) env file
240
+ const fileEnv = loadEnvFile(opts.envFile);
241
+ const env = { ...process.env, ...fileEnv };
242
+
243
+ let matrix = buildProviderMatrix(env);
244
+ if (opts.only && opts.only.length) {
245
+ matrix = matrix.filter(p => opts.only.includes(p.id));
246
+ }
247
+ if (matrix.length === 0) {
248
+ const hint = opts.only && opts.only.length ? " (--only filter: " + opts.only.join(",") + ")" : "";
249
+ process.stderr.write("No providers detected. Set MCP_PROVIDER_PRIMARY / GROQ_API_KEY / NINEROUTER_URL etc., or pass --env-file." + hint + "\n");
250
+ process.exit(2);
251
+ }
252
+
253
+ process.stderr.write(`Probing ${matrix.length} provider${matrix.length === 1 ? "" : "s"}...\n`);
254
+ const results = [];
255
+ for (const p of matrix) {
256
+ if (!opts.embedOnly && p.supportsChat) {
257
+ results.push(await probeChat(p, opts.timeoutMs));
258
+ }
259
+ if (!opts.chatOnly && p.supportsEmbed) {
260
+ results.push(await probeEmbed(p, opts.timeoutMs));
261
+ }
262
+ }
263
+
264
+ let out;
265
+ if (opts.markdown) out = formatMarkdown(results);
266
+ else if (opts.json) out = formatJson(results);
267
+ else out = formatText(results);
268
+
269
+ process.stdout.write(out + "\n");
270
+
271
+ if (opts.saveMd) {
272
+ fs.mkdirSync(path.dirname(opts.saveMd), { recursive: true });
273
+ fs.writeFileSync(opts.saveMd, formatMarkdown(results));
274
+ process.stderr.write(`Markdown saved to ${opts.saveMd}\n`);
275
+ }
276
+
277
+ const failed = results.filter((r) => !r.ok).length;
278
+ process.exit(failed === 0 ? 0 : 1);
package/bin/prune.mjs ADDED
@@ -0,0 +1,158 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * bin/prune.mjs — Dev MCP Suite prune CLI.
4
+ *
5
+ * Removes temp project slugs (prefix `tmp.`) from all stores. Default is
6
+ * DRY-RUN — nothing is deleted unless you pass `--yes`.
7
+ *
8
+ * Usage:
9
+ * prune [--root <path>] [--yes] [--json]
10
+ * prune --help | --version
11
+ */
12
+ import fs from "fs";
13
+ import os from "os";
14
+ import path from "path";
15
+ import { fileURLToPath } from "url";
16
+ import { findTempSlugs, planPrune, applyPrune } from "../lib/prune.js";
17
+
18
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
19
+
20
+ function pkgVersion() {
21
+ try {
22
+ return JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")).version || "unknown";
23
+ } catch { return "unknown"; }
24
+ }
25
+
26
+ function resolveRoot() {
27
+ const fromFlag = process.env.PRUNE_ROOT;
28
+ if (fromFlag) return path.resolve(fromFlag);
29
+ for (const k of ["MEMORY_VAULT_DIR", "JOURNAL_DIR", "CHECKPOINT_DIR"]) {
30
+ const v = process.env[k];
31
+ if (v) {
32
+ const sub = k === "MEMORY_VAULT_DIR" ? "vault" : k === "JOURNAL_DIR" ? "journal" : "checkpoints";
33
+ const parent = path.dirname(v);
34
+ if (path.basename(parent) === sub) return parent;
35
+ return parent;
36
+ }
37
+ }
38
+ return path.join(os.homedir(), ".ai-shared-memory");
39
+ }
40
+
41
+ function parseArgs(argv) {
42
+ const opts = { root: null, yes: false, json: false, help: false, version: false };
43
+ for (let i = 0; i < argv.length; i++) {
44
+ const a = argv[i];
45
+ if (a === "-h" || a === "--help") opts.help = true;
46
+ else if (a === "-v" || a === "--version") opts.version = true;
47
+ else if (a === "--yes" || a === "-y") opts.yes = true;
48
+ else if (a === "--json") opts.json = true;
49
+ else if (a === "--dry-run") opts.yes = false;
50
+ else if (a === "--root") opts.root = path.resolve(argv[++i]);
51
+ else if (a.startsWith("--root=")) opts.root = path.resolve(a.slice("--root=".length));
52
+ else if (!a.startsWith("-")) opts.root = path.resolve(a);
53
+ else {
54
+ process.stderr.write(`prune: unknown flag: ${a}\n`);
55
+ process.exit(2);
56
+ }
57
+ }
58
+ return opts;
59
+ }
60
+
61
+ function fmtBytes(n) {
62
+ if (n < 1024) return `${n} B`;
63
+ if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
64
+ return `${(n / 1024 / 1024).toFixed(2)} MB`;
65
+ }
66
+
67
+ function printHelp() {
68
+ const out = [
69
+ `prune (Dev MCP Suite) v${pkgVersion()}`,
70
+ "",
71
+ "Remove temp project slugs (prefix tmp.) from vault, journal, and",
72
+ "checkpoints. Default is DRY-RUN — nothing is deleted without --yes.",
73
+ "",
74
+ "Usage:",
75
+ " prune [root] [--root <path>] [--yes] [--json]",
76
+ " prune --help | --version",
77
+ "",
78
+ "Options:",
79
+ " --yes, -y Actually delete. Without this, only a dry-run report is printed.",
80
+ " --dry-run Force dry-run mode (default).",
81
+ " --json Machine-readable JSON output.",
82
+ " --root <p> Storage root (default: ~/.codex/memories or first env var of",
83
+ " MEMORY_VAULT_DIR / JOURNAL_DIR / CHECKPOINT_DIR)",
84
+ " -h, --help",
85
+ " -v, --version",
86
+ "",
87
+ "Safety: refuses to delete any slug that does not start with `tmp.`.",
88
+ "",
89
+ "Examples:",
90
+ " prune # dry-run report",
91
+ " prune --yes # delete after seeing the plan",
92
+ " prune --yes --json # machine-readable delete report",
93
+ ];
94
+ process.stdout.write(out.join("\n") + "\n");
95
+ }
96
+
97
+ const opts = parseArgs(process.argv.slice(2));
98
+ if (opts.version) { process.stdout.write(`${pkgVersion()}\n`); process.exit(0); }
99
+ if (opts.help) { printHelp(); process.exit(0); }
100
+
101
+ const root = opts.root || resolveRoot();
102
+ const plan = planPrune({ root });
103
+
104
+ if (plan.length === 0) {
105
+ if (opts.json) {
106
+ process.stdout.write(JSON.stringify({ root, plan: [], removed: [], skipped: [], errors: [] }, null, 2) + "\n");
107
+ } else {
108
+ process.stdout.write(`No temp slugs found under ${root}.\n`);
109
+ }
110
+ process.exit(0);
111
+ }
112
+
113
+ if (!opts.yes) {
114
+ // dry-run report
115
+ if (opts.json) {
116
+ process.stdout.write(JSON.stringify({ root, dryRun: true, plan, removed: [], skipped: [], errors: [] }, null, 2) + "\n");
117
+ } else {
118
+ const lines = [];
119
+ lines.push(`Dev MCP Suite — prune (DRY RUN)`);
120
+ lines.push("=================================");
121
+ lines.push(`Storage root: ${root}`);
122
+ lines.push(`Found ${plan.length} temp slug${plan.length === 1 ? "" : "s"}:`);
123
+ let totalBytes = 0;
124
+ for (const e of plan) {
125
+ lines.push(` ${e.slug.padEnd(36)} ${fmtBytes(e.bytes).padStart(10)} stores: ${e.stores.join(",")}`);
126
+ totalBytes += e.bytes;
127
+ }
128
+ lines.push(` ${"TOTAL".padEnd(36)} ${fmtBytes(totalBytes).padStart(10)}`);
129
+ lines.push("");
130
+ lines.push("Re-run with `--yes` to actually delete.");
131
+ process.stdout.write(lines.join("\n") + "\n");
132
+ }
133
+ process.exit(0);
134
+ }
135
+
136
+ // actually delete
137
+ const slugs = plan.map((p) => p.slug);
138
+ const result = applyPrune({ root, slugs, dryRun: false });
139
+ const totalFreed = plan.reduce((a, p) => a + p.bytes, 0);
140
+
141
+ if (opts.json) {
142
+ process.stdout.write(JSON.stringify({ root, dryRun: false, plan, ...result, bytesFreed: totalFreed }, null, 2) + "\n");
143
+ } else {
144
+ const lines = [];
145
+ lines.push(`Dev MCP Suite — prune`);
146
+ lines.push("=====================");
147
+ lines.push(`Storage root: ${root}`);
148
+ lines.push(`Removed ${result.removed.length} slug${result.removed.length === 1 ? "" : "s"} (freed ~${fmtBytes(totalFreed)})`);
149
+ for (const slug of result.removed) lines.push(` ✓ ${slug}`);
150
+ if (result.errors.length) {
151
+ lines.push("");
152
+ lines.push(`Errors (${result.errors.length}):`);
153
+ for (const e of result.errors) lines.push(` ✗ ${e.slug} [${e.store}]: ${e.error}`);
154
+ }
155
+ process.stdout.write(lines.join("\n") + "\n");
156
+ }
157
+
158
+ process.exit(result.errors.length > 0 ? 1 : 0);
package/bin/stats.mjs ADDED
@@ -0,0 +1,101 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * bin/stats.mjs — Dev MCP Suite stats CLI.
4
+ *
5
+ * Usage:
6
+ * stats [--root <path>] [--json] [--top N] [--help] [--version]
7
+ *
8
+ * Default storage root: ~/.codex/memories (override via --root or
9
+ * MEMORY_VAULT_DIR / JOURNAL_DIR / CHECKPOINT_DIR siblings).
10
+ */
11
+ import fs from "fs";
12
+ import os from "os";
13
+ import path from "path";
14
+ import { fileURLToPath } from "url";
15
+ import { computeStats, formatText, formatJson } from "../lib/stats.js";
16
+
17
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
+
19
+ function pkgVersion() {
20
+ try {
21
+ return JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8")).version || "unknown";
22
+ } catch { return "unknown"; }
23
+ }
24
+
25
+ function resolveRoot() {
26
+ // Precedence: explicit --root > vault env > journal env > checkpoint env > ~/.codex/memories
27
+ const fromFlag = process.env.STATS_ROOT;
28
+ if (fromFlag) return path.resolve(fromFlag);
29
+ for (const k of ["MEMORY_VAULT_DIR", "JOURNAL_DIR", "CHECKPOINT_DIR"]) {
30
+ const v = process.env[k];
31
+ if (v) {
32
+ // each server stores under <root>/<subdir>, so the root is the parent
33
+ const sub = k === "MEMORY_VAULT_DIR" ? "vault" : k === "JOURNAL_DIR" ? "journal" : "checkpoints";
34
+ const parent = path.dirname(v);
35
+ if (path.basename(parent) === sub) return parent;
36
+ return parent;
37
+ }
38
+ }
39
+ return path.join(os.homedir(), ".ai-shared-memory");
40
+ }
41
+
42
+ function parseArgs(argv) {
43
+ const opts = { root: null, json: false, top: 10, help: false, version: false };
44
+ for (let i = 0; i < argv.length; i++) {
45
+ const a = argv[i];
46
+ if (a === "-h" || a === "--help") opts.help = true;
47
+ else if (a === "-v" || a === "--version") opts.version = true;
48
+ else if (a === "--json") opts.json = true;
49
+ else if (a === "--root") opts.root = path.resolve(argv[++i]);
50
+ else if (a.startsWith("--root=")) opts.root = path.resolve(a.slice("--root=".length));
51
+ else if (a === "--top") opts.top = parseInt(argv[++i], 10) || 10;
52
+ else if (a.startsWith("--top=")) opts.top = parseInt(a.slice("--top=".length), 10) || 10;
53
+ else if (a === "--") { /* ignore rest */ break; }
54
+ else if (!a.startsWith("-")) opts.root = path.resolve(a);
55
+ else {
56
+ process.stderr.write(`stats: unknown flag: ${a}\n`);
57
+ process.exit(2);
58
+ }
59
+ }
60
+ return opts;
61
+ }
62
+
63
+ function printHelp() {
64
+ const out = [
65
+ `stats (Dev MCP Suite) v${pkgVersion()}`,
66
+ "",
67
+ "Summarize local memory storage (vault / journal / checkpoints).",
68
+ "",
69
+ "Usage:",
70
+ " stats [root] [--root <path>] [--json] [--top N]",
71
+ " stats --help | --version",
72
+ "",
73
+ "Options:",
74
+ " --root <path> Storage root (default: ~/.codex/memories or first env var of",
75
+ " MEMORY_VAULT_DIR / JOURNAL_DIR / CHECKPOINT_DIR)",
76
+ " --json Emit machine-readable JSON instead of human text",
77
+ " --top N How many entries in top-project / recent-activity lists",
78
+ " (default: 10)",
79
+ " -h, --help Show this help",
80
+ " -v, --version Print version",
81
+ "",
82
+ "Examples:",
83
+ " stats # summary of default storage",
84
+ " stats --json | jq .totals # totals only",
85
+ " stats --root /tmp/mem # use a different root",
86
+ ];
87
+ process.stdout.write(out.join("\n") + "\n");
88
+ }
89
+
90
+ const opts = parseArgs(process.argv.slice(2));
91
+ if (opts.version) { process.stdout.write(`${pkgVersion()}\n`); process.exit(0); }
92
+ if (opts.help) { printHelp(); process.exit(0); }
93
+
94
+ const root = opts.root || resolveRoot();
95
+ const stats = computeStats({ root, topLimit: opts.top });
96
+
97
+ if (opts.json) {
98
+ process.stdout.write(formatJson(stats) + "\n");
99
+ } else {
100
+ process.stdout.write(formatText(stats) + "\n");
101
+ }
package/bin/ui.mjs ADDED
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node
2
+ import { startUiServer } from "../lib/ui-server.js";
3
+
4
+ const port = Number(process.env.PORT || 3333);
5
+ startUiServer(port);
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "checkpoint-mcp",
3
+ "version": "1.0.0",
4
+ "description": "Lightweight file snapshot/restore checkpoints for safe experimentation",
5
+ "type": "module",
6
+ "main": "server.js",
7
+ "scripts": {
8
+ "start": "node server.js",
9
+ "test": "node test.mjs"
10
+ },
11
+ "dependencies": {
12
+ "@modelcontextprotocol/sdk": "^1.0.0"
13
+ }
14
+ }